کتابخانه
@alma/widgets یه بسته npm با مجوز MIT برای نمایش اطلاعات سرویس Alma توی صفحه های وبه. اگه فروشگاه یا پروژه ات با Alma کار می کنه، با این ویجت ها لازم نیست رابط نمایش رو از صفر بسازی و می تونی اطلاعات پرداخت رو راحت به بازدیدکننده نشون بدی.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۷۳۳ کیلوبایت· ۷ فایل· انتشار
SHA-256: aa8547c390135803e4b430db4bfbfa726f450efc3360cf7665efd9df33dd2e8a
@alma/widgets یه کتابخونه جاوااسکریپته، همراه با استایل، برای نمایش اطلاعات Alma توی صفحه های وب. Alma یه سرویس پرداخت اروپاییه که پرداخت اقساطی و چندمرحله ای ارائه می ده. توضیح رسمی بسته هم همین رو می گه: ویجت هایی برای اینکه اطلاعات Alma رو راحت نمایش بدی.
مشکلی که حل می کنه ساده است. اگه فروشگاهت با Alma کار می کنه، لازم نیست خودت از صفر بخش نمایش گزینه های پرداخت رو بنویسی و با ظاهر سایت هماهنگش کنی. کاربرد رایجش اینه که کنار قیمت محصول یا توی صفحه سبد خرید، اطلاعات پرداخت با Alma رو نشون بدی. اینکه دقیقا چه ویجت هایی با چه تنظیم هایی توی هر نسخه هست رو از مستندات خود بسته چک کن، چون ممکنه بین نسخه ها فرق کنه.
یه نکته مهم برای سایت های ایرانی: Alma برای کسب و کارهای اروپایی ساخته شده و به درگاه های پرداخت ایرانی ربطی نداره. اگه سایتت ایرانیه و فروشت داخل ایران با درگاه ایرانی انجام می شه، این بسته به دردت نمی خوره و فقط کد اضافه به صفحه می ده. جاهایی که معنی داره: پروژه ای که برای یه مشتری اروپایی می سازی، یا فروشگاهی که حساب فروشنده فعال روی Alma داره. بدون حساب Alma، ویجت چیزی برای نمایش نداره.
موقع انتخاب و استفاده چند چیز رو حواست باشه. اول اینکه این بسته افزونه وردپرس نیست و یه کتابخونه جاوااسکریپته. پس روی وردپرس باید خودت داخل قالب یا یه افزونه کوچک به صفحه اضافه اش کنی. دوم اینکه استایل ویجت ممکنه با CSS قالبت تداخل کنه، مخصوصا اگه قالبت راست به چپه. حتما توی مرورگر و روی موبایل تست کن. سوم اینکه اگه Alma محیط آزمایشی در اختیارت می ذاره، اول با اون کار کن و بعد برو سراغ حالت واقعی.
نسخه های رسمی و بدون تغییر @alma/widgets توی مخزن داخلی ما هم هست. این برای روزهایی که دسترسی به npm کند یا قطعه به درد می خوره. فقط یادت باشه با گرفتن فایل ها از مخزن، خود کتابخونه رو روی هاستت داری و ویجت برای نمایش اطلاعات هنوز به سرویس Alma هم نیاز داره.
راه استفاده به این بستگی داره که پروژه ات چطور ساخته شده. این قدم های کلی برای بیشتر سایت ها جواب می ده و کد آماده اش پایین همین صفحه هست.
توی وردپرس بهتره فایل ها رو با wp_enqueue_script و wp_enqueue_style از قالب فرزند یا یه افزونه کوچک اضافه کنی و فقط روی صفحه هایی که لازم داری بارگذاری کنی. این جوری بقیه صفحه های سایت بی خودی سنگین نمی شن.
معمولا نه. این ویجت ها اطلاعات سرویس Alma رو نشون می دن و Alma برای کسب و کارهای اروپایی ساخته شده. درگاه ایرانی هیچ ارتباطی با Alma نداره و این ویجت جاش رو نمی گیره. اگه فروشت داخل ایران و با درگاه ایرانیه، نیازی بهش نداری. برای پروژه هایی معنی داره که حساب فروشنده Alma دارن یا مشتری اروپایی.
عملا آره. ویجت قراره اطلاعات Alma رو نمایش بده و برای این کار به اطلاعات حساب فروشنده نیاز داره. بدون حساب، فقط یه بسته جاوااسکریپت داری که چیزی برای نشون دادن نداره. جزئیات دقیق تنظیم ها رو توی مستندات خود بسته ببین، چون ممکنه بین نسخه ها فرق کنه.
آره، چون یه کتابخونه جاوااسکریپته و به وردپرس وابسته نیست. ولی افزونه آماده نیست. باید خودت از طریق قالب یا یه افزونه کوچک فایل ها رو به صفحه اضافه کنی و یه المنت برای نمایش ویجت بذاری. فایل ها رو هم فقط توی صفحه هایی که لازم دارن بارگذاری کن.
فایل های بسته رو می تونی از مخزن ما بگیری و روی هاستت بذاری، پس بارگذاری خود کتابخونه مشکلی نداره. ولی ویجت برای نمایش اطلاعات به سرویس Alma هم وصل می شه. برای همین نمی شه گفت با قطعی بین الملل کامل کار می کنه.
یعنی می تونی بسته رو توی پروژه شخصی یا تجاری استفاده کنی و تغییرش بدی. فقط باید اعلان کپی رایت و متن مجوز رو همراهش نگه داری. این مجوز فقط مربوط به خود کده و استفاده از سرویس Alma شرایط جدایی داره که باید اونا رو هم بخونی.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.