افزونه تقویم شمسی باتبل سی ام اس | مبدل تاریخ آریاپورتال
راهکار کامل تقویم فارسی برای سیستم مدیریت محتوای Botble
شمسی ساز آریاپورتال | تاریخ شمسی کامل برای باتبل (Botble CMS)
شمسی ساز آریاپورتال همهی تاریخ های پنل مدیریت، وبلاگ، فروشگاه و حساب کاربری مشتری را شمسی می کند. تقویم شمسی را هم جایگزین تقویم میلادی فرم ها می کند و فاکتور PDF را با فونت فارسی خوانا می سازد. نصب آن بدون ویرایش هسته یا قالب انجام می شود و مقدار ذخیره شده در دیتابیس همیشه میلادی می ماند.
چرا این افزونه؟
باتبل به صورت پیش فرض همه چیز را میلادی نشان می دهد. برای یک سایت فارسی زبان این یعنی:
- تاریخ نوشته ها و سفارش ها میلادی است.
- تقویم فرم ها، مثل تاریخ شروع و پایان حراج یا تاریخ تولد مشتری، میلادی است.
- در فاکتور PDF متن فارسی به هم ریخته و ناخوانا چاپ می شود.
این افزونه همهی این موارد را یک‌جا درست می‌کند.
امکانات
تاریخ شمسی در همه جا
- پنل مدیریت: جدول ها، ستون «تاریخ ایجاد»، لیست نوشته ها، سفارش ها و محصولات.
- سایت: وبلاگ، فروشگاه و حساب کاربری مشتری.
- تاریخ هایی که فقط در مرورگر ساخته می شوند، مثل نمودارها و پیش نمایش سئو، هم شمسی می شوند (قابل خاموش کردن).
- مقدار ذخیره شده در دیتابیس، فرم ها و API میلادی می ماند. به داده های شما دست نمی زنیم و افزونه های دیگر هم خراب نمی شوند.
سه حالت نمایش، جدا برای پنل و سایت
- فقط شمسی
- میلادی و شمسی کنار هم، مثلاً در لیست نوشته ها
- فقط میلادی (بدون تغییر)
مثلاً می توانید پنل را «هر دو» و سایت را «فقط شمسی» بگذارید.
سبک نمایش دلخواه
از تنظیمات یکی از سبک های آماده را انتخاب کنید. نمونه‌ی هر سبک با تاریخ امروز نشان داده می‌شود:
۱۳ مهر ۱۴۰۵دوشنبه ۱۳ مهر ۱۴۰۵۱۴۰۵/۰۷/۱۳۰۵/۷/۱۳۱۴۰۵-۰۷-۱۳۱۳/۰۷/۱۴۰۵۱۴۰۵.۰۷.۱۳
یا قالب دلخواه خودتان را با حروف شبیه تابع date() در PHP بنویسید، مثل l j F Y. ساعت، اگر در تاریخ باشد، حفظ می شود. انتخاب ارقام فارسی (۱۲۳) یا انگلیسی (123) هم در تنظیمات هست.
تقویم شمسی در فرم ها
- تقویم میلادی در فرم های پنل مدیریت، مثل تاریخ شروع و پایان حراج محصول، با تقویم شمسی جایگزین می شود.
- در سایت هم فعال است، مثلاً برای «تاریخ تولد» در تنظیمات حساب کاربری مشتری.
- تاریخی که انتخاب می شود با همان فرمتی که باتبل انتظار دارد (میلادی) ذخیره می شود.
فاکتور PDF فارسی
- فاکتور فروشگاه با موتور mPDF و فونت وزیرمتن ساخته می شود، پس متن فارسی متصل و خوانا است.
- تاریخ فاکتور شمسی است.
- گزینه‌ی راستچین کردن فاکتور جهت صفحه را راست به چپ می کند. اطلاعات فاکتور، مشتری، جدول محصولات و مجموع ها همه راستچین می شوند.
- نام، آدرس و توضیحاتی که مشتری وارد می کند قبل از ورود به PDF پاک‌سازی (escape) می شود تا کسی نتواند کد مخرب داخل فاکتور بگذارد.
- برای کار با فاکتور باید افزونهی فروشگاه (Ecommerce) باتبل نصب باشد. بقیه‌ی امکانات بدون آن هم کار می کنند.
فونت فارسی، همراه افزونه یا فونت خودتان
- وزیرمتن همراه افزونه است (لایسنس OFL) و نیازی به دانلود جداگانه ندارد.
- محدودهی اعمال فونت قابل انتخاب است:
- فقط صفحه های فاکتور
- فقط سایت (فرانت)
- کل پنل مدیریت و سایت
- غیرفعال
- در حالت «سایت»، فونت افزونه روی فونت قالب اولویت دارد.
- آیکون فونت ها (Font Awesome، Tabler و مشابه) دست نخورده می مانند و آیکون ها خراب نمی شوند.
- فونت دلخواه: برای هر وزن از ۱۰۰ تا ۹۰۰ یک فایل
woff2،woff،ttfیاotf(حداکثر ۵ مگابایت) آپلود کنید و نام فونت را بنویسید. فایل ها بررسی اعتبار می شوند و وزن آپلود نشده را مرورگر از نزدیک ترین وزن می سازد. فونت فاکتور PDF همچنان وزیرمتن است.
سبک و سریع
- بدون پکیج خارجی (Composer) برای تاریخ شمسی. الگوریتم تبدیل داخل خود افزونه است.
- خروجی افزونه در سورس صفحه فقط یک تگ
scriptو در صورت فعال بودن فونت یکlinkاست، حدود ۲۵۰ بایت. - فایل های جاوا اسکریپت و CSS فشرده اند و یک سال در مرورگر کش می شوند.
- استایل تقویم فقط هنگام اولین باز شدن تقویم بارگذاری می شود.
امنیت
- فایل های فونت و دارایی ها فقط با الگوهای مجاز و نام تصادفی ارائه می شوند.
- آپلود و حذف فونت فقط برای مدیرانی است که به تنظیمات افزونه دسترسی دارند.
تنظیمات افزونه
مسیر: تنظیمات ← سایر ← شمسی ساز آریاپورتال
| گزینه | توضیح |
|---|---|
| نمایش تاریخ در پنل مدیریت | فقط شمسی، هر دو، یا فقط میلادی |
| نمایش تاریخ در سایت | فقط شمسی، هر دو، یا فقط میلادی |
| نحوه‌ی نمایش تاریخ شمسی | سبک های آماده یا قالب دلخواه |
| ارقام فارسی | ۱۴۰۵ یا 1405 |
| تقویم شمسی در فرم ها | جایگزینی تقویم های میلادی |
| تبدیل تاریخ های جاوا اسکریپتی | نمودارها، پیش نمایش سئو و ... |
| فاکتور PDF فارسی | موتور mPDF و فونت وزیرمتن |
| راست چین کردن فاکتور | فاکتور راست به چپ و راست چین |
| محدودهی فونت | فاکتورها / سایت / همه / غیرفعال |
| نوع فونت | وزیرمتن یا فونت دلخواه (آپلود) |
نصب
۱. پوشه‌ی arya-jalali را در مسیر platform/plugins/ کپی کنید. ۲. از بخش افزونه ها در پنل مدیریت، افزونه را فعال کنید. ۳. دستور php artisan cache:clear را اجرا کنید. ۴. تنظیمات را از مسیر بالا مطابق نیاز خودتان انجام دهید.
نیازمندی: باتبل (Botble CMS) نسخه‌ی ۷.۴.۰ یا بالاتر.
پرسش های پرتکرار
آیا داده های دیتابیس تغییر می کنند؟
خیر. همهی تاریخ ها میلادی ذخیره می شوند و تبدیل فقط هنگام نمایش انجام می شود. با غیرفعال کردن افزونه، همه چیز به حالت اول برمیگردد.
با افزونه ها و قالب های دیگر سازگار است؟
تبدیل فقط در جاهایی انجام می شود که تاریخ نمایش داده می شود. تاریخ های فیلتر، API، ایمیل و مقدار فرم دست نخورده می مانند، پس افزونه های دیگر کار خودشان را ادامه می دهند.
آیا بدون افزونهی فروشگاه کار می‌کند؟
بله. تاریخ شمسی، تقویم و فونت بدون آن هم کار می کنند. بخش فاکتور فقط با افزونهی فروشگاه معنا دارد.
می توانم فقط تاریخ میلادی را در پنل نگه دارم و سایت را شمسی کنم؟
بله. حالت نمایش پنل و سایت جدا از هم تنظیم می شود.
فونت قالب من عوض می شود؟
فقط اگر محدودهی فونت را روی «سایت» یا «کل پنل و سایت» بگذارید. پیش فرض فقط روی صفحه های فاکتور اعمال می شود.
