oveleon / contao-config-driver-bundle
Config Driver for Contao Open Source CMS
Installs: 2 993
Dependents: 1
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Type:contao-bundle
Requires
- php: ^8.1
- contao/core-bundle: ^4.13 || ^5.3
- contao/image: ^1.0
- symfony/http-kernel: ^5.4 || ^6.4 || ^7.0
Requires (Dev)
- contao/contao-rector: @dev
- contao/easy-coding-standard: ^6.12
- contao/manager-plugin: ^2.3.1
- phpstan/phpstan: ^1.0
- phpstan/phpstan-doctrine: ^1.3
- phpstan/phpstan-phpunit: ^1.0
- phpstan/phpstan-symfony: ^1.0
- shipmonk/composer-dependency-analyser: ^1.5
- slam/phpstan-extensions: ^6.0
- thecodingmachine/phpstan-strict-rules: ^1.0
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
README
This extension adds another driver to the Contao Open Source CMS.
With the Config-Driver it is possible to load fields from a configuration file and output them in the backend. The DCA structure used by Contao is kept. It can be decided whether the data is stored in the localconfig or in an existing database column.
Configuration files located on ROOT
under /templates/
are used. If no template is found, installed bundles are searched afterwards. This gives you the possibility to overwrite configuration files without discarding the default.
Why?
In our case we need a DCA in which we have the possibility to store the fields in another database column to save database queries and performance.
Additionally we want to provide the possibility to deliver a standard configuration which can be extended via the backend. The driver was developed to deliver a basic theme and its SCSS variables from a bundle and let it be consumed or extended by another. For more information you can have a look at our bundle "Contao ThemeManager", in which the driver is used.
Example for saving in localconfig:
For the storage in the localconfig
, only two fields are needed.
Fields
dataContainer
: The driver to be usedconfigFile
: The configuration file to be used (DCA Palette and Fields)
$GLOBALS['TL_DCA']['tl_newdca'] = array ( 'config' => array ( 'dataContainer' => 'Config', 'configFile' => 'dcaConfigFile.html5' // Use the extension html5 to make the configuration extensible in the backend. If the configuration must not be changed, choose the extension PHP. ) );
Example for saving in existing database table/column:
For the storage in an existing database column, all fields of the configuration file are stored serialized.
Fields
dataContainer
: The driver to be usedptable
: The table in which the data is to be storedconfigField
: The table column in which the data is stored serializedconfigFile
: The configuration file to be used (DCA Palette and Fields)multipleConfigFiles
: Merge all configFiles with same name
$GLOBALS['TL_DCA']['tl_newdca'] = array ( 'config' => array ( 'dataContainer' => 'Config', 'ptable' => 'tl_theme', 'configField' => 'configData', 'configFile' => 'dcaConfigFile.html5', 'multipleConfigFiles' => true ) );
Example of a configuration file
return array( 'palettes' => array( // 'default' => '{font_legend},fontsize,fontcolor' // Optional ), // 'fields' => array( 'fontsize' => array ( 'label' => &$GLOBALS['TL_LANG']['tl_newdca']['fontsize'], 'inputType' => 'inputUnit', 'options' => $GLOBALS['TL_CSS_UNITS'], 'eval' => array('includeBlankOption'=>true, 'rgxp'=>'digit_inherit', 'maxlength' => 20, 'tl_class'=>'w50'), ), 'fontcolor' => array ( 'label' => &$GLOBALS['TL_LANG']['tl_newdca']['fontcolor'], 'inputType' => 'text', 'eval' => array('maxlength'=>6, 'colorpicker'=>true, 'isHexColor'=>true, 'decodeEntities'=>true, 'tl_class'=>'w50 wizard'), ) ) );
Further Examples
To continue the example from above and to be able to access the configuration in the backend via e.g. the theme, we can add another icon for each theme.
config/config.php
$GLOBALS['BE_MOD']['design']['themes']['tables'][] = 'tl_newdca';
dca/tl_theme.php
// Add operation $GLOBALS['TL_DCA']['tl_theme']['list']['operations']['newdca'] = array ( 'label' => &$GLOBALS['TL_LANG']['tl_theme']['newdca'], 'href' => 'table=tl_newdca', 'icon' => 'css.svg', ); // Add fields $GLOBALS['TL_DCA']['tl_theme']['fields']['configData'] = array ( 'inputType' => 'text', 'sql' => "text NULL" );
Now we have the possibility to fill in all fields from the configuration for each theme and save each in its new database column.