Конструктор админ-разделов

УСТАНОВКА

1. Сделайте резервную копию сайта и БД. Устанавливайте от имени администратора.
2. Через Marketplace загрузите решение штатными средствами. Для ручной установки
  скопируйте содержимое каталога исходников ozhogov.adminkit в
  <корень сайта>/bitrix/modules/ozhogov.adminkit/ либо распакуйте в <корень сайта>/bitrix/modules/ архив dist/ozhogov.adminkit-1.1.3.zip (сборка: ./build.sh --module adminkit).
  Итоговый путь установщика: /bitrix/modules/ozhogov.adminkit/install/index.php.
  Архив dist/upload/adminkit/last_version.zip предназначен для кабинета партнёра:
  его папку .last_version нельзя просто распаковать в /bitrix/modules/;
  для ручной установки её содержимое нужно поместить в ozhogov.adminkit/.
3. Админка → Marketplace → Установленные решения → «Конструктор админ-разделов» → Установить.
4. При успешной установке создаются пять служебных таблиц с префиксом
  ozhogov_adminkit_: entity, field, right, log, multi; копируются
  страницы в /bitrix/admin/, скрипты в /bitrix/js/ozhogov.adminkit/
  и регистрируется агент очистки журнала с интервалом 86400 секунд.
5. Если база не приняла служебные таблицы, установка прерывается с сообщением
  об ошибке: модуль не регистрируется и файлы не копируются.

Установщик проверяет PHP 8.2+ и главный модуль 20.0.0+. Поддерживаются MySQL
и PostgreSQL: изменение структуры справочников проверено на MySQL 8
и PostgreSQL 16.
Модуль «Highload-блоки» нужен только для соответствующего источника,
«Информационные блоки» — только для поля «элемент инфоблока».

ГДЕ ИСКАТЬ МОДУЛЬ

Конструктор: Настройки → Конструктор админ-разделов → Справочники и поля.
Готовые разделы по умолчанию: Сервисы → Справочники. Раздел меню можно изменить.
Настройки: Настройки → Настройки продукта → Настройки модулей → Конструктор админ-разделов.

ПЕРВЫЙ СПРАВОЧНИК

1. Настройки → Конструктор админ-разделов → Справочники и поля →
  «Добавить справочник».
2. Задайте код (DEALERS), название в единственном и множественном числе,
  источник «Своя таблица», активность и раздел меню. Сохраните справочник.
3. Откройте сохранённый справочник и добавьте поля. Начните с одиночного поля
  NAME типа STRING; отметьте участие в списке, фильтре и форме.
  При сохранении первого поля таблица создаётся автоматически, без отдельного
  подтверждения, — в том числе у справочника из одних множественных полей.
4. Вернитесь в настройки справочника, выберите NAME как поле-заголовок и сохраните.
5. Откройте Сервисы → Справочники → нужный справочник (либо выбранный раздел меню)
  и создайте тестовую запись. Пункт меню может появиться ещё до создания таблицы.
6. Права групп на справочник задаются действием «Права» в списке схем; они
  ограничены правом на сам модуль, которое задаётся на вкладке «Доступ»
  в настройках модуля.

ПОДКЛЮЧЕНИЕ К СУЩЕСТВУЮЩИМ ДАННЫМ

Highload-блок: при создании справочника выберите источник «Highload-блок» и ID блока, сохраните справочник, затем нажмите «Считать поля источника» — список полей заполнится автоматически, останется отметить, какие из них показывать. Вариант доступен администратору сайта. Множественные поля и списки хранятся в самом блоке; значения, записанные версиями до 1.1.3 в таблицу модуля, показываются, пока у записи нет своих, и переезжают в блок при её сохранении.

ORM-класс: выберите источник «ORM-класс» и укажите полное имя класса, например \Vendor\Exchange\LogTable. Модуль проверит, что класс существует, наследует DataManager, и подключит модуль-владелец. Поля считываются той же кнопкой. Такой справочник по умолчанию доступен только для чтения. Вариант доступен администратору сайта: служебные таблицы портала закрыты, а записи классов ядра Битрикса меняются только его собственными средствами.

ПРАВА

