README

Lightweight translator for Nette Framework using NEON files, supporting global and module-specific translations.

Requirements

composer require drago-ex/translator

extensions:
	translator: Drago\Localization\DI\TranslatorExtension(%appDir%, %tempDir%)

translator:
	autoFinder: false
	translateDirs:
		- %appDir%/First/Translate
		- %appDir%/Second/Translate

All directories listed in translateDirs are loaded in order.
Later directories override translations from earlier ones.
If autoFinder is enabled, the entire application directory is scanned for NEON files.

Translation files must be named by language code:

cs.neon
en.neon

"Hello, world!": "Hello, world!"

Add the TranslatorAdapter trait to your presenter:

use Drago\Localization\TranslatorAdapter;

The trait provides:

You can access the currently set language using the following property:

$this->lang;

To get the initialized translator for the current language:

$this->getTranslator()

The translator is automatically registered in templates. Example usage in Latte:

{_"Hello, world!"}
{$label|translate}

To enable translations in forms, set the translator explicitly:

$form->setTranslator($this->getTranslator());

To support language prefixes, configure your routes accordingly:

$router->addRoute('[<lang=en cs|en>/]<presenter>/<action>', 'Presenter:action');

You can switch languages by passing the lang parameter:

<a n:href="this, lang => cs">Czech</a>
<a n:href="this, lang => en">English</a>