Описание типов полей
На этой странице приведены описания типов полей, требующих дополнительного пояснения. Остальные типы полей считаются интуитивно понятными и не описаны.
Возраст
Поле предназначено для отображения времени, прошедшего с определённой даты, например, возраста человека или срока владения автомобилем. При редактировании отображается как календарь для выбора даты. При просмотре — как строка, описывающая период времени, например: 5 месяцев 12 дней 6 часов.
Опции
| Название | Описание |
|---|---|
| Заголовок даты отсчёта | Заголовок поля в форме редактирования. Может отличаться от основного заголовка (выводимого при просмотре). Например, для возраста — «Дата рождения», для срока владения — «Дата покупки». |
| Года, Месяцы, Дни, Часы, Минуты | Интервалы времени для отображения в результате. Например, если выбраны «Года» и «Месяцы», вывод будет: 2 года 4 месяца.. |
| Фильтр по диапазону | Интервал времени, используемый для фильтрации. |
| Считать от указанной даты | Дата, от которой ведётся отсчёт. Если не указана, используется текущая дата. |
Предустановленные значения
Не используются.
Дата
Поле предназначено для отображения даты и времени. При редактировании — календарь с выбором даты и, если включена опция «Показывать время», два поля для указания времени с шагом в 5 минут. При просмотре — отформатированная строка даты согласно настройкам сайта. Поддерживаются даты начиная с 2 января 1970 года.
Опции
| Название | Описание |
|---|---|
| Показывать время | Позволяет задавать время с шагом в 5 минут при редактировании и отображать его при просмотре. |
| Фильтр по диапазону | Если включено и фильтр разрешён, записи можно ограничить диапазоном дат — от и до. |
Предустановленные значения
Не используются.
Число
Поле предназначено для отображения чисел в различных форматах.
Опции
| Название | Описание |
|---|---|
| Тип поля ввода | HTML5 тип тега <input>: text или number. |
| Только положительные числа | Разрешает ввод только положительных чисел. |
| Сохранять нулевое значение | Если включено, ноль сохраняется как 0, иначе — как пустое значение. |
| Количество разрядов целой части | Число цифр слева от запятой. |
| Разделитель тысяч | Символ разделения тысяч (например, пробел: 25 000). |
| Только целые числа | Если включено, сохраняются только целые числа. |
| Разделитель дробной части | Символ для дробной части (например, запятая: 3,14159 или точка: 3.14159). |
| Количество разрядов дробной части | Число цифр справа от запятой. |
| Обрезать дробные нули | Если включено, число 7,8745000 отображается как 7,8745. |
| Фильтр по диапазону | Если включено, поле отображается в фильтре как два поля «от» и «до». |
| Выбор диапазона ползунком | Если включено, диапазон задаётся ползунком jQueryUI (при наличии нескольких разных значений). |
| Показывать поля ввода вместе с ползунком | Если включено, отображаются поля ввода вместе с ползунком. |
| Шаг ползунка | Шаг сдвига ползунка, зависит от количества разрядов целой части. |
| Префикс | Слово перед числом (в форме и при выводе). |
| Единица измерения | Краткое обозначение единицы измерения. |
| Отделитель единиц измерения от числа | Символ, разделяющий число и единицу измерения. |
Предустановленные значения
Число в формате настроек сайта.
Строковое поле
Поле предназначено для вывода коротких текстов, таких как заголовки или подписи.
Опции
| Название | Описание |
|---|---|
| Минимальная длина | Минимальное количество символов в тексте. |
| Максимальная длина | Максимальное количество символов в тексте. |
| Показывать количество символов при вводе | Если включено, отображается счётчик введённых символов с возможностью переключения на отсчёт до максимальной длины. |
| Использовать маску для ввода | Если включено, можно задать маску ввода. |
| Маска для ввода | Определяет формат ввода. Например: (999) 999[-99][-99] для номера телефона, 99 99 999999 для водительского удостоверения. Поддерживает условия «или» (например, `aaa |
| Вариант отображения в фильтре | Определяет вид поля в фильтре: строковое поле, выпадающий список или флаг заполненности. |
| Обрезать текст при просмотре списка | Обрезает текст до заданной длины в списках. |
| Автоссылка | Разбивает значение поля (по запятой) на слова и делает их ссылками (при включённом показе в фильтре). |
Предустановленные значения
Любой текст.
Изображение
Поле используется для загрузки и отображения одного изображения. При редактировании — поле выбора файла, при просмотре — изображение.
Опции
| Название | Описание |
|---|---|
| Размер в списке | Размер изображения в списке (должен быть выбран в «Создавать превью»). |
| Размер в записи | Размер изображения в записи (должен быть выбран в «Создавать превью»). |
| Размер в записи при клике | Размер изображения в модальном окне при клике (должен быть выбран в «Создавать превью»). |
| Создавать превью-изображения | Автоматическое сжатие изображения до выбранных размеров. Рекомендуется включать «Маленький» для превью при редактировании. |
| Разрешить добавление по ссылке | Если включено, позволяет загружать изображение по URL. |
Предустановленные значения
Формат:
Размер Путь_к_файлу
micro path/to/file1.jpg
small path/to/file2.jpg
normal path/to/file3.jpg
big path/to/file4.jpg
original path/to/file5.jpg
Путь указывается относительно папки загрузок (например, /var/www/my-site/upload/path/to/file1.jpg).
Набор изображений
Поле используется для загрузки и отображения нескольких изображений. При редактировании — выбор нескольких файлов, при просмотре — миниатюры с лайтбоксом для переключения.
Опции
Аналогичны полю «Изображение», плюс:
| Название | Описание |
|---|---|
| Выделять первое изображение в записи | Если включено, первое изображение отображается крупнее остальных. |
Предустановленные значения
Не используются.
Скрытое поле
Поле для специфичных задач, используется программистами. Не отображается ни при редактировании, ни при просмотре.
Предустановленные значения
Любой текст или числа, неизменяемые пользователем.
Местоположение
Поле для гео-привязки по принципу: Страна → Регион → Город. Содержит только один уровень (страна, регион или город).
Опции
| Название | Описание |
|---|---|
| Тип местоположения | Выбор типа: страна, регион или город. |
| Название для группировки | Объединяет поля в логическую группу (страна-регион-город). Требуются поля «страна» и «регион». |
| Строка вывода значения поля | Форматирование вывода, например, {country}, {city}. Если не указано, выводится значение текущего поля. |
Предустановленные значения
ID выбранного типа местоположения.
Список
Поле для выбора одного варианта из выпадающего списка.
Опции
| Название | Описание |
|---|---|
| Множественный выбор в фильтре | Если включено, поле в фильтре отображается как набор чекбоксов для множественного выбора. |
Предустановленные значения
Формат:
Элемент_1
Элемент_2
...
Элемент_N
Или с указанием ID:
id | элемент
1 | Килограмм
100 | Центнер
1000 | Тонна
В базе хранится порядковый номер элемента (начинается с 1).
Ссылка
Поле для ввода и отображения URL как активной ссылки.
Опции
| Название | Описание |
|---|---|
| Ссылки через редирект | Если включено, ссылки обрабатываются через скрипт редиректа, выглядя как внутренние. |
| Автоматически добавлять http:// | Если включено, предполагаются только внешние ссылки. |
Предустановленные значения
Любой URL.
Текст HTML
Поле для отображения отформатированного текста. При редактировании — WYSIWYG-редактор, при просмотре — гипертекст.
Опции
| Название | Описание |
|---|---|
| Редактор HTML | Выбор WYSIWYG-редактора или пресета. |
| Обрабатывать типографом | Если включено, текст обрабатывается типографом (удаление лишних тегов, замена кавычек и т.д.). Выключение может привести к XSS-уязвимости. |
| Пресет типографа | Выбор пресета типографа. |
| Обрабатывать специальные шаблоны | Использование полей записи в формате {title}, {category} и т.д. |
| Обрезать текст при просмотре списка | Обрезка текста до заданной длины в списках, без HTML-тегов. |
| Участвует в полнотекстовом поиске | Если включено, поле участвует в поиске (может замедлить работу при большом количестве записей). |
Предустановленные значения
Любой HTML-код.
Флаг
Поле представляет собой чекбокс (0 или 1). Используется для фильтрации контента (например, «Выбор редакции»).
Предустановленные значения
0 или 1.