Уведомление об использовании cookies (баннер куки РФ 152 ФЗ) + Генератор политики и согласия

УСТАНОВКА

1. Установите модуль на странице решения в маркетплейс Битрикс
2. В административной панели перейдите:
  Marketplace -> Установленные решения
3. Найдите "Cookie Consent" и нажмите "Установить".

После установки баннер автоматически добавляется на все страницы
публичного раздела (перед закрывающим тегом </body>) - вставлять
компонент в шаблон не требуется. В административном разделе баннер
не выводится.

ДОСТУП К НАСТРОЙКАМ

Настройки открываются по пути:

 - Настройки -> Настройки продукта -> Настройки модулей
   -> Cookie Consent.

В разделе "Сервисы -> Cookie Consent" также доступен пункт
"Генератор политики" - мастер создания текста политики
конфиденциальности с сохранением в файл или импортом в соглашения
Битрикс (доступен только администраторам).

Страница настроек разбита на три вкладки. Ниже каждая опция описана
с учётом того, как она реально влияет на баннер.

ВКЛАДКА "ОСНОВНЫЕ НАСТРОЙКИ"

Интеграция с соглашениями Битрикс

 - Если выбрано соглашение, каждое действие пользователя
   (принятие, отказ, сохранение выбранных категорий) фиксируется
   в стандартном механизме согласий Битрикс: в согласие
   записываются значения "Analytics: Y/N" и "Marketing: Y/N",
   домен сайта и дата. Список полученных согласий смотрите в
   Настройки -> Соглашения -> [соглашение] -> Полученные согласия.
 - Вариант "Не сохранять согласия пользователей" (значение по
   умолчанию) отключает фиксацию - выбор хранится только
   в cookie браузера.
 - Ссылка "Редактировать соглашения" рядом с полем ведёт в список
   соглашений, где можно создать новое.

Время жизни согласия (дни)

 Срок хранения cookie cookie_consent с выбором пользователя.
 По истечении срока баннер будет показан повторно. Если оставить
 поле пустым или указать 0, применяется значение по умолчанию -
 365 дней.

Текст уведомления

 Основной текст баннера. HTML-теги не поддерживаются - текст
 выводится как есть (экранируется). Ссылка на политику
 конфиденциальности (см. ниже) добавляется после этого текста
 автоматически.

Тексты кнопок: согласия, отказа, настроек

 - Текст кнопки согласия - по умолчанию "Принять все".
   Клик разрешает все категории cookie.
 - Текст кнопки отказа - по умолчанию "Отклонить". Клик запрещает
   аналитику и маркетинг, оставляя только функциональные cookie.
 - Текст кнопки настроек - по умолчанию "Настроить". Кнопка
   выводится только если на вкладке "Категории cookie" включён
   выбор категорий.

 ВАЖНО: кнопка с пустым текстом не выводится вовсе. Это способ
 убрать лишние кнопки из баннера - например, чтобы оставить
 только "Принять все", очистите тексты кнопок отказа и настроек.

Адрес страницы отказа

 Поле для URL, куда должен вести отказ вместо стандартной
 обработки. ВНИМАНИЕ: в текущей версии модуля поле сохраняется,
 но фронтендом не используется - кнопка отказа всегда выполняет
 стандартный отказ (запрет аналитики и маркетинга). Учитывайте
 это при настройке.

URL политики конфиденциальности и текст ссылки

 - Ссылка выводится в баннере после текста уведомления, только
   если URL заполнен.
 - URL обязан начинаться с http://, https:// или / - значение
   в другом формате игнорируется, и ссылка не выводится.
 - Ссылка открывается в новой вкладке.
 - Текст ссылки на политику - анкор ссылки, по умолчанию
   "Политика конфиденциальности".
 - Страницу политики можно сгенерировать через
   Сервисы -> Cookie Consent -> Генератор политики.

