Расширяемые списки

«Расширяемые списки» — компонент для управления словарями и выбора значений в полях контента InstantCMS 2. Он подходит для каталогов сервисов, товаров и компаний: например, для возможностей продукта, поддерживаемых платформ, направлений деятельности или характеристик.

Редактор выбирает один или несколько готовых пунктов в штатной форме записи. Если нужного значения ещё нет, пользователь с соответствующим разрешением может добавить его прямо из этой формы.

Управление словарями

• Отдельные словари с распределением пунктов по категориям.
• Добавление, редактирование, сортировка и включение или отключение пунктов.
• Массовое добавление: по одному значению в строке.
• Штатные таблицы административной панели и оформление активной темы Modern.
• Счётчик связанных записей у каждого пункта и переход к их списку.

Выбор значений и права

Компонент добавляет обработчик поля с одиночным и множественным выбором. Поле работает в обычных формах добавления и редактирования контента, а его размещение и общие параметры задаются настройками типа контента.

Разрешение на добавление новых пунктов можно задавать на уровне поля. Доступны правила для администраторов, выбранных групп и авторизованных пользователей; добавление из формы можно отключить. Администратор сохраняет возможность управлять словарями в панели управления.

Фильтры и посадочные страницы

Поле поддерживает штатный фильтр списка контента: поиск записей по любому или по всем выбранным значениям. Фильтрацию можно использовать со штатными сохранёнными фильтрами и посадочными страницами InstantCMS.

Миграция существующих полей

В разделе «Миграция поля» выбираются тип контента и одно или несколько его полей списка. Для каждого поля задаются название нового словаря и правила добавления пунктов. Перед запуском компонент показывает таблицу сопоставления значений с количеством связанных записей.

Поддерживаются статические одиночные списки, множественные списки с хранением в YAML и в виде битовой маски, а также совместимый формат прежнего расширяемого поля. Для каждого выбранного поля создаётся отдельный словарь. Одинаковые названия с разными исходными ключами не объединяются.

При переносе сохраняются привязки выбранных значений к записям. Штатные сохранённые фильтры затронутых полей обновляются с сохранением адресов посадочных страниц. После завершения можно переносить другие поля и типы контента.

Журнал и откат

Миграция сохраняет исходные данные и структуру выбранных полей в журнале. Доступен откат отдельной операции. Если после переноса данные изменились, автоматический откат блокируется, чтобы не перезаписать последующие правки. Удаление используемых пунктов и словарей также защищено проверками.

Совместимость и ограничения

Проверено на InstantCMS 2.18.2 и PHP 8.2. Минимальные требования пакета: InstantCMS 2.18.2, PHP 8.2. Синтаксис PHP дополнительно проверен на версии 8.4. Оформление рассчитано на Modern и наследующие его темы.

Для миграции изменяемые таблицы должны использовать InnoDB. Динамические списки из других таблиц, многоязычные словари и отдельные сложные зависимости полей требуют индивидуального переноса. Условия сторонних виджетов и внешние ссылки с прежними числовыми параметрами автоматически не переписываются.

Установка и начало работы

1. Создайте резервную копию сайта и базы данных.
2. Установите архив компонента через штатный установщик InstantCMS.
3. Откройте «Компоненты → Расширяемые списки — Stas-Clear» и создайте словари.
4. Добавьте поле «Расширяемый список (Stas-Clear)» в нужный тип контента, выберите словарь и настройте режим выбора и доступ.
5. Для переноса существующих полей используйте раздел «Миграция поля». Сначала выполните предварительную проверку; на время переноса приостановите редактирование затрагиваемого контента.

Установка и обновление компонента сами по себе не запускают миграцию. Для обновления версии 1.0.0 предусмотрен отдельный пакет. Перед удалением компонента необходимо перенести или удалить использующие его поля.