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

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


© «Битрикс», 2001-2024, «1С-Битрикс», 2024