پرش به محتوا

کتابخانه

دانلود cookieconsent و نشانی CDN ایرانی

cookieconsent یه کتابخانه سبک جاوااسکریپت و CSS از Osano برای نمایش بنر رضایت کاربر از کوکی هاست. با چند خط تنظیم، پیام، رنگ، جای بنر و دکمه ها رو عوض می کنی. به فریم ورک خاصی وابسته نیست و روی هر سایتی، از جمله وردپرس، کار می کنه.

نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.

آخرین نسخه
۳.۱.۱
نسخه‌ها در مخزن
۱
مجوز
MIT
سازنده
Osano, Inc., a Public Benefit Corporation
آخرین بررسی
آخرین به‌روزرسانی
توضیحات

آخرین نسخه

آخرین نسخه ۳.۱.۱ آخرین

۹۳ کیلوبایت· ۱۳ فایل· انتشار

دانلود
نشانی مستقیم فایل اصلی https://mirror.wbweb.ir/npm/cookieconsent@3.1.1/build/cookieconsent.min.js
کد آماده با SRI <script src="https://mirror.wbweb.ir/npm/cookieconsent@3.1.1/build/cookieconsent.min.js" integrity="sha256-5VhCqFam2Cn+yjw61zbBNrbHVJ6SRydPeKopYlngbiQ=" crossorigin="anonymous"></script>

SHA-256: e55842a856a6d829feca3c3ad736c136b6c7549e9247274f78aa296259e06e24

درباره cookieconsent (کوکی کانسنت)

اگه سایتت گوگل آنالیتیکس، پیکسل تبلیغاتی، ویجت چت یا هر سرویس دیگه ای رو داره که کوکی می ذاره، خیلی وقت ها باید به بازدیدکننده خبر بدی و نظرش رو بپرسی. cookieconsent برای همین ساخته شده. یه بنر کوچیکه که بالا، پایین یا گوشه صفحه نشون داده می شه، پیام تو رو نمایش می ده و انتخاب کاربر رو توی یه کوکی نگه می داره، تا دفعه بعد دوباره مزاحمش نشی. سازنده اش Osano هست و با مجوز MIT منتشر شده، پس توی پروژه های شخصی و تجاری آزادانه می تونی ازش استفاده کنی.

ظاهر و رفتار بنر با تنظیمات عوض می شه. پالت رنگ، قالب های آماده مثل block و edgeless و classic، موقعیت بنر، متن پیام و عنوان دکمه ها قابل تغییره. رفتارش رو هم خودت انتخاب می کنی: فقط اطلاع بدی (info)، از کاربر موافقت بگیری (opt-in) یا بذاری رد کنه (opt-out). برای لندینگ، سایت شرکتی، وبلاگ یا فروشگاه کوچیکی که یه بنر ساده می خواد، همین بسه و لازم نیست افزونه سنگین نصب کنی.

یه نکته رو زیاد نادیده می گیرن: این کتابخانه خودش جلوی کوکی ها و اسکریپت های دیگه سایت رو نمی گیره. فقط بنر رو نشون می ده و جواب کاربر رو ثبت می کنه. اگه می خوای تا قبل از موافقت کاربر، آنالیتیکس یا پیکسل لود نشه، باید اون اسکریپت ها رو خودت بر اساس جواب کاربر اجرا کنی. کافی بودن متن بنر و سیاست حریم خصوصی از نظر قانونی هم به مخاطب و کشور هدفت بستگی داره. اگه کاربر اروپایی داری، بهتره یه بار با یه متخصص حقوقی بررسیش کنی.

کجا مناسب نیست؟ اگه مدیریت کامل رضایت با دسته بندی دقیق کوکی ها، ثبت سابقه موافقت و اتصال خودکار به ابزارهای تبلیغاتی می خوای، یه پلتفرم مدیریت رضایت کامل یا افزونه اختصاصی انتخاب بهتریه. یه نکته هم برای سایت های ایرانی: اگه فایل ها رو از CDN خارجی صدا بزنی، موقع اختلال اینترنت بین الملل بنر بالا نمیاد. فایل ها رو روی هاست خودت بذار. نسخه های رسمی و بدون تغییر cookieconsent توی مخزن داخلی ما هم هست و بدون اینترنت بین الملل می تونی دانلودشون کنی.

