laravel cookie consent تنزيل - laravel cookie consent تنزيل كود المصدر

laravel cookie consent

فئات أخرى

3.3.2

تنزيل

رسالة موافقة بسيطة وقابلة للتخصيص لملفات تعريف الارتباط لـ Laravel

تضيف هذه الحزمة رسالة موافقة بسيطة وقابلة للتخصيص لملف تعريف الارتباط إلى موقعك. عند تحميل الموقع، يظهر الشعار ويتيح للمستخدمين الموافقة على ملفات تعريف الارتباط. بمجرد منح الموافقة، تختفي اللافتة وتظل مخفية.

ما لا تفعله هذه الحزمة:

قم بتضمين خيار "رفض" جميع ملفات تعريف الارتباط، وهو ما قد يكون مطلوبًا.
قم بحظر أدوات التتبع وملفات تعريف الارتباط قبل الموافقة. تحتاج إلى التعامل مع هذا بنفسك.
قم بتضمين خيارات لفئات الموافقة المختلفة مثل "ضرورية" أو "تسويقية".

للحصول على خيارات أكثر تقدمًا للموافقة على ملفات تعريف الارتباط في Laravel، فكر في هذه البدائل.

موافقة على ملف تعريف الارتباط Whitecube/laravel
statikbe/laravel-cookie-consent

ادعمنا

نحن نستثمر الكثير من الموارد في إنشاء أفضل الحزم مفتوحة المصدر في فئتها. يمكنك دعمنا عن طريق شراء أحد منتجاتنا المدفوعة.

نحن نقدر بشدة إرسالك لنا بطاقة بريدية من مسقط رأسك، مع ذكر الحزمة (الحزم) التي تستخدمها. ستجد عنواننا على صفحة الاتصال لدينا. ننشر جميع البطاقات البريدية المستلمة على جدار البطاقات البريدية الافتراضية لدينا.

تثبيت

يمكنك تثبيت الحزمة عبر الملحن:

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، تأكد من إضافة قيمة في .env الخاص بك لـ SESSION_DOMAIN. إذا كنت تستخدم نطاقًا به منفذ في عنوان url مثل 'localhost:3000'، فلن تعمل هذه الحزمة حتى تقوم بذلك.

الاستخدام

لعرض مربع الحوار، كل ما عليك فعله هو تضمين طريقة العرض هذه في القالب الخاص بك:

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

    // ...
}

سيؤدي هذا تلقائيًا إلى إضافة cookie-consent::index إلى محتوى استجابتك مباشرةً قبل علامة الإغلاق الأساسية.