naucon / form-bundle
Bundle to integrate naucon form package into the Symfony framework.
Installs: 9 358
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 5
Open Issues: 0
Requires
- php: ^8.1
- naucon/form: ^5.0.0
- symfony/config: ^6.0
- symfony/dependency-injection: ^6.0
- symfony/finder: ^6.0
- symfony/http-kernel: ^6.0
Requires (Dev)
- phpunit/phpunit: ^9.0
Suggests
- twig/twig: Is required for using the twig form extension
README
About
Bundle to integrate naucon form package into the Symfony2 framework.
Compatibility
- PHP 7.1 - 7.4
Installation
Step 1: Download the Bundle
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
composer require naucon/form-bundle
This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.
Step 2: Enable the Bundle
Then, enable the bundle by adding it to the list of registered bundles
in the app/AppKernel.php
file of your project:
<?php // app/AppKernel.php public function registerBundles() { $bundles = array( // ... new Naucon\Bundle\FormBundle\NauconFormBundle(), ); }
Configuration
naucon_form: csrf_parameter: "_csrf_token" csrf_protection: true
Get Started
class DefaultController extends Controller { public function newAction(Request $request) { $user = new User(); $formFactory = $this->get('naucon_form.factory'); $form = $formFactory->createForm($user, 'user'); if ($form->isBound() && $form->isValid()) { // some action, like saving the data to database // redirect to success page } return $this->render('default/new.html.twig', array( 'form' => $form )); } }
Twig Form Extension
This bundle defines a service for the naucon form extension for twig which adds new helper functions for building forms. This extension is automatically active when you enable this bundle.
Example
{{ ncform_start(form, method='post', action='some-action', enctype='some type', {furtherOptions:'option'}) }} {{ ncform_field(form, 'text', 'activation_code', { style: 'some style', id: 'some id', value: 'some value', maxlength: 'some lenght', class: 'css class', required: 'required', 'data-attribute': 'some attribute'}) }} {{ ncform_end(form) }}
Further documentation https://github.com/naucon/Form/tree/master#formhelper-with-twig-templates
Roadmap
- add naucon validator to translations