05.07.2019

Spotlight, как способ показать пользователям новинки на сайте.

В Битрикс стал доступен интерфейса Spotlight в виде пульсирующего круга. При наведении курсора на круг, появляется диалог с подсказкой. Область применения — показать старым или новым пользователям новинки продукта: новые разделы, элементы управления и т.п.

Spotlight можно показать 2 способами:

• Подключить js-расширение spotlight и воспользоваться JavaScript API.
• Подключить на странице компонент bitrix:spotlight с нужными настройками.

Дополнительно существует PHP API, c помощью которого можно узнать доступность подсказки для конкретного пользователя.

Компонент bitrix:spotlight

<?$APPLICATION->includeComponent("bitrix:spotlight", "", array(
    "ID" => "my-spotlight",
    "JS_OPTIONS" => array(
        "targetElement" => "box",
        "content" => "Текст подсказки",
        "targetVertex" => "middle-center"
    )
));
?>

Параметры компонента

• ID - Идентификатор подсказки. Обязательный параметр.
• USER_TYPE Тип пользователя. Допустимые значения:
  • OLD - показ подсказки для старых пользователей.
  • NEW - показ подсказки для новых пользователей.
  • ALL - показ подсказки для любых пользователей.
• USER_TIMESPAN - Промежуток времени в секундах для определения нового/старого пользователя. По умолчанию 30 дней.
• LIFETIME - Время жизни подсказки в секундах. По умолчанию 30 дней.
• START_DATE - Дата, с которой начнется показ подсказки. По умолчанию не задана.
• END_DATE - Дата, до которой можно показывать подсказку. По умолчанию не задана.
• JS_OPTIONS - Массив опций для конструктора [link=]BX.SpotLight[/link].