README

包含国旗的世界各国ISO 3166-1数字代码、ISO 3166-1字母-2代码、ITU-T拨号代码和名称（英语、俄语和乌克兰语）

感谢

https://github.com/victordzmr/Countries https://github.com/lipis/flag-icon-css https://github.com/2amigos/yii2-selectize-widget

安装

通过 composer 安装此扩展是首选方式。

运行

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

或添加

"akavov/yii2-countries": "*"

迁移

您可以使用在console/migartions中存在的迁移

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

或

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

它将创建表：1. country - 包含一些数据（249个国家的英文[name_en]）2. post_country_assn - 依赖于表post和表country

您可以使用这些迁移作为示例，并自行创建所需的表

配置

按照以下方式配置模型

<?php

namespace ict\posts\common\models;

use Yii;
use yii\db\Expression;
use yii\behaviors\TimestampBehavior;
use creocoder\taggable\TaggableBehavior;
use akavov\countries\components\CountriesBehavior;

/**
 * This is the model class for table "{{%post}}".
 * ...
 * @property string $countryValues
 */
class Post extends \yii\db\ActiveRecord
{
    /**
     * @inheritdoc
     */
    public static function tableName()
    {
        return '{{%post}}';
    }

    public function behaviors()
    {
        return [
			...
            [
                'class' => 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']);
    }

}

使用方法

    <?= $form->field($model, 'countryValues')
    ->widget(akavov\countries\widgets\CountriesSelectizeTextInput::className(), [
        'customRender' => [
            'item'  => '<div> <span class="label flag flag-icon-background flag-icon-{item.alpha}">&nbsp;</span>&nbsp;<span class="name">{escape(item.name_en)}</span></div>',
            'option'  => '<div> <span class="label flag flag-icon-background flag-icon-{item.alpha}">&nbsp;</span>&nbsp;<span class="name">{escape(item.name_en)}</span></div>',
        ],
        '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,
        ],
    ]); ?>