library translator

drago-ex/translator

Simple translator.

Drago Translator

Simple and lightweight translator for Nette Framework, providing localization support using NEON translation files., _(*1)

, _(*2)

Technology

• PHP 8.3 or higher
• composer

Installation

composer require drago-ex/translator

Extension registration

Register the Drago\Localization\DI\TranslatorExtension in your Nette project by adding the following configuration to your neon file:, _(*3)

extensions:
    - Drago\Localization\DI\TranslatorExtension(translateDir: %appDir%/locale)

Use in the presenter

To use the translator in your presenter, add the TranslatorAdapter trait:, _(*4)

use Drago\Localization\TranslatorAdapter

Accessing the Current Language

You can access the currently set language using the following property:, _(*5)

$this->lang;

Get Translator Instance

To get the translator instance, use the getTranslator method:, _(*6)

$this->getTranslator();

Translation File Format

Translation files should be written in the NEON format. For example:, _(*7)

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

Using Translations in Templates

You can translate strings directly in your Latte templates using the following syntax:, _(*8)

{_"Hello, world!"}

{* Using a filter for translation *}
{$var|translate}

Translating Forms

To use translations in forms, simply set the translator for the form:, _(*9)

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

Route Configuration for Language Switching

Set up your routes to support language prefixes. For example, you can define routes with language codes:, _(*10)

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

Switching Languages in Templates

To switch between languages in your templates, you can use n:href to pass the selected language:, _(*11)

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