kunstmaan/languagechooser-bundle

The Kunstmaan Language chooser bundle supplies your project with basic but extendible language chooser

KunstmaanLanguageChooserBundle

, _(*1)

Handles autodetection of the language of the end user or shows a splash page with a language choice., _(*2)

Installation instructions

Assuming you have installed composer.phar or composer binary:, _(*3)

``` bash $ composer require kunstmaan/languagechooser-bundle dev-master, <sub>(*4)</sub>

Add the KunstmaanLanguageChooserBundle and the LuneticsLocaleBundle to your AppKernel.php file:

``` php
new Kunstmaan\LanguageChooserBundle\KunstmaanLanguageChooserBundle(),
new Lunetics\LocaleBundle\LuneticsLocaleBundle(),

Remark: The KunstmaanLanguageChooserBundle should be loaded BEFORE the LuneticsLocaleBundle, <sub>(*5)</sub>

Add the KunstmaanLanguageChooserBundle to your routing.yml:, <sub>(*6)</sub>

``` yaml, <sub>(*7)</sub>

KunstmaanLanguageChooserBundle

_languagechooser: resource: ., <sub>(*8)</sub>

Overwrite the KunstmaanLanguageChooserBundle config to your needs in config.yml:

``` php
kunstmaan_language_chooser:
    autodetectlanguage: false
    showlanguagechooser: true
    languagechoosertemplate: CompanyYourBundle:Default:language-chooser.html.twig
    languagechooserlocales: [en, nl, fr]

Usage

When the user arrives on the root page of your website (eg. http://domain.com/) he: - is automatically redirect to his language of choice (eg. http://domain.com/en) when the autodetectlanguage is set to true - sees a splash page where he can select his language manually when the showlanguagechooser is set to true, <sub>(*9)</sub>

The template path of the splash page can we set via the languagechoosertemplate configuration parameter., <sub>(*10)</sub>

In all your Twig templates, there is a global variable available with an array of the available languages: languagechooser_languages. This can be usefull on your custom splash page, or when you want to show the language choice on other pages., <sub>(*11)</sub>

<ul>
    {% for lang in languagechooser_languages %}
        <li>{{ lang }}</li>
    {% endfor %}
</ul>