This is very simple component which adds language switch functionality to your site using cookies mechanism. It's not a widget, it doesn't offers any GUI like lajax/yii2-language-picker. This may be useful because every real web-site has your own design and HTML markup. Some of web-sites uses <select>
, some uses <ul>
dropdown list with onclick
event handler which submits hidden POST form. With this component you're free to use any language selection method. You just need a something able to send POST when needed to switch language and add very simple handler of this POST request.
Installation is very easy and contains following 5 steps.
Execute following command in directory of your Yii2 application:
composer require gugglegum/yii2-cookie-language-selector
(you may need to use composer.phar
instead of composer
). This will install the gugglegum/yii2-cookie-language-selector
component into your application.
Go to your frontend's config and add component config into components
section:
'cookieLanguageSelector' => [
'class' => 'gugglegum\Yii2\Extension\CookieLanguageSelector\Component',
'defaultLanguage' => 'en-US',
'validLanguages' => ['en-US', 'ru-RU', 'de-DE'],
],
The defaultLanguage
is language used by default before language selection. The validLanguages
is the list of languages which can be selected. Additionally you may define name of cookie to store language (cookieName
) and it's expiration period (cookieExpire
). By default cookie name is "lang" and it's expires after 7776000 seconds (90 days).
Your application stores current language in Yii::$app->language
. So you need to add this component to bootstrap
section of your frontend's config to init this component at every application start. You should get something like this:
'bootstrap' => ['log', 'cookieLanguageSelector'],
The initialization of cookieLanguageSelector
will just set Yii::$app->language
to language retrieved from component. Please use long language format like "en-US", not just "en".
You should create HTML form with POST method or ajax with POST to send new language to the server. Your form may contain only language
parameter. Additionally you may add redirectTo
parameter with URL your user should be redirected after switching language (usually the same URL where user was before). The names of these parameters (language
and redirectTo
) is not predefined, it's completely up to you and they are used only in you handler action described in step 5.
Please avoid use GET method of HTTP for switching language. As described in RFC-2616 the GET method should not be used in case different from retrieving information. Your browser may prefetch links on your page and switch language randomly. On the other hand request with GET method can be cached on proxy, so switch may not work. Please always use POST method for action which doing something.
Here is very simple example of language switching form. Add this to some view or layout:
<?= Html::beginForm(['site/switch-language'], 'post') ?>
<?= Html::hiddenInput('redirectTo', \yii\helpers\Url::to(Yii::$app->request->url)) ?>
<?= Html::beginTag('select', ['name' => 'language', 'onchange' => 'this.form.submit();']) ?>
<?= Html::renderSelectOptions(\Yii::$app->language, [
'en-US' => 'English',
'de-DE' => 'Deutsch',
'ru-RU' => 'Russian',
]) ?>
<?= Html::endTag('select') ?>
<?= Html::endForm() ?>
<p>Current language is <?= Html::encode(\Yii::$app->language) ?> </p>
Of course you may use more customized variant. For example, you may use CSS stylized dropdown list which submits hidden POST form.
Add to your SiteController.php
following action-method:
/**
* Switches the language and redirects back
*/
public function actionSwitchLanguage()
{
Yii::$app->cookieLanguageSelector->setLanguage(Yii::$app->request->post('language'));
$this->redirect(Yii::$app->request->post('redirectTo', ['site/index']));
}
That's all! Your comments and suggestions are welcome.
yii2-cookie-language-selector's People
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ๐๐๐
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google โค๏ธ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.