laravel cookie consent

Einfache, anpassbare Cookie-Einwilligungsnachricht für Laravel

Dieses Paket fügt Ihrer Website eine einfache, anpassbare Cookie-Einwilligungsnachricht hinzu. Wenn die Website geladen wird, erscheint das Banner und ermöglicht den Benutzern die Zustimmung zu Cookies. Sobald die Einwilligung erteilt wurde, wird das Banner ausgeblendet und bleibt ausgeblendet.

Was dieses Paket nicht bietet:

• Fügen Sie eine Option zum „Ablehnen“ aller Cookies hinzu, die möglicherweise erforderlich sind.
• Blockieren Sie Tracker und Cookies vor der Einwilligung. Sie müssen dies selbst in die Hand nehmen.
• Fügen Sie Optionen für verschiedene Einwilligungskategorien wie „Notwendig“ oder „Marketing“ hinzu.

Für erweiterte Cookie-Zustimmungsoptionen in Laravel sollten Sie diese Alternativen in Betracht ziehen.

• Whitecube/Laravel-Cookie-Einwilligung
• statikbe/laravel-cookie-consent

Unterstützen Sie uns

Wir investieren viele Ressourcen in die Erstellung erstklassiger Open-Source-Pakete. Sie können uns unterstützen, indem Sie eines unserer kostenpflichtigen Produkte kaufen.

Wir freuen uns sehr, dass Sie uns eine Postkarte aus Ihrer Heimatstadt schicken und erwähnen, welches unserer Pakete Sie verwenden. Unsere Adresse finden Sie auf unserer Kontaktseite. Wir veröffentlichen alle erhaltenen Postkarten auf unserer virtuellen Postkartenwand.

Installation

Sie können das Paket über Composer installieren:

composer require spatie/laravel-cookie-consent

Das Paket registriert sich automatisch.

Optional können Sie die Konfigurationsdatei veröffentlichen:

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

Dies ist der Inhalt der veröffentlichten Konfigurationsdatei:

 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 ,
];

Die Cookie-Domäne wird durch den Schlüssel „domain“ in config/session.php festgelegt. Stellen Sie sicher, dass Sie in Ihrer .env einen Wert für SESSION_DOMAIN hinzufügen. Wenn Sie eine Domäne mit einem Port in der URL wie „localhost:3000“ verwenden, funktioniert dieses Paket erst, wenn Sie dies tun.

Verwendung

Um den Dialog anzuzeigen, müssen Sie lediglich diese Ansicht in Ihre Vorlage einbinden:

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

Dadurch wird der folgende Dialog gerendert, der, wenn er gestaltet ist, diesem sehr ähnlich sein wird.

Der von diesem Paket bereitgestellte Standardstil verwendet TailwindCSS v2, um ein schwebendes Banner am unteren Rand der Seite bereitzustellen.

Wenn der Benutzer auf „Cookies zulassen“ klickt, wird ein laravel_cookie_consent -Cookie gesetzt und der Dialog wird aus dem DOM entfernt. Bei der nächsten Anfrage wird Laravel feststellen, dass laravel_cookie_consent gesetzt wurde, und zeigt den Dialog nicht erneut an

Anpassen der Dialogtexte

Wenn Sie den im Dialog angezeigten Text ändern möchten, können Sie die Lang-Dateien mit diesem Befehl veröffentlichen:

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

Dadurch wird diese Datei unter resources/lang/vendor/cookie-consent/en/texts.php veröffentlicht.

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

Wenn Sie die Werte beispielsweise ins Französische übersetzen möchten, kopieren Sie diese Datei einfach nach resources/lang/vendor/cookie-consent/fr/texts.php und geben Sie die französischen Übersetzungen ein.

Anpassen des Dialoginhalts

Wenn Sie die volle Kontrolle über den Inhalt des Dialogs benötigen. Sie können die Ansichten des Pakets veröffentlichen:

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

Dadurch werden die index und dialogContents Ansichtsdateien nach resources/views/vendor/cookie-consent kopiert. Sie möchten wahrscheinlich nur die Ansicht dialogContents ändern. Wenn Sie den JavaScript-Code dieses Pakets ändern müssen, können Sie dies in der index tun.

Verwendung der Middleware

Anstatt cookie-consent::index in Ihre Ansicht aufzunehmen, könnten Sie sich dafür entscheiden, die SpatieCookieConsentCookieConsentMiddleware zu Ihrem Kernel hinzuzufügen:

 // app/Http/Kernel.php

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

    // ...
}

Dadurch wird dem Inhalt Ihrer Antwort direkt vor dem schließenden Body-Tag automatisch cookie-consent::index hinzugefügt.

Beachten

Wir sind keine Anwälte und können keine Rechtsberatung anbieten. Konsultieren Sie Rechtsexperten, welche Regeln für Ihr Projekt gelten.

Änderungsprotokoll

Weitere Informationen zu den letzten Änderungen finden Sie im CHANGELOG.

Testen

composer test 

Mitwirken

Weitere Informationen finden Sie unter BEITRAGEN.

Sicherheit

Wenn Sie sicherheitsrelevante Probleme entdecken, senden Sie bitte eine E-Mail an [email protected], anstatt den Issue-Tracker zu verwenden.

Credits

• Freek Van der Herten
• Willem Van Bockstal
• Alle Mitwirkenden

Lizenz

Die MIT-Lizenz (MIT). Weitere Informationen finden Sie in der Lizenzdatei.