this bundle provide a global app settings form fully customisable

1.0.0 2018-06-09 11:26 UTC

This package is auto-updated.

Last update: 2022-01-10 16:28:02 UTC


this bundle provide a global app settings form fully customisable.

You can render the settings form in admin page for example. The form building is centralized under the bundle configuration.


  • Settings can be stored via Doctrine ORM.
  • Form building centralized in config files (e.g: config.xml or an imported settings.yml file)
  • A Service for querying stored settings.


if you want to use symfony flex run the following command in your project:

$ composer config extra.symfony.allow-contrib true

Install the bundle via composer by running the command:

$ composer require mukadi/settings-bundle

If you're not using Symfony Flex, you must follow next instructions to configure the bundle yourself.


Enable the bundle in the kernel:

// config/bundles.php
return [
        // ...
       Mukadi\SettingsBundle\MukadiSettingsBundle::class => ['all' => true],

Create the Param class

First, create your Param class by extending the base Param class (the class to use depends of your storage)

// src/Entity/Param.php

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Mukadi\SettingsBundle\Entity\Param as Base;
 * Param
 * @ORM\Table(name="param")
class Param extends Base


Add packages configuration file

Configure the bundle for using this class, and optionnaly specifying the current Object Manager used by the application, if 'manager' key is missing the default Doctrine entity manager will be used:

# config/packages/mukadi_settings.yaml
    manager: app.my_custom_manager
    param_class: App\Entity\Param

Now that the bundle is configured, the last thing you need to do is update your database schema because you have added a new entity. For ORM run the following command.

$ php app/console doctrine:schema:update --force

Build the form

Below is a minimal example of the necessary configuration for build a settings form:

# config/packages/mukadi_settings.yaml
    param_class: App\Entity\Param
        currency: # the setting key
            type: choice # the form field type
            options: # options to provide to the field
                label: Devise
                choices: '(USD: Dollar US,CDF: Francs Congolais)' # use this notation for setting up the choice list
            type: textarea
                label: 'About me'
            type: integer
                label: Age
            type: entity
                label: Article
                choice_label: title
                class: App\Entity\Post
            type: email
                label: Admin email
            type: date
                widget: single_text
                format: yyyy-MM-dd
            type: datetime
                days: '[1-10]' # range notation, generate values from 1 to 10
                months: '[1-12,2]' # range notation, generate values from 1 to 12, the value 2 is incrementation step
                years: '(2016,2017)' # array notation
            type: toggle
                label: 'Show posts ?'
                required: false

The currently supported types are:

  • text : simple text field, save setting as plain text in the database
  • integer : input for integer
  • toggle : a simple checkbox
  • number: input for number (decimals and float)
  • textarea: multi-lines text input
  • entity: for select an entity in the database. The bundle store only the id.
  • email: input for email adresses
  • datetime: input for date and time
  • date: input for date


Now that you have properly create your settings form. You can render it a custom SonataAdminBundle action page, or in any view in your application: In the controller use the mukadi_settings.setting service for getting the form (Or use the Mukadi\SettingsBundle\Model\Setting class if you're using the autowiring)

// src/Controller/AppController.php

$setting = $this->get('mukadi_settings.setting');
$form = $setting->getForm();

And in your view, render the form like any other form:

{# app/Resources/views/default/form.html.twig #}
{{ form_start(form) }}
    {{ form_widget(form) }}
    <button type="submit">save settings</button>
{{ form_end(form) }}

When the form is submitted, in your controller you must handle that request if you want to store the updated settings in your database.

// src/Controller/AppController.php

$setting = $this->get('mukadi_settings.setting');
$form = $setting->getForm();
if($form->isSubmitted() && $form->isValid()){
    $setting->saveData($form); # store the update in the database

And finally you can retrieve the stored data via the mukadi_settings.setting service like this:

// src/Controller/AppController.php
$setting = $this->get('mukadi_settings.setting');
$currency = $setting->get('currency'); // return 'USD' or 'CDF'
$bio = $setting->get('bio'); // return a string
$node = $setting->get('post'); // return null or a App\Entity\Post entity as configured