Аналитические куки и маркетинговые куки

 Это НЕ описания, а поля для кода скриптов (Google Analytics,
 Яндекс.Метрика, чат-виджеты и т.п.):

 - Вставленный код автоматически добавляется в <head> всех
   страниц, если посетитель разрешил соответствующую категорию
   (при повторных визитах - сразу сервером, при клике по
   кнопке - динамически, без перезагрузки).
 - Если посетитель категорию запретил - код не выполняется.
 - Редактировать эти поля может только администратор: при
   сохранении настроек пользователем без прав администратора
   содержимое полей не изменяется.

Блокировка cookie

 - "Блокировать создание cookies (кроме указанных в списке
   ниже)" - жёсткий режим: перехватывается установка cookie
   через document.cookie, и все cookie, кроме разрешённых,
   блокируются до согласия. Дополнительно на сервере удаляются
   уже установленные не-функциональные cookie, если посетитель
   отказался от категорий.
 - "Функциональные куки" - белый список ЧЕРЕЗ ЗАПЯТУЮ.
   Сравнение идёт по началу имени cookie, поэтому BITRIX_SM_
   разрешает все служебные cookie Битрикс с этим префиксом.
   Значение по умолчанию:
   PHPSESSID, BITRIX_SM_, BX_USER_ID, BITRIX_CONVERSION_CONTEXT_,
   BITRIX_SM_GUEST_ID, BITRIX_SM_LAST_VISIT.
   Служебная cookie модуля cookie_consent разрешена всегда.

ВКЛАДКА "ВНЕШНИЙ ВИД"

 - Положение баннера - сверху / снизу (полоса на всю ширину) /
   справа внизу (плавающий блок).
 - Показывать кнопку закрытия баннера - добавляет крестик в углу
   баннера. ВАЖНО: клик по крестику приравнивается к "Принять
   все" - баннер не просто скрывается, а фиксируется полное
   согласие.
 - Цветовая схема - одна из 10 готовых тем (серая, тёмная,
   светлая, синяя, зелёная, красная, фиолетовая, оранжевая,
   бирюзовая, розовая) либо "Пользовательские цвета". Готовая
   тема задаётся CSS-классом и переопределяет ручные цвета.
 - При выборе "Пользовательские цвета" появляются поля: фон
   и текст баннера, фон и текст кнопок согласия и отказа, цвет
   чекбоксов в модальном окне. Цвет крестика закрытия
   автоматически совпадает с цветом фона кнопки согласия.
   Кнопка "Настроить" окрашивается в цвета кнопки отказа.
 - Z-index (по умолчанию 9999) - увеличьте, если баннер
   перекрывается шапкой или другими элементами сайта.
 - Непрозрачность баннера - от 0.1 до 1 с шагом 0.1
   (по умолчанию 0.9).
 - Скругление углов баннера (0-50 px) и кнопок (0-25 px).
 - Толщина границы баннера (0-10 px) и цвет границы - при
   толщине 0 граница не выводится, цвет игнорируется.
 - Внутренние отступы баннера (5-50 px) и размер текста
   (10-24 px). Эти же параметры применяются к модальному окну
   настроек.

ВКЛАДКА "КАТЕГОРИИ COOKIE"

 - Включить выбор категорий cookie - главный переключатель
   режима категорий:
     * включён: в баннере появляется кнопка "Настроить",
       открывающая модальное окно с чекбоксами категорий;
       пользователь может принять только выбранные категории
       (кнопка "Сохранить настройки") или отклонить все;
     * выключен: ни кнопки "Настроить", ни модального окна нет -
       независимо от текста кнопки настроек. Баннер работает
       в режиме "принять всё / отклонить всё".
 - Функциональные cookie - всегда включены, чекбокс в окне
   настроек заблокирован: без них сайт не работает.
 - Аналитические cookie и Маркетинговые cookie - задают
   состояние чекбоксов ПО УМОЛЧАНИЮ в модальном окне. Если
   категория выключена здесь, в окне настроек она будет снята,
   и пользователю придётся включить её явно - это соответствует
   принципу "согласие по умолчанию не дано".

