Документация для разработчиков

AddPanelButton

CMain::AddPanelButton(
 array button,
 array MenuItem
)

Добавляет в панель управления кнопку. Нестатический метод.

Параметры

ПараметрОписание С версии
button Массив описывающий добавляемую кнопку. Ключи массива:
  • HREF - ссылка на кнопке
  • SRC - путь от корня сайта к картинке которая будет выведена на кнопке
  • ALT - текст всплывающей подсказки на кнопке
  • MAIN_SORT - индекс сортировки для группы кнопок, для стандартных групп иконок данный параметр имеет следующие значения:
    • 100 - группа иконок модуля управления статикой
    • 200 - группа иконок модуля документооборота
    • 300 - группа иконок модуля информационных блоков
  • SORT - индекс сортировки внутри группы кнопок
  • TYPE - (BIG/SMALL) размер иконки. (По умолчанию "SMALL".)
  • HINT - Массив с ключами:
    • TITLE - Заголовок всплывающей подсказки;
    • TEXT - Текст всплывающей подсказки.
  • ICON - CSS иконки.
  • TEXT - Текст кнопки.
Если у пользователя не хватает прав на ту или иную операцию и вы хотите в любом случае вывести кнопку, то необходимо HREF оставлять пустым, при этом кнопка будет выведена черно-белой и без ссылки.
MenuItemМассив меню7.0.0

См. также

Примеры использования

<?
// получим уровень доступа к модулю "Веб-формы"
$FORM_RIGHT = $APPLICATION->GetUserRight("form");
// если доступ есть то
if($FORM_RIGHT>"D"):
    // добавим в панель кнопку ведущую на список веб-форм
    $APPLICATION->AddPanelButton(array(
        "HREF"      => "/bitrix/admin/form_list.php", 
        "SRC"       => "/bitrix/images/fileman/panel/web_form.gif", 
        "ALT"       => "Редактировать веб-форму", 
        "MAIN_SORT" => 400, 
        "SORT"      => 100
    ));
endif;
?>

Подменю кнопки (на примере кнопки стикеров):

MENU => Array(
 [0] => Array(
  [TEXT] => <div style="float: left; margin: 0 50px 0 0;">Наклеить стикер</div>
  [TITLE] => Наклеить новый стикер на страницу
  [ICON] =>
  [ACTION] => if (wind ow .oBXSticker){window .oBXSticker.AddSticker();}
  [DEFAULT] => 1
  [HK_ID] => FMST_PANEL_STICKER_ADD
 )
 [1] => Array(
  [SEPARATOR] => 1
 )
)


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
1
Евгений Жуков
© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх