Nette Framework
How to start developing multilanguage website with Nette Framework and Kdyby\Translation
Many people on Nette forum asked how to develop a multilingual website. This was my question as well and I'd like to share my solution with you. Filip Prochazka has developed Kdyby\Translation, an adapter for Symfony\Transaltion for Nette Framework, and has lots of super truper small features which you will love.
Here is a four minute long videocast, an introduction to how easy it is to start using Kdyby\Translation.
Installation
1) Install Nette web-project:
$ composer create-project nette/web-project2) Install Kdyby/Translation:
$ composer require kdyby/translationConfiguration
in
config.neon we will add an extension to enable Kdyby\Translation:1
extensions:
2
translation: Kdyby\Translation\DI\TranslationExtension
Copied!
Presenter
In our BasePresenter we will add the variables
$locale and $tranlator. Using [Dependency Injection | doc:di] mechanism we get an injected Kdyby\Translation\Translator service. (In my example, I don't use any BasePresenter, instead I only use the HomepagePresenter).1
{
2
/** @persistent */
3
public $locale;
4
5
/** @var \Kdyby\Translation\Translator @inject */
6
public $translator;
7
}
Copied!
Router
Update the original router definition in
RouterFactory.php1
$router[] = new Route('[<locale=en cs|en>/]<presenter>/<action>', "Homepage:default");
Copied!
(In the video, locale defaults to cs.)
Dictionaries
We will add the two files
ui.cs_CZ.neon and ui.en_US.neon to the folder app/lang. Here ui is the name of our dictionary and cs_CZ is a combination of language and state. (ISO_639-1 and ISO 3166-1)If we want a specific translation with localization, e.g. French speaking Canadians, we will use
fr_CA.Keeping both the language and the country in the culture is necessary because you may have a different French translation for users from France, Belgium or Canada, and a different Spanish content for users from Spain or Mexico. The language is a code of two lowercase characters, according to the ISO 639-1 standard (for instance, en for English). The country is a code of two uppercase characters, according to the ISO 3166-1 standard (for instance, GB for Great Britain).
Dictionary content
ui.cs_CZ.neon
1
title: Vitejte
Copied!
ui.en_US.neon
1
title: Hello
Copied!
Template
In our template, we will use the macro
{_ ui.title} for putting translated phrase.Profit
It's really easy to start.