cakephp-plugin cake-language-switcher {🖫 4,809, ⚐ 15, ★ 0}

scherersoftware/cake-language-switcher

LanguageSwitcher plugin for CakePHP

Monday, July 10, 2017
by cleptric
Repository
6 Watchers
0 Stars
4,809 Installations

PHP
1 Dependents
0 Suggesters
4 Forks
0 Open issues
15 Versions
11 % Grown

The README.md

CakePHP 3 Language Switcher Plugin , _(*1)

, _(*2)

Installation

You can install this plugin into your CakePHP application using composer., _(*3)

The recommended way to install composer packages is:, _(*4)

composer require scherersoftware/cake-language-switcher

The next step is to load the plugin inside your bootstrap.php:, _(*5)

bin/cake plugin load LanguageSwitcher

Add the Middleware to your Application.php:, _(*6)

$middleware->push(new \LanguageSwitcher\Middleware\LanguageSwitcherMiddleware());

Optionally, you can pass an array of options to overwrite the default ones:, _(*7)

$middleware->push(new \LanguageSwitcher\Middleware\LanguageSwitcherMiddleware([
    'model' => 'Users',
    'field' => 'language',
    'Cookie' => [
        'name' => 'ChoosenLanguage',
        'expires' => '+1 year',
        'domain' => 'foo.bar',
        'canonicalizeLocale' => false
    ],
    'availableLanguages' => [
        'en_US' => 'en_US'
    ]
]));

Add the Helper to your AppView:, _(*8)

$this->loadHelper('LanguageSwitcher.LanguageSwitcher');

Optionally, you can pass an array of options:, _(*9)

$this->loadHelper('LanguageSwitcher.LanguageSwitcher', [
    'availableLanguages' => [
        'en_US' => 'en_US',
        'de_DE' => 'de_DE'
    ],
    'displayNames' => [
        'en_US' => 'English',
        'de_DE' => 'Deutsch'
    ],
    'imageMapping' => [
        'en_US' => 'United-States',
        'de_DE' => 'Germany'
    ],
    'renderToggleButtonDisplayName' => true,
    'element' => 'LanguageSwitcher.language_switcher'
]);

To use the element:, _(*10)

<?= $this->LanguageSwitcher->renderLanguageSwitcher(); ?>

Next, you should migrate your database., _(*11)

bin/cake migrations migrate -p LanguageSwitcher

Add the css file located under webroot/css to your layout file!, _(*12)

Configuration Usage

Inside your app.php add the following to change configs of the plugin:, _(*13)

'LanguageSwitcher' => [
    'model' => 'Users',
    'field' => 'language',
    'Cookie' => [
        'name' => 'ChoosenLanguage',
        'expires' => '+1 year',
        'canonicalizeLocale' => false
    ],
    'availableLanguages' => [
        'en_US'
    ],
    'displayNames' => [
        'en_US' => 'English'
    ],
    'imageMapping' => [
        'en_US' => 'United-States'
    ],
    'renderToggleButtonDisplayName' => true,
    'beforeSaveCallback' => function ($user, $request, $response) {
        $language = 'en_EN';
        $user->language = $language;
    }
]

model: The model used in the migration
field: The field in the model
Cookie: Optionally you can change the cookie name, the expiration date of the cookie and define if the locale should be saved canonicalized.
availableLanguages: Add language keys
displayNames: Should contain the same keys as availableLanguages. Map language key with its Display Name
imageMapping: Should contain the same keys as availableLanguages. Map language key with its flag image name. (For all possible flag names open webroot/img/flags)
beforeSaveCallback: Optionally you can override the user entity to set e.g. the language field with a special value
renderToggleButtonDisplayName: Optionally you can hide the language name in the dropdown toggle button
element: Optionally you can override the element used for rendering the language switcher with your own.