README

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

Index

• Installation
• How to use the form theme
• 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):

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 use this form theme in your whole 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.