geniv/nette-configurator

Configurator and translator component for Nette Framework

v4.2.8 2019-03-17 17:05 UTC

Requires

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

MIT

• Radek Fryšták

• nette
• translator
• configurator
• geniv

README

Installation

$ composer require geniv/nette-configurator

or

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

require:

"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)

self translator class:

• ConfiguratorTranslator (cache _Configurator-ConfiguratorTranslator)

neon configure:

# 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:

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"

Internal data are loading in first usage component.

Available interface: IConfigurator

usage:

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:

{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']}

<h1 n:if="$presenter['config']->isEnable('web-title')">{control config:text 'web-title'}</h1>

<h1 n:if="$presenter['config']->getValue('show-web-title')">{control config:text 'web-title'}</h1>

{* long equivalent - WHY?!: *}
<h1 n:if="$presenter['config']->renderCheckbox('show-web-title', true)">{control config:text 'web-title'}</h1>