Документация для разработчиков
Темная тема
Недоступно в редакциях: Малый бизнес, Стандарт, Старт

Баннер


Описание advertising.banner

Компонент выводит баннер заданного типа. Содержит 6 шаблонов: bootstrap, .default, jssor, bootstrap_v4, parallax и nivo. Компонент является стандартным и входит в дистрибутив модуля.

В визуальном редакторе компонент расположен по пути Сервисы > Реклама > Баннер.

Компонент относится к модулю Реклама.

Внимание! Компонент не учитывает таргетинг по ключевым словам, для этого необходимо использовать функцию $APPLICATION->ShowBanner() (более подробную информацию по функции можно посмотреть на странице документации для разработчиков).



Параметры

ПолеПараметрОписаниеПримечание
Основные параметры
Тип баннера TYPE Указывается один из типов баннера, созданных в системе.
Добавлять в ссылки noindex/nofollow NOINDEX [Y|N] При отмеченной опции ссылка перехода по баннеру данного типа заключаются в тэг noindex, а самой ссылке присваивается атрибут nofollow. HTML-тэг noindex используются для исключения из ранжирования в Яндексе и Рамблере заключенного в него текста. Атрибут rel="nofollow" используется для исключения индексации ссылки. Например:
 <noindex><a href="/ссылка_перехода_по_баннеру" 
rel="nofollow"><img src="/upload/banners/10d/banner_100x100.gif" /></a></noindex> 
Количество баннеров для показа QUANTITY Указывается максимальное количество баннеров, которое может показать шаблон компонента.
Шаблон слайдов по умолчанию DEFAULT_TEMPLATE Выбирается шаблон для показа слайдов. Указанный шаблон будет использоваться только для баннеров типа Изображение. Параметр недоступен в шаблоне .default.
Эффект переключения слайдов BS_EFFECT Выбирается эффект переключения слайдов. Параметр недоступен в шаблонах .default и parallax.
Длительность анимации (мсек.) ANIMATION_DURATION Задается время анимации слайда баннера. Параметр доступен только в шаблонах jssor и nivo.
Автоматически подключать библиотеку jQuery JQUERY [Y|N] При отмеченной опции для слайдера требуется подключение javascipt библиотеки jQuery. Параметр доступен только в шаблоне nivo.
Автоматическая смена слайда BS_CYCLING [Y|N] При отмеченной опции смена слайда будет выполняться автоматически. Параметр недоступен в шаблонах .default и parallax.
Скорость смены слайдов (мсек.): BS_INTERVAL Указывается время, через которое будет выполняться смена слайда. Параметры доступны, если отмечена опция Автоматическая смена слайда.
Останавливать при наведении BS_PAUSE [Y|N] При отмеченной опции смена слайдов выполняться не будет, если на баннер будет наведен курсор мыши.
Прокручивать в начало BS_WRAP [Y|N] При отмеченной опции будет выполняться прокрутка к началу показа слайдов. Параметр недоступен в шаблонах .default и parallax.
Навигация с помощью клавиатуры BS_KEYBOARD [Y|N] При отмеченной опции возможно управление показом слайдов с помощью кнопок клавиатуры вперед и назад. Параметр недоступен в шаблонах .default, parallax и nivo.
Показывать элементы навигации на слайде BS_ARROW_NAV [Y|N] При отмеченной опции элементы навигации будут показаны на слайде. Параметр недоступен в шаблонах .default и parallax.
Показывать элемент постраничной навигации BS_BULLET_NAV [Y|N] При отмеченной опции будет отображаться элемент постраничной навигации.Параметр недоступен в шаблонах .default и parallax.
Скрывать область с баннером на планшетах BS_HIDE_FOR_TABLETS [Y|N] При отмеченной опции область с баннером не будет показываться при просмотре сайта на планшетах.Параметр доступен только в шаблонах bootstrap и bootstrap_v4.
Скрывать область с баннером на мобильном телефоне BS_HIDE_FOR_PHONES [Y|N] При отмеченной опции область с баннером не будет показываться при просмотре сайта на мобильном телефоне. Параметр доступен только в шаблонах bootstrap и bootstrap_v4.
Масштабировать относительно ширины родителя SCALE [Y|N] При отмеченной опции будет выполняться масштабирование слайдов. Параметр доступен только в шаблоне jssor.
Высота баннера, px HEIGHT Задается высота баннера (в пикселах). Параметр доступен только в шаблоне parallax.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах. По умолчанию поле содержит 3600 сек.


Пример вызова

<?$APPLICATION->IncludeComponent("bitrix:advertising.banner","",Array(
"TYPE" => "BOTTOM",
"NOINDEX" => "Y",
"QUANTITY" => "1",
"CACHE_TYPE" => "A",
"CACHE_TIME" => "3600"
)
);?>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Николай Ванюшин
Сообщение не промодерировано, возможны ошибки и неточности.
Ставлю галку Добавлять в ссылки noindex/nofollow - проверяю код страницы, все ссылки без nofollow, noindex тоже не проставляется. ( шаблон Стандартный интернет магазин)
0
Игорь Барковский
В последних версиях компонент уже учитывает таргетинг по желательным и обязательным ключевым словам.
Если же вы хотите, чтобы таргетинг по ключевым словам работал для баннеров, размещаемых в хедере шаблона, то можно использовать отложенные функции, вида

php:
Код
function ShowBanner ($arParams) {
   if (CModule::IncludeModule('advertising'))
   {
      $bNoInd = $arParams["NOINDEX"] == "Y";
      return $strBanner = CAdvBanner::Show($arParams["TYPE"], $bNoInd ? '<noindex>':'', $bNoInd ? '</noindex>':'');
   }
}


и размещать баннеры с помощью метода
php:
Код
$APPLICATION->AddBufferContent('ShowBanner', array("TYPE"=>"TOP_BANNER","NOINDEX"=>"Y"));
© «Битрикс», 2001-2022, «1С-Битрикс», 2022
Наверх