geniv/nette-configurator

Configurator component for Nette Framework

Configurator & translator

Installation

$ composer require geniv/nette-configurator

or, _(*1)

"geniv/nette-configurator": "^4.0"

require:, _(*2)

"php": ">=7.0",
"nette/nette": ">=2.4",
"dibi/dibi": ">=3.0",
"geniv/nette-locale": ">=2.0",
"geniv/nette-search-content": ">=1.0",
"geniv/nette-translator": ">=2.0"

Include in application

available source drivers: - DevNullDriver (default values) - DibiDriver (dibi + cache _Configurator-DibiDriver), _(*3)

self translator class: - ConfiguratorTranslator (cache _Configurator-ConfiguratorTranslator), _(*4)

neon configure:, _(*5)

# configurator
configurator:
#   debugger: true
#   autowired: true
#    driver: Configurator\Drivers\DevNullDriver
    driver: Configurator\Drivers\DibiDriver(%tablePrefix%)
    translator: false
#    searchMask: 
#       - *Translation.neon
    searchPath:
        - %appDir%/presenters/AppTranslation.neon
#    excludePath:
#        - CustomExcludeTranslation.neon

neon configure extension:, _(*6)

extensions:
    configurator: Configurator\Bridges\Nette\Extension

description

internal combination id_ident and id_locale must by unique! type content is only like "category" or "flag of type", _(*7)

Internal data are loading in first usage component., _(*8)

Available interface: IConfigurator, _(*9)

usage:, _(*10)

protected function createComponentConfig(IConfigurator $configurator): IConfigurator
{
    // disable auto create ident
    //$configurator->setAutoCreate(false);
    return $configurator;
}

$this['config']->isEnable('ident'): bool;
$this['config']->getValue('ident'): mixed;

// echo value of ident
$this['config']->renderText('ident');
// return value of ident
$this['config']->renderText('ident', true);

// substitute logic
$this['config']->renderText('ident', null, 'arg');
$this['config']->renderText('ident', null, ['arg']);

// set data like translator
$this['config']->setTranslator('ident', 'text');
$this['config']->setEditor('ident', 'new text');

$this['config']->getDataByIdent('ident');

usage:, _(*11)

{control config:text 'web-title'}

{control config:text 'web-title', true}

{control config:text 'web-title', null, 'argument'}
{control config:text 'web-title', null, ['argument']}



{control config:text 'web-title'}





{control config:text 'web-title'}



{* long equivalent - WHY?!: *}


{control config:text 'web-title'}