PHPackages user1007017/yii2-language-picker - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. user1007017/yii2-language-picker ActiveYii2-extension user1007017/yii2-language-picker ================================ Yii2 Language Picker Widget 1.2.0(10y ago)021BSD-3-ClauseCSS Since Mar 1Pushed 9y agoCompare [ Source](https://github.com/user1007017/yii2-language-picker)[ Packagist](https://packagist.org/packages/user1007017/yii2-language-picker)[ RSS](/packages/user1007017-yii2-language-picker/feed)WikiDiscussions master Synced today READMEChangelogDependencies (2)Versions (9)Used By (0) Yii2 Language Picker ==================== [](#yii2-language-picker) Yii2 Language Picker Widget Introduction ------------ [](#introduction) The widget provides an easy to use language selector which makes it possible to change the language of our website easily. The language change can take place synchronously or asynchronously (through Ajax). The default method is asynchronous (through an Ajax call), however when this method fails for any reason (e.g. JavaScript is blocked on the client side) the new language will actualise synchronously through an automatic page reload. The language switcher is fully customisable. However, the pre-defined options provide a dropdown list (DropDownList), and a link-based list (ButtonList). Both versions can display the name of the chosen language and the corresponding flag (icon). Installation ------------ [](#installation) The preferred way to install this extension is through [composer](http://getcomposer.org/download/). Either run ``` php composer.phar require --prefer-dist user1007017/yii2-language-picker "1.*" ``` or add ``` "user1007017/yii2-language-picker": "1.*" ``` to the require section of your `composer.json` file. Config: ------- [](#config) Identifier of the language element. e.g.: en, en-US #### Minimal configuration (icons only) [](#minimal-configuration-icons-only) ``` 'language' => 'en', 'bootstrap' => ['languagepicker'], 'components' => [ 'languagepicker' => [ 'class' => 'user1007017\languagepicker\Component', 'languages' => ['en', 'de', 'fr'] // List of available languages (icons only) ] ], ``` #### Minimal configuration (icons and text) [](#minimal-configuration-icons-and-text) ``` 'language' => 'en', 'bootstrap' => ['languagepicker'], 'components' => [ 'languagepicker' => [ 'class' => 'user1007017\languagepicker\Component', // List of available languages (icons and text) 'languages' => ['en' => 'English', 'de' => 'Deutsch', 'fr' => 'Français'] ] ], ``` #### Full configuration (icons only) [](#full-configuration-icons-only) ``` 'language' => 'en-US', 'bootstrap' => ['languagepicker'], 'components' => [ 'languagepicker' => [ 'class' => 'user1007017\languagepicker\Component', 'languages' => ['en-US', 'de-DE', 'fr-FR'], // List of available languages (icons only) 'cookieName' => 'language', // Name of the cookie. 'cookieDomain' => 'example.com', // Domain of the cookie. 'expireDays' => 64, // The expiration time of the cookie is 64 days. 'callback' => function() { if (!\Yii::$app->user->isGuest) { $user = \Yii::$app->user->identity; $user->language = \Yii::$app->language; $user->save(); } } ] ], ``` ### Yii2-translate-manager integration [](#yii2-translate-manager-integration) #### Minimal configuration (icons only) [](#minimal-configuration-icons-only-1) ``` 'language' => 'en', 'bootstrap' => ['languagepicker'], 'components' => [ 'languagepicker' => [ 'class' => 'user1007017\languagepicker\Component', 'languages' => function () { // List of available languages (icons only) return array_keys(\user1007017\translatemanager\models\Language::getLanguageNames(true)); } ] ], ``` #### Full configuration (icons and text) [](#full-configuration-icons-and-text) ``` 'language' => 'en-US', 'bootstrap' => ['languagepicker'], 'components' => [ 'languagepicker' => [ 'class' => 'user1007017\languagepicker\Component', 'languages' => function () { // List of available languages (icons and text) return \user1007017\translatemanager\models\Language::getLanguageNames(true); }, 'cookieName' => 'language', // Name of the cookie. 'cookieDomain' => 'example.com', // Domain of the cookie. 'expireDays' => 64, // The expiration time of the cookie is 64 days. 'callback' => function() { if (!\Yii::$app->user->isGuest) { $user = \Yii::$app->user->identity; $user->language = \Yii::$app->language; $user->save(); } } ] ], ``` #### IMPORTANT [](#important) To use the widget, the value of the enablePrettyUrl property in the urlManager configuration must be true, and the value of showScriptName false. example: ``` 'components' => [ // ... 'urlManager' => [ 'enablePrettyUrl' => true, 'showScriptName' => false, 'rules' => [ // your rules go here ], // ... ], // ... ] ``` Using of [urlManager](http://www.yiiframework.com/doc-2.0/yii-web-urlmanager.html). Usage ----- [](#usage) Displaying language selector ---------------------------- [](#displaying-language-selector) #### Displaying pre-defined languate picker buttons (icons and text or icons only): [](#displaying-pre-defined-languate-picker-buttons-icons-and-text-or-icons-only) ``` ``` #### Displaying pre-defined languate picker dropdown list (icons and text or icons only): [](#displaying-pre-defined-languate-picker-dropdown-list-icons-and-text-or-icons-only) ``` ``` #### Customising the language picker: [](#customising-the-language-picker) ``` ``` #### Other Example hiding active Language [](#other-example-hiding-active-language) ``` NavBar::begin([ 'brandLabel' => Html::img('@web/css/images/logo.png', ['class' => 'img-responsive','alt' => Yii::$app->name]), 'brandUrl' => Yii::$app->homeUrl, 'options' => [ 'class' => 'navbar navbar-default navbar-fixed-top', ], ]); $aNavOptionsTop = [ 'options' => ['class' => 'navbar-nav navbar-left'], // 'options' => ['class' => 'nav nav-justified '], 'items' => $items ]; echo Nav::widget($aNavOptionsTop); //---------------------------LANGUAGE PICKER --------------------------------------------- echo \user1007017\languagepicker\widgets\LanguagePicker::widget([ 'skin' => \user1007017\languagepicker\widgets\LanguagePicker::SKIN_BUTTON, 'size' => \user1007017\languagepicker\widgets\LanguagePicker::SIZE_SMALL, 'itemTemplate' => ' {name}', //hide active language (display:none): 'activeItemTemplate' => '', // parentTemplate without {size} !!!: 'parentTemplate' => '{items}', ]); //------------------------------------------------------------------------------- NavBar::end(); ``` Screenshots ----------- [](#screenshots) ### Buttons icons and text [](#buttons-icons-and-text) [![language-picker-0 2-screen-1](https://camo.githubusercontent.com/662b8755fb3fd29fad0f04de2b68485979b0ac7c90d390521eb41f0fcdb9e55c/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333539303830302f627574746f6e2d69636f6e732d616e642d746578745f6161386d62702e706e67)](https://camo.githubusercontent.com/662b8755fb3fd29fad0f04de2b68485979b0ac7c90d390521eb41f0fcdb9e55c/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333539303830302f627574746f6e2d69636f6e732d616e642d746578745f6161386d62702e706e67) ### Buttons icons only [](#buttons-icons-only) [![language-picker-0 2-screen-2](https://camo.githubusercontent.com/46e58b13186981624da24a5128fdec673a0f374cae3a17e3e83a3218acb5df67/687474703a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333539303830332f627574746f6e2d69636f6e732d6f6e6c795f6c726c6973312e706e67)](https://camo.githubusercontent.com/46e58b13186981624da24a5128fdec673a0f374cae3a17e3e83a3218acb5df67/687474703a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333539303830332f627574746f6e2d69636f6e732d6f6e6c795f6c726c6973312e706e67) ### Buttons text only [](#buttons-text-only) [![language-picker-0 2-screen-3](https://camo.githubusercontent.com/500b148c7c75512e8aafe45d64d7e457bab7940f8ad84567092968b8155933e2/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333939383936352f627574746f6e2d746578742d6f6e6c795f7a616479766f2e706e67)](https://camo.githubusercontent.com/500b148c7c75512e8aafe45d64d7e457bab7940f8ad84567092968b8155933e2/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333939383936352f627574746f6e2d746578742d6f6e6c795f7a616479766f2e706e67) ### DropDown icons and text [](#dropdown-icons-and-text) [![language-picker-0 2-screen-4](https://camo.githubusercontent.com/67a449c03a1a14b6ef798287e22c349bd2fa4c3f164123786af64513cfaf02c6/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333530383832362f64726f70646f776e2d69636f6e732d616e642d746578745f6c67686538762e706e67)](https://camo.githubusercontent.com/67a449c03a1a14b6ef798287e22c349bd2fa4c3f164123786af64513cfaf02c6/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333530383832362f64726f70646f776e2d69636f6e732d616e642d746578745f6c67686538762e706e67) ### DropDown icons only [](#dropdown-icons-only) [![language-picker-0 2-screen-5](https://camo.githubusercontent.com/89e7535bd0f00e5676294b8692396c6d15e8a62ae9e419283791e0ca6ca3639a/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333530383832362f64726f70646f776e2d69636f6e732d6f6e6c795f767a716b736c2e706e67)](https://camo.githubusercontent.com/89e7535bd0f00e5676294b8692396c6d15e8a62ae9e419283791e0ca6ca3639a/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333530383832362f64726f70646f776e2d69636f6e732d6f6e6c795f767a716b736c2e706e67) ### DropDown text only [](#dropdown-text-only) [![language-picker-0 2-screen-5](https://camo.githubusercontent.com/da85eba2e1f135e88fb1ec79ecbe71ff860060d6f028e43013a54c110602c86f/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333939393438362f64726f70646f776e2d746578742d6f6e6c795f6b70306c79742e706e67)](https://camo.githubusercontent.com/da85eba2e1f135e88fb1ec79ecbe71ff860060d6f028e43013a54c110602c86f/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f75736572313030373031372f696d6167652f75706c6f61642f76313432333939393438362f64726f70646f776e2d746578742d6f6e6c795f6b70306c79742e706e67) Links ----- [](#links) - [GitHub](https://github.com/user1007017/yii2-language-picker) - [Packagist](https://packagist.org/packages/user1007017/yii2-language-picker) - [Yii Extensions](http://www.yiiframework.com/extension/yii2-language-picker) - [Flag Sprites](http://www.flag-sprites.com) ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community9 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 68.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~26 days Recently: every ~37 days Total 8 Last Release 3905d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/2892499?v=4)[user1007017](/maintainers/user1007017)[@user1007017](https://github.com/user1007017) --- Top Contributors [![lajax](https://avatars.githubusercontent.com/u/5390245?v=4)](https://github.com/lajax "lajax (26 commits)")[![alexandernst](https://avatars.githubusercontent.com/u/89727?v=4)](https://github.com/alexandernst "alexandernst (9 commits)")[![user1007017](https://avatars.githubusercontent.com/u/2892499?v=4)](https://github.com/user1007017 "user1007017 (3 commits)") --- Tags translateyii2extensionmultilanguagewidgetsamplelanguagepicker ### Embed Badge ![Health badge](/badges/user1007017-yii2-language-picker/health.svg) ``` [![Health](https://phpackages.com/badges/user1007017-yii2-language-picker/health.svg)](https://phpackages.com/packages/user1007017-yii2-language-picker) ``` ### Alternatives [lajax/yii2-language-picker Yii2 Language Picker Widget 41230.8k3](/packages/lajax-yii2-language-picker)[richardfan1126/yii2-js-register Yii2 widget to register JS into view 1357.2k7](/packages/richardfan1126-yii2-js-register) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)