Ми часто стикаємося з задачею, коли стандартний адміністративний розділ 1С-Бітрікс не покриває специфіку бізнес-процесів. Ручна синхронізація залишків із зовнішньої системи, масове оновлення цін за формулою, управління налаштуваннями інтеграцій — для таких сценаріїв необхідні власні адміністративні сторінки. Розробляти їх напряму в /bitrix/admin/ не можна — оновлення платформи зітруть зміни. Правильний шлях — /local/. За багато років ми розробили понад 50 кастомних адміністративних інтерфейсів для Бітрікс, від простих форм до багатосторінкових дашбордів з аналітикою. У цій статті розберемо технічні деталі створення таких сторінок. Кастомні адміністративні сторінки дозволяють реалізувати будь-який функціонал, недоступний у типовій поставці.
| Підхід | Переваги | Недоліки | Коли використовувати |
|---|---|---|---|
/local/admin/ |
Простота, швидкий старт | Обмежений інтерфейс | Прості сторінки з однією таблицею |
/local/components/ |
Гнучкість, перевикористання, кешування | Складніше, потребує знання компонентної моделі | Складні інтерфейси з AJAX, правами доступу |
Як розміщувати та структурувати кастомні адміністративні сторінки?
Розміщення в /local/admin/ — розробка кастомних адміністративних
Файли кастомних сторінок розміщуються в /local/admin/. Бітрікс автоматично включає цей шлях у пошук адміністративних сторінок. Сторінка стає доступною за адресою /bitrix/admin/my_page.php якщо файл лежить в /local/admin/my_page.php. Альтернатива — створити сторінку як компонент в /local/components/ і підключити її через обгортку. Це прийнятний підхід для складних інтерфейсів.
Структура мінімальної адміністративної сторінки
<?php // /local/admin/my_custom_page.php require_once($_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_admin_before.php'); // Перевірка прав $APPLICATION->SetTitle('Моя сторінка'); if (!$USER->IsAdmin() && !$USER->CanDoOperation('edit_php')) { $APPLICATION->AuthForm('Немає доступу'); } require_once($_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_admin_after.php'); // Контент сторінки ?> <div class="adm-content-wrap"> <!-- HTML інтерфейсу --> </div> <?php require_once($_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/epilog_admin.php'); Три обов'язкових інклуди формують правильну обгортку: шапку, навігацію, підвал адміністративного розділу. Без них сторінка відкриється без оформлення.
Використання адміністративних хелперів Бітрікс
Бітрікс надає набір класів для побудови стандартних адміністративних UI-елементів. Використання цих класів дає нативний вигляд і позбавляє від верстки. Розглянемо CAdminList і CAdminForm.
use Bitrix\Main\UI\Filter\Options as FilterOptions; // CAdminList — таблиця з сортуванням, пагінацією і фільтром $oList = new CAdminList('my_list_id'); $lAdmin->AddHeaders([ ['id' => 'ID', 'content' => 'ID', 'sort' => 'ID'], ['id' => 'NAME', 'content' => 'Назва', 'sort' => 'NAME'], ['id' => 'DATE', 'content' => 'Дата'], ]); while ($row = $rsData->Fetch()) { $oRow = &$oList->AddRow('ID_' . $row['ID'], $row); $oRow->AddActions([ ['TEXT' => 'Змінити', 'ONCLICK' => "jsUtils.Redirect([], 'my_edit.php?ID=" . $row['ID'] . "')], ['TEXT' => 'Видалити', 'ACTION' => $oList->ActionDoGroup($row['ID'], 'delete')], ]); } $oList->DisplayList(); // CAdminForm — форма редагування з вкладками $oTabControl = new CAdminTabControl('tabControl', [ ['DIV' => 'tab1', 'TAB' => 'Основне', 'ICON' => 'main_user_edit'], ['DIV' => 'tab2', 'TAB' => 'Додатково'], ]); $oTabControl->Begin(); $oTabControl->BeginNextTab(); // поля першої вкладки $oTabControl->BeginNextTab(); // поля другої вкладки $oTabControl->Buttons(['btnSave' => true, 'btnApply' => true, 'btnCancel' => true]); $oTabControl->End(); Як додати сторінку в меню та налаштувати права?
Додавання в меню
Сторінка повинна бути доступна з меню, а не тільки за прямим URL. Реєстрація через обробник події в /local/php_interface/init.php:
AddEventHandler('main', 'OnBuildGlobalMenu', function(&$globalMenu, &$moduleMenu) { $moduleMenu[] = [ 'parent_menu' => 'global_menu_services', 'sort' => 500, 'text' => 'Синхронізація', 'title' => 'Управління синхронізацією із зовнішньою системою', 'url' => 'my_custom_page.php', 'icon' => 'main_menu_tasks', 'page_icon' => 'main_page_icon', 'more_url' => ['my_custom_page.php', 'my_custom_edit.php'], ]; }); Параметр more_url потрібен, щоб пункт меню залишався активним при переході на пов'язані сторінки.
Права доступу
Кастомна сторінка повинна перевіряти права самостійно. Варіанти:
- Перевірка
$USER->IsAdmin()— тільки для сторінок, доступних виключно адміністраторам - Перевірка
$USER->CanDoOperation('назва_операції')— для гранулярного контролю - Перевірка права на модуль:
CModule::IncludeModule('main') && $USER->GetRights('mymodule') >= 'W'
Згідно з офіційною документацією 1С-Бітрікс, якщо сторінка повинна бути доступна певній групі — краще створити власний модуль з реєстрацією прав через RegisterModuleDependences.
Робота з даними: D7 ORM vs старе API
Для кастомних сторінок рекомендується використовувати D7 ORM (\Bitrix\Main\ORM). Якщо дані зберігаються у власних таблицях — створюється клас сутності:
namespace Local\MyModule; use Bitrix\Main\ORM\Data\DataManager; use Bitrix\Main\ORM\Fields; class MyEntityTable extends DataManager { public static function getTableName(): string { return 'my_custom_table'; } public static function getMap(): array { return [ new Fields\IntegerField('ID', ['primary' => true, 'autocomplete' => true]), new Fields\StringField('NAME', ['required' => true]), new Fields\DatetimeField('CREATED_AT'), ]; } } Після цього MyEntityTable::getList(), ::add(), ::update(), ::delete() працюють через стандартний ORM.
Як обробляти форми та AJAX?
Адміністративні сторінки Бітрікс традиційно використовують POST-форми з токеном CSRF (bitrix_sessid_post()). Для AJAX-запитів:
// Перевірка сесійного токена if (!check_bitrix_sessid()) { die(json_encode(['error' => 'Invalid session'])); } // В JS (при використанні BX.ajax) BX.ajax.runAction('local:my.action', { data: { param: value }, sessid: BX.bitrix_sessid() }); Для сучасних AJAX-інтерфейсів можна використовувати \Bitrix\Main\Engine\Controller з роутингом через /.action.php — це D7-підхід, рекомендований для нових розробок.
Строки та обсяг робіт
| Тип задачі | Строки |
|---|---|
| Проста CRUD-сторінка | 1–2 дні |
| Багатосторінковий розділ з фільтрами та AJAX | 3–5 днів |
| Повноцінний модуль з правами та подіями | 1–2 тижні |
У роботу входить:
- Аудит поточної архітектури та узгодження ТЗ
- Розробка прототипу інтерфейсу в
/local/admin/або/local/components/ - Реалізація логіки на D7 ORM
- Інтеграція в меню та налаштування прав доступу
- Тестування на стенді та доопрацювання
- Передача вихідного коду та документації
- Гарантійна підтримка 30 днів
Покрокова інструкція створення кастомної сторінки
- Визначте вимоги: які дані, який інтерфейс, чи потрібні права.
- Створіть файл в
/local/admin/або зареєструйте компонент. - Підключіть прологи та епілоги для коректної обгортки.
- Реалізуйте логіку з використанням CAdminList/CAdminForm або D7 ORM.
- Додайте пункт меню через OnBuildGlobalMenu.
- Налаштуйте перевірку прав доступу.
- Протестуйте на стенді та передайте замовнику.
Типові задачі для кастомних сторінок
- Панель управління синхронізацією з 1С або зовнішніми API (ручний запуск, лог останніх операцій)
- Масове редагування товарів за нестандартними критеріями
- Дашборд з аналітикою на основі даних з декількох модулів
- Управління налаштуваннями інтеграцій (ключі API, вебхуки, маппінг полів)
- Інструменти міграції контенту між середовищами
Чому варто обрати нас?
Наша команда має багаторічний досвід розробки на Бітрікс і виконала понад 50 проектів з кастомізації адміністративної панелі. Ми гарантуємо сумісність з останніми версіями платформи, надаємо повну документацію та здійснюємо підтримку після здачі. Зв'яжіться з нами для консультації або замовте розробку під ключ — оцінимо ваш проект протягом 1 дня. Економія часу на ручній обробці даних та прозора вартість проекту — ось що ви отримуєте.