laravel cookie consent

Mensaje de consentimiento de cookies simple y personalizable para Laravel

Este paquete agrega un mensaje de consentimiento de cookies simple y personalizable a su sitio. Cuando se carga el sitio, aparece el banner y permite a los usuarios dar su consentimiento para las cookies. Una vez que se da el consentimiento, el banner se oculta y permanece oculto.

Lo que este paquete no incluye:

• Incluya una opción para 'Rechazar' todas las cookies, que podría ser necesaria.
• Bloquee rastreadores y cookies antes del consentimiento. Tienes que encargarte de esto tú mismo.
• Incluya opciones para diferentes categorías de consentimiento como "Necesario" o "Marketing".

Para opciones de consentimiento de cookies más avanzadas en Laravel, considere estas alternativas.

• whitecube/laravel-cookie-consentimiento
• statikbe/laravel-cookie-consentimiento

Apóyanos

Invertimos muchos recursos en la creación de los mejores paquetes de código abierto. Puedes apoyarnos comprando uno de nuestros productos pagos.

Apreciamos mucho que nos envíe una postal desde su ciudad natal, mencionando cuál de nuestros paquetes está utilizando. Encontrarás nuestra dirección en nuestra página de contacto. Publicamos todas las postales recibidas en nuestro muro virtual de postales.

Instalación

Puede instalar el paquete a través del compositor:

composer require spatie/laravel-cookie-consent

El paquete se registrará automáticamente.

Opcionalmente, puede publicar el archivo de configuración:

php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-config "

Este es el contenido del archivo de configuración 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 ,
];

El dominio de la cookie se establece mediante la clave 'dominio' en config/session.php, asegúrese de agregar un valor en su .env para SESSION_DOMAIN. Si está utilizando un dominio con un puerto en la URL como 'localhost:3000', este paquete no funcionará hasta que lo haga.

Uso

Para mostrar el cuadro de diálogo todo lo que tienes que hacer es incluir esta vista en tu plantilla:

//in your blade template
@include ( ' cookie-consent::index ' )

Esto generará el siguiente cuadro de diálogo que, cuando se le aplique el estilo, se parecerá mucho a este.

El estilo predeterminado proporcionado por este paquete utiliza TailwindCSS v2 para proporcionar un banner flotante en la parte inferior de la página.

Cuando el usuario hace clic en "Permitir cookies", se establecerá una cookie laravel_cookie_consent y el cuadro de diálogo se eliminará del DOM. En la siguiente solicitud, Laravel notará que laravel_cookie_consent se ha configurado y no volverá a mostrar el cuadro de diálogo.

Personalizar los textos del diálogo

Si desea modificar el texto que se muestra en el cuadro de diálogo, puede publicar los archivos de idioma con este comando:

php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-translations "

Esto publicará este archivo en resources/lang/vendor/cookie-consent/en/texts.php .

 return [
    ' message ' => ' Please be informed that this site uses cookies. ' ,
    ' agree ' => ' Allow cookies ' ,
];

Si desea traducir los valores, por ejemplo, al francés, simplemente copie ese archivo en resources/lang/vendor/cookie-consent/fr/texts.php y complete las traducciones al francés.

Personalización del contenido del diálogo

Si necesita control total sobre el contenido del cuadro de diálogo. Puedes publicar las vistas del paquete:

php artisan vendor:publish --provider= " SpatieCookieConsentCookieConsentServiceProvider " --tag= " cookie-consent-views "

Esto copiará los archivos de vista index y dialogContents en resources/views/vendor/cookie-consent . Probablemente sólo desee modificar la vista dialogContents . Si necesita modificar el código JavaScript de este paquete, puede hacerlo en el archivo de vista index .

Usando el software intermedio

En lugar de incluir cookie-consent::index en su vista, puede optar por agregar SpatieCookieConsentCookieConsentMiddleware a su kernel:

 // app/Http/Kernel.php

class Kernel extends HttpKernel
{
    protected $ middleware = [
        // ...
         Spatie  CookieConsent CookieConsentMiddleware::class,
    ];

    // ...
}

Esto agregará automáticamente cookie-consent::index al contenido de su respuesta justo antes de la etiqueta del cuerpo de cierre.

Aviso

No somos abogados y no podemos brindar asesoramiento legal. Consulte a los profesionales del derecho qué normas se aplican a su proyecto.

Registro de cambios

Consulte CHANGELOG para obtener más información sobre los cambios recientes.

Pruebas

composer test 

Contribuyendo

Consulte CONTRIBUCIÓN para obtener más detalles.

Seguridad

Si descubre algún problema relacionado con la seguridad, envíe un correo electrónico a [email protected] en lugar de utilizar el rastreador de problemas.

Créditos

• Freek Van der Herten
• Willem Van Bockstal
• Todos los contribuyentes

Licencia

La Licencia MIT (MIT). Consulte el archivo de licencia para obtener más información.