xtomdex/yii2-widget-country

Rendering countries list with Select2 dropdown widget

1.0.2 2019-11-28 03:15 UTC

Requires

• kartik-v/yii2-widget-select2: @dev
• lysenkobv/yii2-geoip: ~1.0
• xtomdex/country-flags: *
• yiisoft/yii2: >=2.0.0

BSD-3-Clause

• Dmitrii Sharonov

• countries
• widget
• select2
• yii2
• kartik

README

This widget extends Kartik's Select2 widget. It uses country codes and names as data and renders list in dropdown.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist xtomdex/yii2-widget-country "*"

or add

"xtomdex/yii2-widget-country": "*"

to the require section of your composer.json file.

Usage

Once the extension is installed, simply use it in your code by :

<?= \xtomdex\widgets\CountrySelect::widget([
    'preferredCountries' => ['UA', 'RU', 'BY'], //these countries will be at the top
    'enableIpCountryFirst' => true, //sets user IP country to the top (preferred countries go next), by default is true
    'displayFlags' => true, //displays country flag images next to their names, by default is true
    /*
     * Select2 config
     */
]); ?>