Настройки → Конструктор админ-разделов → Справочники и поля → строка справочника → «Права»: для каждой группы пользователей задаётся уровень «нет доступа», «чтение» или «запись». Уровни на отдельные поля задаются в карточке поля. Доступ к самому конструктору есть только у пользователей с уровнем «запись» на модуль.

ИЗМЕНЕНИЕ СТРУКТУРЫ

Добавление, изменение и удаление полей своего справочника меняет таблицу.
Перед применением выводится список операций; те, при которых теряются данные, —
удаление колонки, сужение типа, уменьшение целой или дробной части числа,
перевод множественного поля в одиночное — выполняются только после подтверждения.
При переводе в одиночное поле строк и списков в колонку переносится первое
значение записи. Если база отвергла операцию, в описании остаётся то, что
действительно применилось, а следующее сохранение повторит неудавшееся;
недостающие колонки и индексы досоздаются сверкой с фактической таблицей.
Перед изменением структуры всё же сделайте резервную копию.
Тип существующего поля нельзя сменить на «файл» или «картинку».
В редакторе код существующего поля менять нельзя.
В изменённой JSON-схеме смена кода рассматривается как удаление старого и добавление нового.

ПЕРЕНОС НА ДРУГОЙ САЙТ

Настройки → Конструктор админ-разделов → Перенос схемы: выгрузите нужные справочники в файл JSON и загрузите его на другом сайте. Переносится описание, а не данные; права переносятся по символьным кодам групп. Стратегии загрузки — пропустить существующие или обновить их. Обновление, которое удалило бы данные, импорт не применяет: такой справочник остаётся прежним, а операции перечисляются, чтобы подтвердить их в конструкторе.

РАСШИРЕНИЕ КОДОМ

Обработчик события регистрируется обычным образом, например в /bitrix/php_interface/init.php:

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
   'ozhogov.adminkit',
   'OnAdminkitAfterSave',
   function (\Bitrix\Main\Event $event) {
       if ($event->getParameter('ENTITY') !== 'DEALERS') {
           return;
       }
       $id = $event->getParameter('ID');
       $fields = $event->getParameter('FIELDS');
       // своя логика
   }
);

Возврат из обработчика OnAdminkitBeforeSave результата с типом ошибки отменяет сохранение и показывает сообщение в форме.

ЕСЛИ ЧТО-ТО НЕ ВИДНО

— пункта меню нет: справочник неактивен, либо у вашей группы нет доступа к нему, либо выбран другой раздел меню — проверьте настройки справочника;
— колонки нет в списке: у поля снят флажок «показывать в списке» либо ваш уровень доступа ниже уровня чтения этого поля;
— поля нет в фильтре: снят флажок «показывать в фильтре» либо тип поля не поддерживает фильтрацию;
— справочник открывается только для чтения: источник «ORM-класс» без явно разрешённой записи либо ваш уровень доступа — «чтение»;
— в журнале пусто: у справочника выключено ведение журнала либо записи старше срока хранения уже удалены агентом.

УДАЛЕНИЕ

Админка → Marketplace → Установленные решения → Удалить.
Флажок «Сохранить описания справочников, права и журнал изменений» (savedata)
включён по умолчанию: сохраняются все пять служебных таблиц, включая
множественные значения. Снятие удаляет эти таблицы и настройки модуля.
Флажок «Удалить таблицы справочников вместе со всеми записями» (dropdata)
выключен по умолчанию и показывается, если есть собственные таблицы данных;
перед ним перечислены таблицы и число строк. Источники HL/ORM он не удаляет.
Для последующей установки с сохранением описаний и данных оставьте savedata
включённым, а dropdata выключенным. Сохранение только таблиц справочников
не сохраняет описания и множественные значения при снятом savedata.

Техническая поддержка решения оказывается разработчиком бесплатно в течение срока действия лицензии.

— Электронная почта: nm.ozhogov@ya.ru
— Время ответа: в рабочие дни, в течение 24 часов с момента обращения.
— Часовой пояс: UTC+3 (Москва).

Чтобы вопрос решился с первого письма, приложите: версию решения и главного модуля, редакцию 1С-Битрикс, версии PHP и MySQL, адрес страницы поиска и текст запроса, на котором воспроизводится проблема, а также скриншот страницы «Сервисы → Поиск по каталогу → Индексация».

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