Este pacote adiciona uma mensagem de consentimento de cookie simples e personalizável ao seu site. Quando o site carrega, o banner aparece e permite que os usuários concordem com os cookies. Depois que o consentimento for dado, o banner será ocultado e permanecerá oculto.
O que este pacote não faz:
Para opções mais avançadas de consentimento de cookies no Laravel, considere estas alternativas.
Investimos muitos recursos na criação dos melhores pacotes de código aberto. Você pode nos apoiar comprando um de nossos produtos pagos.
Agradecemos muito que você nos envie um cartão postal de sua cidade natal, mencionando qual(is) de nossos pacotes você está usando. Você encontrará nosso endereço em nossa página de contato. Publicamos todos os cartões postais recebidos em nosso mural virtual de cartões postais.
Você pode instalar o pacote via compositor:
composer require spatie/laravel-cookie-consent
O pacote será registrado automaticamente.
Opcionalmente, você pode publicar o arquivo de configuração:
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-config "
Este é o conteúdo do arquivo de configuração publicado:
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 ,
];
O domínio do cookie é definido pela chave 'domain' em config/session.php, certifique-se de adicionar um valor em seu .env para SESSION_DOMAIN. Se você estiver usando um domínio com uma porta na URL como 'localhost:3000', este pacote não funcionará até que você faça isso.
Para exibir a caixa de diálogo, tudo que você precisa fazer é incluir esta visualização em seu modelo:
//in your blade template
@include ( ' cookie-consent::index ' )
Isto renderizará a seguinte caixa de diálogo que, quando estilizada, ficará muito parecida com esta.
O estilo padrão fornecido por este pacote usa TailwindCSS v2 para fornecer um banner flutuante na parte inferior da página.
Quando o usuário clica em "Permitir cookies", um cookie laravel_cookie_consent
será definido e a caixa de diálogo será removida do DOM. Na próxima solicitação, o Laravel notará que laravel_cookie_consent
foi definido e não exibirá a caixa de diálogo novamente
Se você quiser modificar o texto mostrado na caixa de diálogo, você pode publicar os arquivos lang com este comando:
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-translations "
Isso publicará este arquivo em resources/lang/vendor/cookie-consent/en/texts.php
.
return [
' message ' => ' Please be informed that this site uses cookies. ' ,
' agree ' => ' Allow cookies ' ,
];
Se você quiser traduzir os valores para, por exemplo, francês, basta copiar esse arquivo para resources/lang/vendor/cookie-consent/fr/texts.php
e preencher as traduções em francês.
Se você precisar de controle total sobre o conteúdo da caixa de diálogo. Você pode publicar as visualizações do pacote:
php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-views "
Isso copiará os arquivos de visualização index
e dialogContents
para resources/views/vendor/cookie-consent
. Você provavelmente deseja apenas modificar a visualização dialogContents
. Se precisar modificar o código JavaScript deste pacote, você pode fazê-lo no arquivo de visualização index
.
Em vez de incluir cookie-consent::index
em sua visão, você pode optar por adicionar SpatieCookieConsentCookieConsentMiddleware
ao seu kernel:
// app/Http/Kernel.php
class Kernel extends HttpKernel
{
protected $ middleware = [
// ...
Spatie CookieConsent CookieConsentMiddleware::class,
];
// ...
}
Isso adicionará automaticamente cookie-consent::index
ao conteúdo da sua resposta logo antes da tag body de fechamento.
Não somos advogados e não podemos fornecer aconselhamento jurídico. Consulte profissionais jurídicos sobre quais regras se aplicam ao seu projeto.
Consulte CHANGELOG para obter mais informações sobre o que mudou recentemente.
composer test
Consulte CONTRIBUINDO para obter detalhes.
Se você descobrir algum problema relacionado à segurança, envie um e-mail para [email protected] em vez de usar o rastreador de problemas.
A licença MIT (MIT). Consulte Arquivo de licença para obter mais informações.