Ce package ajoute un message de consentement aux cookies simple et personnalisable à votre site. Lors du chargement du site, la bannière apparaît et permet aux utilisateurs d'accepter les cookies. Une fois le consentement donné, la bannière se cache et reste cachée.
Ce que ce package ne fait pas :
Pour des options de consentement aux cookies plus avancées dans Laravel, envisagez ces alternatives.
Nous investissons beaucoup de ressources dans la création des meilleurs packages open source de leur catégorie. Vous pouvez nous soutenir en achetant l'un de nos produits payants.
Nous apprécions grandement que vous nous envoyiez une carte postale de votre ville natale, mentionnant le(s) forfait(s) que vous utilisez. Vous trouverez notre adresse sur notre page contact. Nous publions toutes les cartes postales reçues sur notre mur virtuel de cartes postales.
Vous pouvez installer le package via composer :
composer require spatie/laravel-cookie-consent
Le package s’enregistrera automatiquement.
Vous pouvez éventuellement publier le fichier de configuration :
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-config "
Voici le contenu du fichier de configuration publié :
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 ,
];
Le domaine du cookie est défini par la clé 'domain' dans config/session.php, assurez-vous d'ajouter une valeur dans votre .env pour SESSION_DOMAIN. Si vous utilisez un domaine avec un port dans l'URL tel que « localhost:3000 », ce package ne fonctionnera pas tant que vous ne l'aurez pas fait.
Pour afficher la boîte de dialogue, il vous suffit d'inclure cette vue dans votre modèle :
//in your blade template
@include ( ' cookie-consent::index ' )
Cela affichera la boîte de dialogue suivante qui, une fois stylisée, ressemblera beaucoup à celle-ci.
Le style par défaut fourni par ce package utilise TailwindCSS v2 pour fournir une bannière flottante en bas de la page.
Lorsque l'utilisateur clique sur "Autoriser les cookies", un cookie laravel_cookie_consent
sera défini et la boîte de dialogue sera supprimée du DOM. Lors de la prochaine requête, Laravel remarquera que laravel_cookie_consent
a été défini et n'affichera plus la boîte de dialogue
Si vous souhaitez modifier le texte affiché dans la boîte de dialogue, vous pouvez publier les fichiers lang avec cette commande :
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-translations "
Cela publiera ce fichier dans resources/lang/vendor/cookie-consent/en/texts.php
.
return [
' message ' => ' Please be informed that this site uses cookies. ' ,
' agree ' => ' Allow cookies ' ,
];
Si vous souhaitez traduire les valeurs, par exemple, en français, copiez simplement ce fichier dans resources/lang/vendor/cookie-consent/fr/texts.php
et remplissez les traductions en français.
Si vous avez besoin d'un contrôle total sur le contenu de la boîte de dialogue. Vous pouvez publier les vues du package :
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-views "
Cela copiera les fichiers de vue index
et dialogContents
dans resources/views/vendor/cookie-consent
. Vous souhaitez probablement uniquement modifier la vue dialogContents
. Si vous devez modifier le code JavaScript de ce package, vous pouvez le faire dans le fichier de vue index
.
Au lieu d'inclure cookie-consent::index
à votre avis, vous pouvez choisir d'ajouter SpatieCookieConsentCookieConsentMiddleware
à votre noyau :
// app/Http/Kernel.php
class Kernel extends HttpKernel
{
protected $ middleware = [
// ...
Spatie CookieConsent CookieConsentMiddleware::class,
];
// ...
}
Cela ajoutera automatiquement cookie-consent::index
au contenu de votre réponse juste avant la balise body de fermeture.
Nous ne sommes pas des avocats et ne pouvons pas fournir de conseils juridiques. Consultez des professionnels du droit pour connaître les règles qui s'appliquent à votre projet.
Veuillez consulter CHANGELOG pour plus d'informations sur ce qui a changé récemment.
composer test
Veuillez consulter CONTRIBUER pour plus de détails.
Si vous découvrez des problèmes liés à la sécurité, veuillez envoyer un e-mail à [email protected] au lieu d'utiliser le suivi des problèmes.
La licence MIT (MIT). Veuillez consulter le fichier de licence pour plus d'informations.