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.
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).
The variable $locale is persistent and will now be automatically held in the url.
{
/** @persistent */
public $locale;
/** @var \Kdyby\Translation\Translator @inject */
public $translator;
}
Router
Update the original router definition in RouterFactory.php
(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).
