laravel cookie consent
3.3.2
このパッケージは、シンプルでカスタマイズ可能な Cookie 同意メッセージをサイトに追加します。サイトが読み込まれると、バナーが表示され、ユーザーは Cookie に同意することができます。同意が得られると、バナーは非表示になり、非表示のままになります。
このパッケージに含まれないもの:
Laravel のより高度な Cookie 同意オプションについては、次の代替案を検討してください。
私たちはクラス最高のオープンソース パッケージの作成に多くのリソースを投資しています。有料製品のいずれかを購入することで、私たちをサポートできます。
当社のどのパッケージを使用しているかについて、故郷から葉書を送っていただき、誠にありがとうございます。当社の住所は、お問い合わせページに記載されています。受け取ったすべてのポストカードをバーチャル ポストカード ウォールに公開します。
パッケージは、composer 経由でインストールできます。
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 の「domain」キーによって設定されます。必ず .env に SESSION_DOMAIN の値を追加してください。 「localhost:3000」などの URL にポートが含まれるドメインを使用している場合、このパッケージはそうするまで機能しません。
ダイアログを表示するには、このビューをテンプレートに含めるだけです。
//in your blade template
@include ( ' cookie-consent::index ' )これにより、スタイルを設定すると、このダイアログとよく似た次のダイアログがレンダリングされます。
このパッケージで提供されるデフォルトのスタイルは、TailwindCSS v2 を使用して、ページの下部にフローティング バナーを提供します。
ユーザーが「Cookie を許可」をクリックすると、 laravel_cookie_consent Cookie が設定され、ダイアログが 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,
];
// ...
}これにより、応答のコンテンツの body 終了タグの直前にcookie-consent::indexが自動的に追加されます。
私たちは弁護士ではないため、法的なアドバイスを提供することはできません。あなたのプロジェクトにどのようなルールが適用されるのか法律専門家に相談してください。
最近の変更点の詳細については、CHANGELOG を参照してください。
composer test 詳細については、「貢献」を参照してください。
セキュリティ関連の問題を発見した場合は、問題トラッカーを使用する代わりに、[email protected] に電子メールを送信してください。
MIT ライセンス (MIT)。詳細については、ライセンス ファイルを参照してください。
