Разработка административного интерфейса в 1С-Битрикс на PHP

Ниже приведены расширенные примеры с детальным пояснением кода и ожидаемым результатом.

Пример 1: Добавление пункта меню с подменю и обработкой прав

// /local/modules/my.tools/install/index.php
<?php
Class my_tools extends CModule {
    var $MODULE_ID = "my.tools";
    var $MODULE_NAME = "Мои инструменты";
    var $MODULE_DESCRIPTION = "Расширение админ-панели";
    function DoInstall() {
        RegisterModule("my.tools");
        RegisterModuleDependences('main', 'OnBuildGlobalMenu', 'my.tools', 'CMyTools', 'AddMenu');
    }
}
?>

// /local/modules/my.tools/include.php
<?php
class CMyTools {
    public static function AddMenu(&$arGlobalMenu, &$arModuleMenu) {
        $arGlobalMenu['my_tools'] = array(
            'menu_id' => 'my_tools',
            'text' => 'Мои инструменты',
            'title' => 'Утилиты',
            'sort' => 50,
            'items_id' => 'my_tools_items',
            'items' => array(
                array(
                    'text' => 'Список задач',
                    'url' => 'my_tools_task_list.php?lang=' . LANGUAGE_ID,
                    'more_url' => array('my_tools_task_edit.php'),
                    'title' => 'Управление задачами',
                    'icon' => 'sys_menu_icon',
                ),
            ),
        );
    }
}
?>

Результат: в левом меню администратора после установки модуля появляется раздел "Мои инструменты" с подпунктом "Список задач". При переходе открывается страница /bitrix/admin/my_tools_task_list.php.

Важно: для корректной работы прав доступа добавьте в файл my_tools_task_list.php проверку:

require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_admin_before.php');
require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/my.tools/include.php');
$APPLICATION->SetTitle('Список задач');
if (!$USER->IsAdmin()) {
    $APPLICATION->AuthForm('Недостаточно прав');
}
require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_admin_after.php');
// остальная логика

Пример 2: Создание AJAX-обработчика для админ-панели

// /bitrix/admin/my_tools_ajax.php
<?php
require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_admin_before.php');
define('STOP_STATISTICS', true);
define('NO_AGENT_CHECK', true);
define('DisableEventsCheck', true);
if (!$USER->IsAdmin()) {
    echo json_encode(['error' => 'Access denied']);
    die();
}
$action = $_REQUEST['action'] ?? '';
if ($action === 'get_data') {
    // имитация получения данных
    $result = ['status' => 'ok', 'data' => ['id' => 123, 'name' => 'Тест']];
    echo json_encode($result);
}
require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/epilog_admin_after.php');
?>

// Пример вызова через JS на странице админ-панели
BX.ajax({
    url: '/bitrix/admin/my_tools_ajax.php',
    method: 'POST',
    data: {action: 'get_data'},
    onsuccess: function(response) {
        console.log(response);
    }
});

Результат: в консоли браузера отображается JSON-объект {"status":"ok","data":{"id":123,"name":"Тест"}}. Важно: в AJAX-ответе не должно быть лишнего вывода, поэтому используются константы STOP_STATISTICS и NO_AGENT_CHECK.

Пример 3: Добавление своей вкладки в настройки модуля (использование CAdminTabControl)

// /bitrix/admin/my_tools_settings.php
<?php
require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_admin_before.php');
require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/classes/general/admin_tabcontrol.php');
$APPLICATION->SetTitle('Настройки инструментов');
require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_admin_after.php');
$tabControl = new CAdminTabControl('tabControl', array(
    array('DIV' => 'tab1', 'TAB' => 'Параметры', 'ICON' => '', 'TITLE' => 'Основные параметры'),
    array('DIV' => 'tab2', 'TAB' => 'Дополнительно', 'ICON' => '', 'TITLE' => 'Дополнительные настройки'),
));
if ($_SERVER['REQUEST_METHOD'] == 'POST' && check_bitrix_sessid()) {
    COption::SetOptionString('my.tools', 'param1', $_POST['param1']);
    COption::SetOptionString('my.tools', 'param2', $_POST['param2']);
    LocalRedirect($APPLICATION->GetCurPage().'?lang='.LANGUAGE_ID.'&tabControl_active_tab='.$_POST['tabControl_active_tab']);
}
$tabControl->Begin();
?>
<form method="post">
<?=bitrix_sessid_post();?>
<?php
$tabControl->BeginNextTab();
?>
<tr>
    <td width="40%">Параметр 1:</td>
    <td width="60%"><input type="text" name="param1" value="<?=htmlspecialcharsbx(COption::GetOptionString('my.tools', 'param1', ''))?>" size="50"></td>
</tr>
<?php
$tabControl->BeginNextTab();
?>
<tr>
    <td>Параметр 2:</td>
    <td><input type="text" name="param2" value="<?=htmlspecialcharsbx(COption::GetOptionString('my.tools', 'param2', ''))?>" size="50"></td>
</tr>
<?php
$tabControl->Buttons();
?>
<input type="submit" name="save" value="Сохранить" class="adm-btn-save">
<?php
$tabControl->End();
?>
</form>
<?php
require_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/epilog_admin.php');
?>

Результат: страница настроек с двумя вкладками, сохраняет параметры в базу через COption. При ошибке сессии появляется сообщение "Срок действия сессии истек".

Эти примеры покрывают наиболее востребованные сценарии кастомизации админ-панели Bitrix.