Symphony. Типы полей
Типы полей определяют структуру полей и управляют представлением данных.
Обзор
Типы полей определяют структуру и поведение полей в Symphony. Они определяют как поля отображаются в интерфейсе администратора, какие типы данных могут быть введены в поле и как следует форматировать данные при выводе. В базовой версии Symphony имеется восемь типов полей; дополнительные типы полей можно добавить используя расширения.
Использование
Типы полей определяют структуру данных при создании разделов в редакторе разделов.
Детали
В Symphony имеется восемь основных типов полей и девятый тип Select Box Link (в виде расширения), предоставляются по умолчанию.
Автор (Author)
Тип поля «Авторы» генерируется системой и представляется список select. Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Allow multiple (Множественный выбор) | Включает возможность выборки нескольких авторов. |
| Select current (Текущий автор) | Указывать ли текущего автора, как автора используемого по умолчанию. |
Чекбокс (Checkbox)
Типа данного поля представляет собой обычный чексбокс (checkbox). Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Long Description (Полное описание) | Текст, который будет отображаться рядом с чекбоксом. |
| Checked by default (Значение по умолчанию) | Указывает, включен или отключен параметр по умолчанию. |
Дата (Date)
Поле типа «дата» представлена в виде простого поля для ввода текста. Ожидаемый формат указания даты определяется во время установки движка и описывается в файле /manifest.config.php. Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Pre-populate (Начальное заполнение) | Параметр определяет, будет ли при редактировании автоматически устанавливаться текущая дата или нет. |
Загрузка файла (File Upload)
Поле типа «File Upload» служит для загрузки различных файлов. Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Destination Directory (Целевой каталог) | Указывается каталог, в который будет сохранён файл. Каталоги выбираются из списка относительно каталога workspace/. Для указанного каталога должна быть разрешена запись файлов. |
| Validation Rule (Правило проверки) | Регулярное выражение для проверки типа и имени файла. |
Список значений (Select Box)
Тип поля Select Box представлен в виде списка статических, динамических или обоих типов значений. Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Static Options (Статические значения) | Статический список значений разделённый запятыми. |
| Dynamic Options (Динамические значения) | Список полей, которые послужат источниками данных для списка. |
| Allow multiple (Множественный выбор) | Разрешать множественный выбор значений. |
Ссылочный список значений (Select Box Link)
Тип поля Select Box Link представлен в виде списка связанных с разделами записей. Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Options (Опции) | Список полей, сортированых по разделам, которые могут быть использованы в качестве источников для заполнения списка. |
| Limit (Лимит) | Количетсво последних записей, которые будут отображаться в списке. |
| Allow multiple (Множественный выбор) | Разрешать множественный выбор значений. |
Список тегов (Tag List)
Поле типа «список тегов» представляет собой текстовое поле для ввода тегов, разделяемых запятыми.Так же имеется динамически генерируемый список, уже использовавшихся, тегов. Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Suggestion List (Предложенный список) | Список значений, в качестве которого может выступать любое поле системы или раздела. |
| Validation Rule (Правило проверки) | Регулярное выражение для проверки вводимых значений. |
Текстовый блок (Textarea)
Поле типа «текстовый блок» представляет собой большое текстовое поле textarea для форматированно содержимого. Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Rows (Строки) | Число строк текстового блока. |
| Text Formatter (Парсер текста) | Парсер текста применяемый к вводимому содержимому. |
Текстовое поле (Text Input)
Поле типа «текстовое поле» представляет собой однострочное текстовое поле text. Для данного типа имеются следующие настройки:
| Параметр | Описание |
| Validation Rule (Правило проверки) | Регулярное выражение для проверки вводимого текста. |