radicaldingos/dsfr-form-theme-bundle

A Symfony 4+ bundle integrating a Twig form theme for "Système de Design de l'État" (DSFR)

1.0.0 2022-11-11 18:52 UTC

Requires

• php: >=7.1.3
• symfony/http-kernel: ^4.0|^5.0
• twig/twig: ^1.0|^2.0|^3.0

MIT

• RadicalDingos

README

A Symfony 4+ bundle integrating a Twig form theme for "Système de Design de l'État" (DSFR).

Index

• Installation
• Sources

Installation

First of all, the DSFR library needs to be installed in your project. Please refer to DSFR and Symfony documentations to install it.

Then, install the bundle with Composer:

composer require radicaldingos/dsfr-form-theme-bundle

And assure it's enabled in your config/bundles.php file (add this line if it's not):

# config/bundles.php
return [
    ...
    RadicalDingos\DsfrFormThemeBundle\RadicalDingosDsfrFormThemeBundle::class => ['all' => true],
];

Another easiest way is just to copy the form theme file Resources\views\Form\dsfr-form-theme.html.twig somewhere in the templates folder of your project. This way is not recommended as you will not be able to update this form theme with Composer.

How to use the form theme

To globally use this form theme in all your project, edit the config/packages/twig.yaml file of your project and add it to the form_themes section :

twig:
    form_themes:
        - '@RadicalDingosDsfrFormTheme/Form/dsfr_form_theme.html.twig'

Have a look at the Symfony documentation. Also example files are provided in this repository.

Sources

Have a look at the following websites and their documentation for more information about this subject.

• The DSFR website;
• The Twig Template engine for PHP website;
• The Symfony PHP framework website.