راهنمای استفاده

استفاده از cookieconsent چهار قدم بیشتر نیست:

  • فایل های CSS و JS رو از همین صفحه بگیر و روی هاست خودت، کنار بقیه فایل های قالب یا پروژه، بذار.
  • فایل CSS رو داخل head و فایل JS رو آخر صفحه، قبل از بسته شدن body، اضافه کن.
  • کد راه اندازی آماده پایین همین صفحه رو کپی کن و بعد از فایل JS بذار. توی همون کد می تونی message، dismiss، link، palette، position، theme و type رو عوض کنی.
  • متن بنر رو فارسی کن و link رو به صفحه واقعی «سیاست حریم خصوصی» سایتت وصل کن.

توی وردپرس دو راه داری. یا فایل ها رو با wp_enqueue_style و wp_enqueue_script توی functions.php قالب فرزند اضافه می کنی، یا اگه کدنویسی دوست نداری، از یه افزونه درج کد در هدر و فوتر کمک می گیری. فایل های قالب اصلی رو مستقیم ویرایش نکن، چون با اولین به روزرسانی پاک می شن.

آخرش سایت رو توی یه پنجره ناشناس باز کن و ببین بنر میاد یا نه. قبولش کن، صفحه رو رفرش کن و مطمئن شو دوباره ظاهر نمی شه. برای تست دوباره، کوکی سایت رو از مرورگر پاک کن.

همه نسخه‌ها (۱)

نسخه‌های ۳.x ۱ نسخه
  • ۳.۱.۱ آخرین نسخه ۹۳ کیلوبایت·
    دانلودنسخه 3.1.1
    نشانی مستقیم فایل اصلی 3.1.1 https://mirror.wbweb.ir/npm/cookieconsent@3.1.1/build/cookieconsent.min.js

پرسش‌های رایج

  • یه کتابخانه جاوااسکریپت و CSS از Osano که بنر اعلام کوکی رو روی سایت نشون می ده. کاربر قبول یا رد می کنه، انتخابش توی یه کوکی ذخیره می شه و بنر دفعه بعد دیگه نمایش داده نمی شه. ظاهر، متن و موقعیت بنر هم با تنظیمات عوض می شه.

  • نه. این کتابخانه فقط بنر رو نشون می ده و جواب کاربر رو ثبت می کنه. اگه می خوای آنالیتیکس یا پیکسل قبل از موافقت کاربر اجرا نشه، باید خودت اسکریپت ها رو بر اساس همون جواب، شرطی لود کنی.

  • آره. فایل های CSS و JS رو روی هاست می ذاری، با wp_enqueue_style و wp_enqueue_script توی قالب فرزند اضافه می کنی و کد راه اندازی رو بعدش می ذاری. اگه کدنویسی نمی خوای، یه افزونه درج کد در هدر و فوتر هم همین کار رو انجام می ده.

  • آره. مجوز cookieconsent از نوع MIT هست و استفاده و تغییرش توی پروژه های شخصی و تجاری آزاده. فقط باید اعلان مجوز رو توی فایل ها دست نخورده نگه داری. درست بودن متن بنر و تطبیقش با قوانین هم مسئولیت خود سایته.

  • اگه فایل ها رو از CDN خارجی صدا بزنی، ممکنه نه. اما اگه فایل ها روی هاست خودت باشن، بنر بدون مشکل بالا میاد، چون به سرویس بیرونی وابسته نیست. برای همین پیشنهاد می کنیم فایل ها رو از مخزن بگیری و محلی استفاده کنی.

چیزی که لازم دارید اینجا نیست؟

نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.