Как добавить куки на сайт WordPress: полное руководство

Объяснение понятия куки (cookies)

Куки (HTTP cookies) – это небольшие фрагменты данных, отправляемые веб-сервером и хранимые на устройстве пользователя (в браузере). При последующих посещениях сайта браузер отправляет эти данные обратно серверу. Это позволяет сайтам "узнавать" пользователей и сохранять информацию о них между сессиями.

Саммари статьи

ChatGPT

Google AI

Grok

Perplexity

В контексте WordPress куки играют ключевую роль в реализации множества функций, от аутентификации до персонализации пользовательского опыта и сбора аналитических данных.

Типы куки: сессионные и постоянные

Существует два основных типа куки:

Сессионные куки (Session cookies): Хранятся временно и удаляются после закрытия браузера. Они используются для отслеживания состояния пользователя в течение одного сеанса, например, для поддержания состояния входа в систему или содержимого корзины покупок.

Постоянные куки (Persistent cookies): Сохраняются на устройстве пользователя на определенный срок (указанный в параметре Expires или Max-Age) или до тех пор, пока не будут удалены вручную. Они используются для запоминания предпочтений пользователя, автоматического входа и отслеживания активности между сессиями.

Примеры использования куки на сайтах WordPress: авторизация, отслеживание, персонализация

Авторизация: WordPress использует куки (wordpress_logged_in_[hash], wordpress_sec_[hash]) для идентификации залогиненных пользователей и управления их сессиями.

Отслеживание: Системы аналитики (например, Google Analytics через плагины) и рекламные сети используют куки (_ga, _gid) для отслеживания поведения пользователей, источников трафика и эффективности кампаний.

Персонализация: Куки позволяют запоминать предпочтения пользователя (язык, тема оформления, настройки отображения контента) или показывать релевантный контент и рекламу на основе предыдущих взаимодействий.

Электронная коммерция: WooCommerce и другие e-commerce плагины используют куки для хранения содержимого корзины, списка желаний и информации о сеансе покупателя.

Соответствие GDPR и политика конфиденциальности при использовании куки

Общий регламент по защите данных (GDPR) и другие законы о конфиденциальности (например, ePrivacy Directive) требуют, чтобы сайты получали явное согласие пользователей перед установкой большинства типов куки (кроме строго необходимых). Необходимо:

Информировать пользователей о типах используемых куки, их назначении и сроке хранения.

Получать активное согласие пользователя (opt-in) перед установкой некритичных куки.

Предоставлять пользователям возможность управлять своими предпочтениями и отзывать согласие.

Иметь подробную и доступную Политику конфиденциальности (Privacy Policy) и Политику использования куки (Cookie Policy).

Несоблюдение этих требований может привести к значительным штрафам.

Добавление куки в WordPress с помощью плагинов

Использование плагинов является наиболее простым и безопасным способом управления куки и согласием пользователей, особенно для тех, кто не хочет глубоко погружаться в код.

Обзор популярных плагинов для управления куки в WordPress

Существует множество плагинов для управления куки и баннерами согласия. Наиболее популярные и функциональные:

CookieYes | GDPR Cookie Consent & Compliance Notice: Комплексное решение для GDPR/CCPA, предлагает сканер куки, автоматическую блокировку скриптов до получения согласия, настраиваемый баннер согласия и генератор политики куки.

Complianz – GDPR/CCPA Cookie Consent: Автоматически определяет необходимые настройки на основе региона пользователя, сканирует сайт на наличие куки, интегрируется с Tag Manager и предоставляет юридически выверенные шаблоны документов.

Cookie Notice & Compliance for GDPR / CCPA: Простой и популярный плагин для отображения баннера согласия и управления куки.

Выбор плагина зависит от специфических требований проекта, необходимого уровня кастомизации и бюджета.

Пошаговая инструкция по установке и настройке плагина для добавления куки

Процесс установки и базовой настройки для большинства плагинов схож:

Установка: Перейдите в раздел "Плагины" -> "Добавить новый" в админ-панели WordPress. Найдите выбранный плагин (например, CookieYes) и нажмите "Установить", затем "Активировать".

Первичная настройка: Обычно после активации плагин предлагает пройти мастер настройки. Следуйте инструкциям, указав регион действия законодательства (GDPR, CCPA и т.д.), данные о сайте и предпочтения по отображению баннера.

Сканирование куки: Запустите сканирование сайта для обнаружения используемых куки. Плагин классифицирует их по категориям (необходимые, функциональные, аналитические, рекламные).

Настройка баннера согласия: Кастомизируйте внешний вид, текст и кнопки баннера согласия в соответствии с дизайном сайта и требованиями законодательства.

Интеграция: При необходимости настройте интеграцию с Google Tag Manager или другими сервисами.

Настройка параметров куки через плагин (срок действия, домен, путь)

