API для сборки кастомных админок в Битриксе
Документацию по модулю лучше пока смотреть по комментариям в коде модуля. Простой рабочий пример реализован отдельным модулем digitalwand.admin_helper_example
Данный модуль реализует подход MVC для создания административного интерфейса.
Возможность построения административного интерфейса появляется благодаря наличию единого API для CRUD-операциями над сущностями. Поэтому построение админ. интерфейса средствами данного модуля возможно только для классов, реализующих API ORM Битрикс. При желании использовать данный модуль для сущностей, не использующих ORM Битрикс, можно подготовить для таких сущностей класс-обёртку, реализующий необходимые функции.
Основные понятия модуля:
- Мдель: "model" в терминах MVC. Класс, унаследованный от DataManager или реализующий аналогичный API.
- Хэлпер: "view" в терминах MVC. Класс, реализующий отрисовку интерфейса списка или детальной страницы.
- Роутер: "controller" в терминах MVC. Файл, принимающий все запросы к админке данного модуля, создающий нужные хэлперы с нужными настройками. С ним напрямую работать не придётся.
- Виджеты: "delegate" в терминах MVC. Классы, отвечающие за отрисовку элементов управления для отдельных полей сущностей. В списке и на детальной.
Схема работы с модулем следующя:
- Реализация класса AdminListHelper - для управления страницей списка элементов
- Реализация класса AdminEditHelper - для управления страницей просмотра/редактирования элемента
- Создание файла Interface.php с вызовом AdminBaseHelper::setInterfaceSettings(), в которую передается конфигурация полей админки и классы, используемые для её построения.
- Если не хватает возможностей виджетов, идущих с модулем, можно реализовать свой виджет, унаследованный от любого другого готового виджета или от абстрактного класса HelperWidget
Рекомендуемая файловая структура для модулей, использующих данный функционал:
- Каталог admin. Достаточно поместить в него файл menu.php, отдельные файлы для списка и детальной создавать не надо благодаря единому роутингу.
- Каталог classes (или lib): содержит классы модели, представлений и делегатов.
- -- classes/helper: каталог, содержащий классы "view", унаследованные от AdminListHelper и AdminEditHelper.
- -- classes/widget: каталог, содержащий виджеты ("delegate"), если для модуля пришлось создавать свои.
- -- classes/model: каталог с моделями, если пришлось переопределять поведение стандартынх функций getList и т.д.
Использовать данную структуру не обязательно, это лишь рекомендация, основанная на успешном опыте применения модуля в ряде проектов.