После изменений нажмите "Сохранить".

ПРАВА ДОСТУПА

Если пункт меню или настройки не видны сотрудникам, проверьте
уровень доступа группы: Настройки -> Пользователи -> Группы
пользователей -> [группа] -> Доступ. Для модуля "Cookie Consent"
нужен уровень не ниже "Чтение" ®. Поля со скриптами аналитики
и маркетинга сохраняются только администратором.

========================================================
ИНТЕГРАЦИЯ ДЛЯ РАЗРАБОТЧИКОВ
========================================================

Модуль создает глобальный JavaScript-объект
window.cookieConsentStatus, который доступен на всех страницах
сайта. Этот объект содержит информацию о выборе пользователя.

Пример объекта window.cookieConsentStatus:

   {
       "functional": true,        // Всегда true
       "analytics": true,         // true, если пользователь
                                  // разрешил аналитические cookie
       "marketing": false,        // false, если пользователь
                                  // отклонил маркетинговые cookie
       "timestamp": 1672405200000 // Временная метка согласия
   }

Вы можете использовать этот объект в своих скриптах, чтобы
проверять, разрешил ли пользователь ту или иную категорию cookie,
перед их выполнением.

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

   if (window.cookieConsentStatus && window.cookieConsentStatus.analytics) {
     // Код для инициализации Яндекс.Метрики или Google Analytics
     console.log("Аналитические cookie разрешены. Загружаем скрипты аналитики.");
   }

   if (window.cookieConsentStatus && window.cookieConsentStatus.marketing) {
     // Код для инициализации рекламных пикселей (VK, Facebook и т.д.)
     console.log("Маркетинговые cookie разрешены. Загружаем рекламные скрипты.");
   }

Для упрощения интеграции вы можете добавить к тегам <script>
специальный атрибут data-cookie-category. Модуль автоматически
обработает эти скрипты в зависимости от выбора пользователя.

 - data-cookie-category="analytics" - скрипт будет выполнен
   только если пользователь разрешил аналитические cookie.
 - data-cookie-category="marketing" - скрипт будет выполнен
   только если пользователь разрешил маркетинговые cookie.

Пример:

   <!- Этот скрипт будет загружен только если пользователь разрешит аналитику ->
   <script type="text/javascript" data-cookie-category="analytics">
     (function (m, e, t, r, i, k, a) {
       m[i] = m[i] || function () { (m[i].a = m[i].a || []).push(arguments); };
       m[i].l = 1 * new Date();
       (k = e.createElement(t)),
         (a = e.getElementsByTagName(t)[0]),
         (k.async = 1),
         (k.src = r),
         a.parentNode.insertBefore(k, a);
     })(window, document, "script", "https://mc.yandex.ru/metrika/tag.js&quot;, "ym");

     ym(99999999, "init", {
       clickmap: true,
       trackLinks: true,
       accurateTrackBounce: true,
     });
   </script>

   <!- Этот скрипт будет загружен только если пользователь разрешит маркетинг ->
   <script type="text/javascript" data-cookie-category="marketing">
     // Код пикселя Facebook
   </script>

СОБЫТИЕ cookieConsentChange

При каждом изменении статуса согласия (принятие, отклонение,
сохранение настроек) модуль генерирует глобальное событие
cookieConsentChange на объекте document. Вы можете подписаться
на это событие, чтобы динамически реагировать на действия
пользователя.

Пример подписки на событие:

   document.addEventListener("cookieConsentChange", function (event) {
     console.log("Статус согласия изменен:", event.detail);

     // event.detail содержит
     // { type: 'accept' | 'decline' | 'accept-selected', consent: {...} }

     if (event.detail.consent.analytics) {
       // Загрузить или активировать аналитику
     } else {
       // Отключить аналитику
     }
   });