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

IncludeString

Описание и параметры

string
CMain::IncludeString(
	string text,
	array icons = array()
)

Выводит произвольную строку (HTML код) обрамленную рамкой, в правом верхнем углу которой выводятся заданные иконки. Нестатический метод.

Параметры

ПараметрОписание
text Произвольный текст (HTML код).
icons Массив иконок, каждый элемент которого представляет из себя массив описывающий одну иконку, его ключами являются:
  • URL - ссылка на иконке
  • SRC - путь к изображению иконки
  • ALT - текст всплывающей подсказки на иконке

Смотрите также

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

<?
$text = "Произвольный HTML";

// если кнопка "Показать включаемые области" нажата, то
if ($APPLICATION->GetShowIncludeAreas())
{
	$arIcons = Array();
	$arIcons[] =
		Array(
			"URL" => "/bitrix/admin/my_script1.php",
			"SRC" => "/images/my_icon1.gif",
			"ALT" => "Текст всплывающей подсказки"
		);
	$arIcons[] =
		Array(
			"URL" => "/bitrix/admin/my_script2.php",
			"SRC" => "/images/my_icon2.gif",
			"ALT" => "Текст всплывающей подсказки"
		);

	// выведется надпись "Произвольный HTML" обрамленная рамкой,
	// в правом верхнем углу которой будут две иконки my_icon1.gif и my_icon2.gif
	// с заданными на них ссылками на скрипты my_script1.php и my_script2.php

	echo $APPLICATION->IncludeString($text, $arIcons);
}
else 
{
	// иначе просто выводим надпись "Произвольный HTML"
	echo $text;
}
?>
<?
// файл /bitrix/modules/advertising/classes/general/advertising.php 
// класс CAdvBanner

// возвращает HTML произвольного баннера по типу
function Show($TYPE_SID, $HTML_BEFORE="", $HTML_AFTER="")
{
	global $APPLICATION, $USER;
	$arBanner = CAdvBanner::GetRandom($TYPE_SID);
	$strReturn = CAdvBanner::GetHTML($arBanner);
	if (strlen($strReturn)>0)
	{
		CAdvBanner::FixShow($arBanner);
		if ($APPLICATION->GetShowIncludeAreas())
		{
			$isDemo = CAdvContract::IsDemo();
			$arrPERM = CAdvContract::GetUserPermissions($arBanner["CONTRACT_ID"]);
			if (($isDemo || (is_array($arrPERM) && count($arrPERM)>0)) && $USER->IsAuthorized())
			{
				$arIcons = Array();
				$arIcons[] =
					Array(
						"URL" => "/bitrix/admin/adv_banner_edit.php?lang=".LANGUAGE_ID."&ID=".$arBanner["ID"]. "&CONTRACT_ID=".$arBanner["CONTRACT_ID"],
						"SRC" => "/bitrix/images/advertising/panel/edit_ad.gif",
						"ALT" => GetMessage("AD_PUBLIC_ICON_EDIT_BANNER")
					);
				$arIcons[] =
					Array(
						"URL" => "/bitrix/admin/adv_banner_list.php?lang=".LANGUAGE_ID."&find_id=".$arBanner["ID"]. "&find_id_exact_match=Y&find_contract_id[]=".$arBanner["CONTRACT_ID"]. "&find_type_sid[]=".$arBanner["TYPE_SID"]."&set_filter=Y",
						"SRC" => "/bitrix/images/advertising/panel/edit_ad_list.gif",
						"ALT" => GetMessage("AD_PUBLIC_ICON_BANNER_LIST")
					);
				$strReturn = $APPLICATION->IncludeString($strReturn, $arIcons);
			}
		}
		$strReturn = $HTML_BEFORE.$strReturn.$HTML_AFTER;
		return $strReturn;
	}
	else return false;
}
?>


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

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

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

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

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