Выбор enum

Назначение: список возможных вариантов вида ключ-значение
Тип поля в SQL таблице: int, float, char, varchar

Дополнительные параметры:

values_list
Назначение: список возможных значений в виде массива (обычного или ассоциированного) 
Возможные значения: ['зеленый', 'синий', 'красный'] или ['green' => 'зеленый', 'blue' => 'синий', 'red' => 'красный'] (второй вариант предпочтительнее) 
По умолчанию: []

empty_value
Назначение: возможность выбирать для поля пустое значение 
Возможные значения: true либо текст, который будет показан в качестве заголовка пустого значения 
По умолчанию: true

foreign_key
Назначение: внешний ключ, случай когда значения для данного поля берутся из другой модели, подробнее в разделе Внешние ключи
Возможные значения: название модели: 'News', ‘Products'
По умолчанию: null

is_parent
Назначение: применяется совместно с foreign_key, показывает что данный внешний ключ, записи другой модели являются родителями для записей текущей модели (как например каталоги для товаров). Вторая модель должна иметь поле типа parent. Подробнее описано в разделе Деревья.
Возможные значения: true, false
По умолчанию: false

name_field
Назначение: применяется совместно с foreign_key, при выводе списка возможных значений в связанной модели ищется поле с названием name, если данное поле отсутствует, то необходимо указать поле, которое будет использовано в качестве именного поля
Возможные значения: название поля, например 'first_name', 'label', 'date' 
По умолчанию: 'name'

name_field_extra
Назначение: применяется совместно с foreign_key и name_field, позволяет добавлять к полю name_field из связанной модели значение еще одного поля для более удобного восприятия в списке 
Возможные значения: название поля, например 'last_name', 'age', ‘job’
По умолчанию: пустая строка

display_radio
Назначение: задает отображения значений поля (только во views) в виде radio кнопок (изначально выводится тэг select) 
Возможные значения: целое число, обозначающее количество колонок с радио кнопками
По умолчанию: false

long_list
Назначение: применяется если список значений имеет большую длину, тогда значения получают при помощи строки поиска 
Возможные значения: true, false
По умолчанию: false

show_parent
Назначение: применяется совместно с foreign_key и is_parent, дополнительно показывает название родителя для значений поля 
Возможные значения: true, false
По умолчанию: false

multiple_choice
Назначение: возможность множественного выбора, поле отображается в форме в виде таблицы с чекбоксами, количество колонок таблицы устанавливается при помощи значения данного параметра (применяется только для форм построенных без модели) 
Возможные значения: положительные целочисленные значения, которые обозначают количество колонок в таблице с чекбоксами 
По умолчанию: false

order_asc, order_desc
Назначение: применяется совместно с foreign_key, дает возможность сортировать список значений внешнего ключа по одному из полей модели, по умолчанию при извлечении данных внешнего ключа происходит сортировка по имени (или именному полю name_field). 
Возможные значения: строковые, названия полей модели
По умолчанию: false

Примеры:

['Статус', 'enum', 'status', ['values_list' => ['placed' => 'Размещен', 
                                                'paied' => 'Оплачен',
                                                'delivered' => 'Доставлен']]

['Город', 'enum', 'city', ['foreign_key' => 'Cities',
                           'empty_value' => 'Все города',
                           'long_list' => true]]

['Бренд', 'enum', 'brand', ['empty_value' => true,
                            'foreign_key' =>'Brands',
                            'order_desc' => 'date']]

['Клиент', 'enum', 'client', ['foreign_key' => 'Clients',
                              'name_field' => 'first_name',
                              'name_field_extra' => 'last_name']]

['Раздел каталога', 'enum', 'parent', ['foreign_key' => 'Catalogs',
                                       'is_parent' => true,
                                       'show_parent' => true]]