akavov/yii2-countries

ISO 3166-1 numeric code, ISO 3166-1 alpha-2 code, ITU-T calling code and name (English, Russian and Ukrainian) for all the countries in the world with their flags

Widget Countries in the world with flags

ISO 3166-1 numeric code, ISO 3166-1 alpha-2 code, ITU-T calling code and name (English, Russian and Ukrainian) for all the countries in the world with their flags, _(*1)

Thanks to:, _(*2)

https://github.com/victordzmr/Countries https://github.com/lipis/flag-icon-css https://github.com/2amigos/yii2-selectize-widget, _(*3)

Installation

The preferred way to install this extension is through composer., _(*4)

Either run, _(*5)

php composer.phar require --prefer-dist akavov/yii2-countries "*"

or add, _(*6)

"akavov/yii2-countries": "*"

Migration

you can use migrations that already exist in console/migartions, _(*7)

$ yii migrate --migrationPath='@akavov/countries/console/migrations'

or, _(*8)

$ yii migrate --migrationPath=@vendor/akavov/yii2-countries/console/migrations

it will create tables: 1. country - with some data (249 countries in english[name_en]) in it 2. post_country_assn - depends from table post and table country, _(*9)

You can use this migartions like an example and create needed tables yourself, _(*10)

Configuring

Configure model as follows, _(*11)

 CountriesBehavior::className(),
            ],
            ...
        ];
    }

    /**
     * @inheritdoc
     */
    public function rules()
    {
        return [
            ...
            ['countryValues', 'safe'],
            ...
        ];
    }

    public function transactions()
    {
        return [
            self::SCENARIO_DEFAULT => self::OP_ALL,
        ];
    }

    public function getCountries()
    {
        return $this->hasMany(Country::className(), ['id' => 'country_id'])
            ->viaTable('{{%post_country_assn}}', ['post_id' => 'id']);
    }

}

```

Usage
-----

```
    = $form->field($model, 'countryValues')
    ->widget(akavov\countries\widgets\CountriesSelectizeTextInput::className(), [
        'customRender' => [
            'item'  => '
   {escape(item.name_en)}
',
            'option'  => '
   {escape(item.name_en)}
',
        ],
        'clientOptions' => [
            'valueField' => 'name_en',
            'labelField' => 'name_en',
            'searchField' => ['name_en', 'name_uk', 'name_ru'],
            'plugins' => ['remove_button'],
            'closeAfterSelect' => true,
            'maxItems' => 10,
            'delimiter' => ',',
            'persist' => false,
            'preload' => true,
            'items' => $model->countryValues,
            'create' => false,
        ],
    ]); ?>