Свои страницы в административной части - списки и формы
Своя страница в административной части нужна там, где данные ведут сотрудники, а инфоблок для этих данных не подходит. Здесь собраны практические решения по таким страницам админки.
Что общего у этих задач
Страница админки - это обычный файл с двумя подключениями. Служебный пролог идёт до всякого вывода, а служебный эпилог сразу после него. Всё между ними рисует платформа своими готовыми средствами, а не вашей вёрсткой.
Список и форма правки собираются готовыми классами платформы. Они дают готовый фильтр, сортировку списка и привычный сотрудникам общий вид. Переписывать всё это своей вёрсткой обычно совершенно невыгодно.
Права на сами данные проверяются вами, а вовсе не платформой. Файл в каталоге административной части доступен любому вошедшему сотруднику, и ограничение по группе пишется в самом начале страницы.
Решения подтемы
- Своя страница в админке: список, форма, пункт меню - файлы страницы, список с фильтром, форма правки и меню модуля.
- Групповые действия и выгрузка в своём списке админки - действия над выбранными строками и выгрузка.
- Форма в админке: вкладки, проверка значений, тулбар - вкладки, сохранение с проверкой, возврат значений, кнопки.
- Свой гаджет рабочего стола: файлы, параметры, вывод - состав файлов, общие и персональные параметры, кэш.
- Правка строк прямо в списке админки: режим, сохранение, файлы - редактируемые колонки, изменённые поля, файлы, ошибки построчно.
- Страница админки не открывается: разбор причин - ошибка до вывода, права модуля, пролог, путь файла.
- Визуальный редактор: панель, сниппеты, чистка вставленного кода - подключение к полю, тип содержимого, сниппеты, чистка разметки.
- Визуальный редактор не работает: разбор причин - редактор не грузится, чистит разметку, теряет вставленное.
- Своя форма элемента инфоблока: файлы, проверка, хук - файлы до и после формы, своя проверка значений, хук после сохранения.
Частые вопросы
Когда нужна своя страница, а когда хватит инфоблока?
Инфоблок даёт список и форму бесплатно. Своя страница нужна для данных вне инфоблоков и для нестандартных действий.
Где хранить файлы своих страниц?
В своём модуле или в каталоге проекта. Файлы рядом со штатными страницами перезапишутся обновлением.
Проверяет ли платформа права на такой странице?
Только вход в административную часть. Права на сами данные проверяет ваш код в начале страницы.
Как добавить пункт в меню?
Файлом меню своего модуля: платформа собирает меню из таких файлов. Правка штатного меню обновление не переживёт.
Связанные темы
- Интерфейс администратора - устройство административной части
- Свой модуль: структура, установка, автозагрузка - где живут свои страницы
- Своя таблица на ORM: сущность, запросы, изменение структуры - данные под такую страницу
- Роли менеджеров: что видит и что может в админке - кому открывать доступ
- Раздел Клиентская часть