کتابخانه
toastify-js یه کتابخونه سبک جاوااسکریپت خالصه برای نمایش پیام های کوچیک و موقتی گوشه صفحه، که بهشون «توست» می گن. به jQuery یا فریم ورک دیگه ای وابسته نیست و برای خبر دادن چیزهایی مثل «ذخیره شد» یا «ارسال فرم ناموفق بود» توی سایت های وردپرسی و غیر وردپرسی به کار میاد.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۳۶ کیلوبایت· ۶ فایل· انتشار
SHA-256: 42dd6d2bfdd7153d1a702b2b45e468b7c85eec7426bb1e72938397d9a5db396e
وقتی کاربر توی سایتت کاری می کنه، مثلاً یه محصول رو به سبد خرید اضافه می کنه یا فرم تماس رو می فرسته، باید سریع بفهمه چی شد. راه قدیمی alert مرورگره که صفحه رو قفل می کنه و ظاهرش هم با هیچ طراحی ای جور نیست. toastify-js برای همین ساخته شده: یه پیام کوچیک گوشه صفحه نشون می ده و بعد از چند ثانیه خودش جمع می شه. کاربر کارش رو ادامه می ده و لازم نیست صفحه رفرش بشه.
این کتابخونه با جاوااسکریپت خالص نوشته شده و به کتابخونه دیگه ای وابسته نیست. یعنی فقط یه فایل جاوااسکریپت و یه فایل CSS لازم داری. متن پیام، مدت نمایش، جای نمایش (بالا یا پایین، چپ، وسط یا راست)، دکمه بستن، کلیک روی پیام و اجرای یه تابع بعد از بسته شدنش رو می تونی تنظیم کنی. اگه بخوای ظاهر پیام با رنگ و استایل سایتت جور بشه، یا یه کلاس CSS دلخواه بهش بده یا استایلش رو مستقیم عوض کن. مجوزش MIT ـه، پس توی پروژه های شخصی و تجاری مشکلی نداره.
به کجا می خوره؟ نتیجه فرم های ایجکسی، تایید افزودن به سبد خرید توی فروشگاه ووکامرسی، «کپی شد» بعد از کپی کردن یه کد تخفیف، یا پیام ذخیره تنظیمات توی یه پنل سفارشی. اگه قالب یا افزونه خودت رو می نویسی و نمی خوای برای یه پیام ساده یه کتابخونه سنگین بیاری، انتخاب خوبیه. ولی اگه یه سیستم اعلان کامل می خوای، با صف پیام و تاریخچه، سراغ یه راه حل جدا برو. یه نکته مهم هم هست: چون توست خودش محو می شه، اطلاعات حیاتی مثل خطای پرداخت رو فقط توی اون نشون نده و یه پیام ثابت توی صفحه هم بذار.
یه چیز دیگه برای سایت های ایرانی: فایل ها رو از CDN خارجی صدا نزن. روزهایی که اینترنت بین الملل مختل می شه، همون یه خط لینک ممکنه باعث بشه پیام هات اصلاً نیاد. فایل ها رو روی هاست خودت بذار. نسخه های رسمی و بدون تغییر toastify-js توی مخزن داخلی ما هم در دسترسه و می تونی از همون جا برداری. بعدش هم حتماً با متن فارسی و فونت سایتت امتحانش کن، چون ممکنه برای فونت و راست به چپ بودن متن یه استایل کوچیک لازم بشه.
برای استفاده لازم نیست پروژه ات رو زیر و رو کنی. چند قدم ساده کافیه:
آخرش هم یادت نره فایل ها رو از روی هاست خودت لود کنی، تا با محدودیت اینترنت بین الملل هم پیام ها کار کنن.
toastify-js یه کتابخونه جاوااسکریپت برای نمایش پیام های کوچیک و موقتی گوشه صفحه ست. alert کل صفحه رو متوقف می کنه و تا کاربر تایید نزنه نمی شه کاری کرد. توست مزاحم نیست، خودش محو می شه و ظاهرش رو هم می تونی با CSS به سبک سایتت دربیاری.
نه. این کتابخونه با جاوااسکریپت خالص نوشته شده و به jQuery یا فریم ورک خاصی وابسته نیست. فقط فایل جاوااسکریپت و فایل CSS ـش رو توی صفحه بارگذاری می کنی. برای همین توی سایت های وردپرسی هم معمولاً بدون دردسر کنار بقیه اسکریپت ها کار می کنه.
فایل ها رو توی پوشه قالب یا افزونه ات بذار و با wp_enqueue_style و wp_enqueue_script بارگذاری کن. بعدش کد صدا زدن توست رو توی اسکریپت خودت بنویس، مثلاً بعد از موفق بودن یه درخواست ایجکس. به شکل افزونه از پیشخوان نصب نمی شه.
متن فارسی رو نمایش می ده، ولی ظاهر دقیق پیام به فونت و راست به چپ بودن صفحه ات بستگی داره. بعد از نصب یه تست بگیر و اگه لازم بود، با className و چند خط CSS فونت، چینش متن و فاصله ها رو درست کن.
بله. toastify-js با مجوز MIT منتشر شده و این مجوز استفاده تجاری، تغییر و توزیع رو اجازه می ده. پس برای سایت شرکتی، فروشگاه یا قالب و افزونه ای که می فروشی مشکلی نداری. فقط اطلاعیه مجوز و حق نشر اصلی رو توی فایل هایی که دوباره منتشر می کنی نگه دار.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.