naucon/form-bundle

Bundle to integrate naucon form package into the Symfony framework.

5.0.0 2024-07-16 09:54 UTC

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

MIT

• Sven Sanzenbacher

• symfony
• form
• smarty
• bundle
• validation
• Forms
• csrf
• collection
• xsrf
• Cross-Site-Request-Forgery
• formbundle

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