README

Shared Nette form factory used by DravenCMS administration components. It creates the package-specific Form class and applies the translator and common rendering setup in one place.

Installation

composer require dravencms/base-form

The bundled configuration registers Dravencms\BaseForm\DI\BaseFormExtension. DravenCMS applications normally load it through the package metadata.

Usage

Inject BaseFormFactory into a control and create the form inside the component factory method:

use Dravencms\Components\BaseForm\BaseFormFactory;
use Dravencms\Components\BaseForm\Form;

final class ArticleForm
{
    public function __construct(
        private BaseFormFactory $baseFormFactory,
    ) {
    }

    protected function createComponentForm(): Form
    {
        $form = $this->baseFormFactory->create();
        $form->addText('title')->setRequired();
        $form->addSubmit('send');
        return $form;
    }
}

Set edit defaults on the local $form after its controls have been created. Do not access $this['form'] from a component constructor, because the Nette component tree is not ready there.

License

This package is licensed under the LGPL-3.0 license.

Sessions for lazily rendered protected forms

Base Form 0.4 registers an application onResponse callback. Before an HTML template response is sent, it starts the Nette session, allowing forms instantiated during template rendering to initialize CSRF protection before headers are sent. Presenters need no session-start workaround. This prepares sessions for HTML templates generally, because their lazy form components are not known before rendering.

File delivery, JSON, redirects, plain-text responses and templates explicitly served with a non-HTML content type are not affected. Keep global session autostart disabled when serving cacheable public files. This changes no form validation or CSRF rules.