Хотя плагины в первую очередь управляют согласием на использование куки, которые устанавливаются другими скриптами (темой, плагинами, внешними сервисами), некоторые плагины или их расширения могут позволять создавать пользовательские куки через интерфейс. Однако чаще всего параметры куки (срок действия, домен, путь) задаются в том коде, который их устанавливает (например, в настройках Google Analytics или в пользовательском коде).

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

Добавление куки в WordPress вручную (без плагинов)

Ручное добавление куки требует понимания PHP и структуры WordPress. Этот метод предоставляет максимальную гибкость, но также несет риски, если не соблюдать меры безопасности.

Использование функции `setcookie()` в PHP для установки куки

Основная функция PHP для установки куки – setcookie(). Ее необходимо вызывать до любого вывода HTML или другого контента браузеру. В WordPress это обычно делается с помощью хуков, таких как init или wp_loaded.

Синтаксис функции:

setcookie(
    string $name,             // Имя куки
    string $value = "",        // Значение куки
    int $expires_or_options = 0, // Время истечения (Unix timestamp) или массив опций
    string $path = "",         // Путь на сервере, для которого куки будут доступны
    string $domain = "",       // Домен, для которого куки доступны
    bool $secure = false,       // Передавать куки только по HTTPS?
    bool $httponly = false      // Доступны ли куки только через HTTP протокол (не JS)?
): bool

Начиная с PHP 7.3, вместо $expires, $path, $domain, $secure, $httponly можно передать массив опций:

setcookie('user_preference', 'dark_theme', [
    'expires' => time() + (86400 * 30), // Срок действия 30 дней
    'path' => '/',
    'domain' => '.yourdomain.com', // Доступно для всех поддоменов
    'secure' => true,          // Только HTTPS
    'httponly' => true,       // Защита от XSS
    'samesite' => 'Lax'       // Атрибут SameSite (Strict, Lax, None)
]);

Примеры кода для добавления куки для различных целей

Пример: Запоминание UTM-меток первого визита

 $expires,
            'path' => '/',
            'secure' => is_ssl(), // Устанавливаем secure флаг, если сайт на HTTPS
            'httponly' => true,
            'samesite' => 'Lax'
        ]);
    }
}

// Добавляем функцию на хук 'init'
add_action('init', 'store_first_visit_utm_tags');

Размещение кода для установки куки в файле `functions.php` или в пользовательском плагине

Код для установки куки следует размещать:

В файле functions.php вашей активной темы: Подходит для специфичных для темы функций. Недостаток: Код будет потерян при смене или обновлении темы (если это не дочерняя тема).

В пользовательском плагине (site-specific plugin): Рекомендуемый способ. Создайте небольшой плагин специально для вашего сайта. Это гарантирует, что функциональность сохранится независимо от темы, и упрощает управление кодом.

Важно: Убедитесь, что вызов setcookie() происходит до вывода любого контента, используя соответствующие хуки (init, wp_loaded).

Безопасность при ручном добавлении куки: избежание XSS-атак

При работе с куки важно учитывать безопасность:

HttpOnly флаг: Устанавливайте httponly в true, чтобы куки были недоступны для чтения и модификации через JavaScript. Это основная защита от кражи куки через XSS-атаки.

Secure флаг: Устанавливайте secure в true (если ваш сайт использует HTTPS), чтобы куки передавались только по зашифрованному соединению, предотвращая их перехват.

SameSite атрибут: Используйте SameSite=Lax или SameSite=Strict для защиты от CSRF-атак. Lax является хорошим балансом между безопасностью и функциональностью, Strict — более строгий вариант.

Санитизация данных: Никогда не доверяйте данным, пришедшим от пользователя (например, из $_GET или $_POST), перед записью их в куки. Используйте функции WordPress для санитизации (sanitize_text_field, esc_attr и т.д.).

Не храните чувствительную информацию: Избегайте хранения паролей, ключей API или другой конфиденциальной информации непосредственно в куки. Для аутентификации используйте безопасные токены сессий.

Чтение и удаление куки в WordPress

После установки куки их значения можно читать и использовать на стороне сервера, а также удалять при необходимости.

Получение значений куки с помощью `$_COOKIE`

Значения установленных куки доступны в глобальном суперглобальном массиве $_COOKIE в PHP. Доступ к нему можно получить на любом этапе выполнения скрипта после получения запроса от браузера.

<?php
// Проверяем, существует ли кука 'user_preference'
if (isset($_COOKIE['user_preference'])) {
    // Получаем значение куки и очищаем его
    $preference = sanitize_text_field($_COOKIE['user_preference']);

    // Используем значение (например, для установки класса CSS)
    if ($preference === 'dark_theme') {
        // Добавить класс 'dark-mode' к тегу 
        add_filter('body_class', function(array $classes): array {
            $classes[] = 'dark-mode';
            return $classes;
        });
    }
}

// Пример чтения JSON из куки (ранее сохраненные UTM-метки)
if (isset($_COOKIE['first_visit_utm'])) {
    $json_utm_data = wp_unslash($_COOKIE['first_visit_utm']);
    $utm_data = json_decode($json_utm_data, true);

    if (is_array($utm_data) && isset($utm_data['utm_source'])) {
        $source = sanitize_text_field($utm_data['utm_source']);
        // Можно использовать $source для аналитики или персонализации
        error_log('First visit source: ' . $source); // Логирование для отладки
    }
}

Примеры кода для чтения и использования значений куки

Приведенные выше примеры демонстрируют базовое чтение куки. Значения можно использовать для:

Персонализации контента или внешнего вида.

Заполнения форм.

Передачи данных в системы аналитики.

Управления доступом к определенным разделам.

Удаление куки путем установки срока действия в прошлом

Для удаления куки необходимо вызвать функцию setcookie() с тем же именем, путем и доменом, но с датой истечения в прошлом. Часто используется time() - 3600.

 time() - 3600,
            'path' => '/',
            'secure' => is_ssl(),
            'httponly' => true,
            'samesite' => 'Lax'
        ]);
    }
}

// Вызывать эту функцию можно по определенному действию пользователя,
// например, при сбросе настроек или выходе из системы.
// add_action('some_user_action', 'delete_user_preference_cookie');

Важно: Параметры path, domain, secure, httponly при удалении должны совпадать с теми, что использовались при установке куки.

Очистка куки по требованию пользователя

В соответствии с GDPR, пользователи должны иметь возможность отозвать свое согласие и, как следствие, удалить связанные куки. Плагины управления согласием обычно предоставляют эту функциональность. При ручной реализации вам потребуется создать интерфейс (например, кнопку в настройках профиля) и соответствующий обработчик на сервере, который вызовет функцию удаления нужных куки (как показано выше).

Рекомендации и распространенные ошибки

Оптимизация использования куки для повышения производительности сайта

Минимизируйте размер куки: Браузеры отправляют куки с каждым HTTP-запросом к вашему домену. Большие куки увеличивают размер запроса и могут замедлить загрузку сайта. Храните только необходимую информацию.

Уменьшайте количество куки: Каждый куки добавляет накладные расходы. Объединяйте связанные данные в одну куку (например, используя JSON), если это возможно.

Устанавливайте правильный Path и Domain: Ограничьте область действия куки только теми путями и доменами, где они действительно нужны. Не устанавливайте все куки на / и корневой домен без необходимости.

Используйте CDN для статики: Статические ресурсы (CSS, JS, изображения) часто не требуют куки. Размещение их на домене без куки (cookieless domain) через CDN может ускорить загрузку.

Обработка согласия пользователя на использование куки (Cookie Consent)

Используйте плагин: Для большинства сайтов это самый надежный способ соответствовать требованиям GDPR/CCPA. Плагины автоматизируют получение согласия, блокировку скриптов и управление предпочтениями.

Не устанавливайте куки до согласия: Некритичные куки (аналитические, рекламные, функциональные) не должны устанавливаться до получения явного согласия пользователя.

Предоставьте гранулярный контроль: Дайте пользователям возможность выбирать, какие категории куки они разрешают.

Легкий отзыв согласия: Обеспечьте простой способ для пользователей изменить свои настройки или отозвать согласие.

Устранение распространенных ошибок при работе с куки в WordPress

Куки не устанавливаются: Убедитесь, что setcookie() вызывается до любого вывода HTML (проверьте отсутствие пробелов или текста перед <?php). Используйте хуки типа init. Проверьте правильность параметров (path, domain). Очистите кеш браузера и сайта.

Куки не читаются: Убедитесь, что вы пытаетесь прочитать куки после того, как они были установлены и страница перезагружена. Проверьте, что path и domain куки соответствуют текущей странице. Проверьте, не установлен ли флаг HttpOnly, если пытаетесь прочитать куки через JavaScript.

Куки не удаляются: Проверьте, что все параметры (name, path, domain, secure, httponly) в setcookie() при удалении точно совпадают с параметрами при установке. Убедитесь, что срок действия установлен в прошлом.

Конфликты с кешированием: Агрессивное кеширование на стороне сервера или клиента может мешать правильной установке или чтению куки. Настройте правила кеширования так, чтобы они учитывали наличие определенных куки или исключали страницы, где важна динамическая работа с куки.

Полезные ресурсы и дальнейшее изучение темы

Документация PHP setcookie(): https://www.php.net/manual/ru/function.setcookie.php

Документация WordPress Codex/Developer Resources: Информация о хуках, функциях санитизации и лучших практиках.

Статьи по GDPR и ePrivacy: Изучите требования законодательства в вашем регионе.

Инструменты разработчика в браузере (Developer Tools): Вкладки Application (Chrome) или Storage (Firefox) позволяют инспектировать, изменять и удалять куки для отладки.

Работа с куки – неотъемлемая часть веб-разработки на WordPress. Понимание их механизмов, правильное использование и соблюдение требований законодательства и безопасности помогут создавать более функциональные, персонализированные и надежные сайты.