masev/settings-bundle

Masev SettingsBundle introduce a settings system into eZ Publish 5.x, administration is possible thanks to an interface in legacy admin.

MasevSettingsBundle

Masev SettingsBundle introduce a settings system into eZ Publish 5.x, administration is possible thanks to an interface in legacy admin (AngularJS powered). All settings are injected in Symfony container as a parameter. There are compatible with the eZ Publish Config Resolver allowing you the define settings per siteaccess., _(*1)

, _(*2)

Install

Step 1: Download MasevSettingsBundle using composer

Add MasevSettingsBundle in your composer.json:, _(*3)

{
    "require": {
        "masev/settings-bundle": "dev-master"
    }
}

Now tell composer to download the bundle by running the command:, _(*4)

``` bash $ php composer.phar update masev/settings-bundle, <sub>(*5)</sub>

Composer will install the bundle to your project's `vendor/masev/settings-bundle` directory.

### Step 2: Enable the bundle

Enable the bundle in the kernel:

``` php
/Resources/config/.

```xml

<settings xmlns="http://william-pottier.fr/schema/settings"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://william-pottier.fr/schema/settings https://raw.github.com/wpottier/WizadSettingsBundle/master/Resources/schema/settings-1.0.xsd">

    <parameter key="category.sub_category.sender_name">
        <name>Email sender name</name>
        <default>Me</default>
    </parameter>

    <parameter key="category.sub_category.sender_email">
        <name>Email sender address</name>
        <default>me@my-site.com</default>
    </parameter>

    <parameter key="category.sub_category.message">
        <name>Message</name>
        <default></default>
        <form type="textarea" cols="30" rows="10"></form>
    </parameter>

</settings>

Settings key must have a category and sub_category name to be displayed correctly in the legacy UI., <sub>(*6)</sub>

Clear the Symfony cache :, <sub>(*7)</sub>

php ezpublish/console cache:clear

At this step you should be able the define settings in the legacy UI (configuration tab in the eZ Publish Legacy Administration)., <sub>(*8)</sub>

Step 5 : Query your settings

Now that you have define settings you can query them with the eZ Publish config resolver., <sub>(*9)</sub>

// Get the 'category.sub_category.sender_name' settings in the current scope (i.e. current siteaccess)
$this->configResolver->getParameter('category.sub_category.sender_name', 'masev_settings');

// You can force siteaccess
$this->configResolver->getParameter('category.sub_category.sender_name', 'masev_settings', 'my_site_access');

In a twig template you can use the getMasevSettings() Twig function., <sub>(*10)</sub>