이 패키지는 귀하의 사이트에 간단하고 사용자 정의 가능한 쿠키 동의 메시지를 추가합니다. 사이트가 로드되면 배너가 나타나고 사용자가 쿠키에 동의할 수 있습니다. 동의하면 배너가 숨겨지고 숨겨진 상태로 유지됩니다.
이 패키지에 없는 기능:
Laravel의 고급 쿠키 동의 옵션을 보려면 다음 대안을 고려하세요.
우리는 동급 최고의 오픈 소스 패키지를 만드는 데 많은 리소스를 투자합니다. 유료 제품 중 하나를 구매하여 우리를 지원할 수 있습니다.
귀하가 사용하고 있는 당사 패키지를 언급하면서 귀하의 고향에서 엽서를 보내주셔서 진심으로 감사드립니다. 연락처 페이지에서 주소를 확인하실 수 있습니다. 우리는 수신된 모든 엽서를 가상 엽서 월에 게시합니다.
작곡가를 통해 패키지를 설치할 수 있습니다.
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 ,
];
쿠키 도메인은 config/session.php의 'domain' 키로 설정됩니다. .env에 SESSION_DOMAIN에 대한 값을 추가했는지 확인하세요. 'localhost:3000'과 같은 URL에 포트가 있는 도메인을 사용하는 경우 이 패키지는 그렇게 할 때까지 작동하지 않습니다.
대화 상자를 표시하려면 템플릿에 다음 보기를 포함하기만 하면 됩니다.
//in your blade template
@include ( ' cookie-consent::index ' )
그러면 스타일이 지정되면 이와 매우 유사하게 보이는 다음 대화 상자가 렌더링됩니다.
이 패키지에서 제공하는 기본 스타일은 TailwindCSS v2를 사용하여 페이지 하단에 플로팅 배너를 제공합니다.
사용자가 "쿠키 허용"을 클릭하면 laravel_cookie_consent
쿠키가 설정되고 대화 상자가 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
자세한 내용은 CONTRIBUTING을 참조하세요.
보안 관련 문제를 발견한 경우 문제 추적기를 사용하는 대신 [email protected]로 이메일을 보내주세요.
MIT 라이센스(MIT). 자세한 내용은 라이센스 파일을 참조하십시오.