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

Баннер

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

Описание advertising.banner

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

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

Внимание! Компонент не учитывает таргетинг по ключевым словам, для этого необходимо использовать функцию $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"
)
);?>


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