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

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
	)
)


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
asfdaf
Сообщение не промодерировано, возможны ошибки и неточности.
В подменю кнопки подпись к кнопке TITLE не будет отображаться, если не добавить SHOW_TITLE=true (видимо документация не обновлялась вслед за обновлениями Битрикса)
Вот как должно быть тогда уж
Код
MENU => Array(
[0] => Array(
  [TEXT] => <div style="float: left; margin: 0 50px 0 0;">Наклеить стикер</div>
  [TITLE] => Наклеить новый стикер на страницу
  [SHOW_TITLE] => true
  [ICON] =>
  [ACTION] => if (wind ow .oBXSticker){window .oBXSticker.AddSticker();}
  [DEFAULT] => 1
  [HK_ID] => FMST_PANEL_STICKER_ADD
)
[1] => Array(
  [SEPARATOR] => 1
)
)
1
Евгений Жуков
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх