Этот пакет добавляет на ваш сайт простое, настраиваемое сообщение о согласии на использование файлов cookie. Когда сайт загружается, появляется баннер, позволяющий пользователям дать согласие на использование файлов cookie. После получения согласия баннер скрывается и остается скрытым.
Чего нет в этом пакете:
Если вам нужны более продвинутые варианты согласия на использование файлов cookie в Laravel, рассмотрите эти альтернативы.
Мы вкладываем много ресурсов в создание лучших в своем классе пакетов с открытым исходным кодом. Вы можете поддержать нас, купив один из наших платных продуктов.
Мы очень признательны вам за отправку нам открытки из вашего родного города с указанием того, какой из наших пакетов вы используете. Наш адрес вы найдете на странице контактов. Все полученные открытки мы публикуем на нашей виртуальной стене открыток.
Вы можете установить пакет через композитор:
composer require spatie/laravel-cookie-consent
Пакет автоматически зарегистрируется.
При желании вы можете опубликовать конфигурационный файл:
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-config "
Это содержимое опубликованного конфигурационного файла:
return [
/*
* Use this setting to enable the cookie consent dialog.
*/
' enabled ' => env ( ' COOKIE_CONSENT_ENABLED ' , true ),
/*
* The name of the cookie in which we store if the user
* has agreed to accept the conditions.
*/
' cookie_name ' => ' laravel_cookie_consent ' ,
/*
* Set the cookie duration in days. Default is 365 * 20.
*/
' cookie_lifetime ' => 365 * 20 ,
];
Домен cookie задается ключом «домен» в config/session.php, обязательно добавьте значение в свой .env для SESSION_DOMAIN. Если вы используете домен с портом в URL-адресе, например «localhost:3000», этот пакет не будет работать, пока вы это не сделаете.
Чтобы отобразить диалоговое окно, все, что вам нужно сделать, это включить это представление в свой шаблон:
//in your blade template
@include ( ' cookie-consent::index ' )
Это отобразит следующий диалог, который в стилизованном виде будет очень похож на этот.
Стиль по умолчанию, предоставляемый этим пакетом, использует TailwindCSS v2 для создания плавающего баннера внизу страницы.
Когда пользователь нажимает «Разрешить файлы cookie», будет установлен файл cookie laravel_cookie_consent
, и диалоговое окно будет удалено из DOM. При следующем запросе Laravel заметит, что laravel_cookie_consent
установлен, и больше не будет отображать диалог.
Если вы хотите изменить текст, отображаемый в диалоговом окне, вы можете опубликовать lang-файлы с помощью этой команды:
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-translations "
Этот файл будет опубликован в resources/lang/vendor/cookie-consent/en/texts.php
.
return [
' message ' => ' Please be informed that this site uses cookies. ' ,
' agree ' => ' Allow cookies ' ,
];
Если вы хотите перевести значения, например, на французский язык, просто скопируйте этот файл в resources/lang/vendor/cookie-consent/fr/texts.php
и заполните французский перевод.
Если вам нужен полный контроль над содержимым диалога. Вы можете опубликовать мнения о пакете:
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-views "
Это скопирует файлы представления index
и dialogContents
в resources/views/vendor/cookie-consent
. Вероятно, вы захотите изменить только представление dialogContents
. Если вам нужно изменить код JavaScript этого пакета, вы можете сделать это в файле index
представления.
Вместо включения cookie-consent::index
в ваше представление вы можете добавить SpatieCookieConsentCookieConsentMiddleware
в ваше ядро:
// app/Http/Kernel.php
class Kernel extends HttpKernel
{
protected $ middleware = [
// ...
Spatie CookieConsent CookieConsentMiddleware::class,
];
// ...
}
Это автоматически добавит cookie-consent::index
к содержимому вашего ответа прямо перед закрывающим тегом body.
Мы не юристы и не можем предоставлять юридические консультации. Проконсультируйтесь с юристами, какие правила применяются к вашему проекту.
Пожалуйста, посетите CHANGELOG для получения дополнительной информации о том, что изменилось за последнее время.
composer test
Пожалуйста, смотрите ВКЛАД для получения подробной информации.
Если вы обнаружите какие-либо проблемы, связанные с безопасностью, отправьте электронное письмо по адресу [email protected] вместо использования системы отслеживания проблем.
Лицензия MIT (MIT). Дополнительную информацию см. в файле лицензии.