Themefour Shamsi Kit

تاریخ‌های وردپرس را به تقویم جلالی (شمسی) با ارقام فارسی و قالب‌بندی صحیح تاریخ فارسی تبدیل کنید.

توضیحات

کیت شمسی تم فور تاریخ‌هایی را که وردپرس نمایش می‌دهد به تقویم جلالی (شمسی) تبدیل می‌کند. تاریخ نوشته‌ها، برگه‌ها، بایگانی‌ها، فهرست نوشته‌ها در پیشخوان، پنل انتشار نوشته و دیدگاه‌ها همگی با تقویم شمسی نمایش داده می‌شوند؛ در حالی که تاریخ‌هایی که وردپرس در داخل سیستم ذخیره و استفاده می‌کند، کاملاً بدون تغییر باقی می‌مانند.

دقت تبدیل تاریخ

تبدیل تاریخ با استفاده از یک الگوریتم دقیق مبتنی بر جدول سال‌ها انجام می‌شود که از همان خانواده الگوریتم‌های مورد استفاده در پیاده‌سازی‌های مرجع تقویم جلالی است. سال‌های کبیسه، از جمله سال‌هایی که اسفند ۳۰ روزه است، به‌درستی محاسبه می‌شوند. این تبدیل بر اساس چرخه تقریبی ۳۳ ساله انجام نمی‌شود.

حفظ تاریخ‌های قابل پردازش توسط ماشین به صورت میلادی

این موضوع تفاوت مهمی است که بسیاری از افزونه‌های تاریخ در نظر نمی‌گیرند. قالب‌هایی مانند Y-m-d، زمان‌سنجی ISO 8601 یا تاریخ‌های RFC برای خواندن توسط انسان طراحی نشده‌اند؛ بلکه داده‌هایی هستند که مرورگرها، فیدخوان‌ها، موتورهای جستجو و سایر نرم‌افزارها آن‌ها را پردازش می‌کنند.

تبدیل این تاریخ‌های قابل پردازش توسط ماشین می‌تواند ویژگی‌هایی مانند ویژگی‌های <time datetime="">، داده‌های ساختاریافته schema.org، فیدهای RSS و نقشه‌های سایت را دچار مشکل کند. کیت شمسی تم فور قالب‌های قابل پردازش توسط ماشین را تشخیص می‌دهد و آن‌ها را بدون تغییر به صورت میلادی نگه می‌دارد و فقط قالب‌هایی را تبدیل می‌کند که برای نمایش به کاربران در نظر گرفته شده‌اند.

ترتیب صحیح کلمات در تاریخ فارسی

اگر قالب یا افزونه دیگری از قالب تاریخ انگلیسی مانند F j, Y استفاده کند، کیت شمسی تم فور روز را قبل از ماه قرار می‌دهد تا تاریخ به شکل «۵ مرداد ۱۴۰۵» نمایش داده شود، نه «مرداد ۵, ۱۴۰۵».

این رفتار در date_i18n()، wp_date()، get_the_date()، get_the_modified_date() و تاریخ دیدگاه‌ها به‌صورت یکسان اعمال می‌شود تا یک زمان مشخص در یک صفحه با قالب‌های متفاوت نمایش داده نشود.

امکانات

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

امکانات نسخه پرو

نسخه پرو امکانات گسترده‌تری برای شمسی‌سازی وردپرس، ووکامرس، فرم‌سازها، افزونه‌های شخص ثالث و ساخت ابزارهای تقویم ارائه می‌دهد.

شمسی‌سازی وردپرس

• شمسی‌سازی تاریخ نوشته‌ها و برگه‌ها.
• شمسی‌سازی تاریخ دیدگاه‌ها.
• شمسی‌سازی تاریخ‌های پیشخوان و بخش‌های مختلف مدیریت وردپرس.
• شمسی‌سازی ویرایشگر کلاسیک وردپرس.
• شمسی‌سازی ویرایشگر بلوکی (Gutenberg).
• شمسی‌سازی پنل انتشار و زمان‌بندی نوشته‌ها.
• نمایش تاریخ شمسی در پنل انتشار.
• نمایش ساعت زنده در پیشخوان وردپرس.
• پشتیبانی از اعداد فارسی.
• نمایش صحیح تاریخ فارسی.
• امکان شخصی‌سازی قالب نمایش تاریخ.
• امکان شخصی‌سازی قالب نمایش تاریخ در پنل مدیریت.
• نمایش تاریخ میلادی به‌صورت Tooltip.
• امکان انتخاب وزن فونت پیشخوان در پنل مدیریت.
• دارای بلاک اختصاصی تقویم شمسی برای Gutenberg.
• دارای ویجت کلاسیک تقویم شمسی.

شمسی‌سازی ووکامرس

• شمسی‌سازی سفارش‌های ووکامرس.
• شمسی‌سازی تاریخ محصولات ووکامرس.
• شمسی‌سازی کوپن‌های ووکامرس.
• شمسی‌سازی قیمت‌های فروش ویژه.
• شمسی‌سازی تاریخ شروع و پایان تخفیف محصولات.
• شمسی‌سازی بخش‌های مختلف مدیریت ووکامرس.
• پشتیبانی از تقویم شمسی در Checkout، حساب کاربری و Order Review ووکامرس.
• امکان تعیین روزها و تاریخ‌های غیرفعال.
• ذخیره تاریخ شمسی در سفارش‌های ووکامرس.
• یکپارچه‌سازی کامل با WooCommerce.

فرم‌سازها و فیلدهای تاریخ

• پشتیبانی از فیلد تاریخ شمسی در Contact Form 7.
• پشتیبانی از فیلد تاریخ شمسی در WPForms.
• پشتیبانی از فیلد تاریخ شمسی در MetForm.
• پشتیبانی از فیلد تاریخ شمسی در JetFormBuilder.
• پشتیبانی از فیلد تاریخ شمسی در QuForm.
• اعتبارسنجی سمت سرور برای فیلدهای تاریخ.
• امکان تعیین حداقل و حداکثر تاریخ.
• پشتیبانی از تاریخ امروز (Today).
• امکان انتخاب بازه زمانی.
• پشتیبانی از منطق شرطی (Conditional Logic) در فرم‌سازها.
• پشتیبانی از Save Progress.
• سازگاری کامل با نسخه‌های Pro فرم‌سازهای یکپارچه‌شده.
• حفظ ساختار استاندارد ذخیره‌سازی تاریخ در افزونه‌های یکپارچه‌شده.

یکپارچه‌سازی با افزونه‌ها

• تبدیل فیلدهای تاریخ ACF به تقویم شمسی.
• تبدیل Date Picker افزونه Checkout Field Editor به تقویم شمسی.
• پشتیبانی از تقویم شمسی در YITH Checkout Manager.
• یکپارچه‌سازی کامل با Advanced Custom Fields (ACF).
• یکپارچه‌سازی کامل با Checkout Field Editor for WooCommerce.
• یکپارچه‌سازی کامل با YITH Checkout Manager.
• یکپارچه‌سازی کامل با Contact Form 7.
• یکپارچه‌سازی کامل با WPForms.
• یکپارچه‌سازی کامل با MetForm.
• یکپارچه‌سازی کامل با JetFormBuilder.
• یکپارچه‌سازی کامل با QuForm.

Easy Digital Downloads

• شمسی‌سازی تاریخ شروع و پایان تخفیف‌ها در Easy Digital Downloads (EDD).
• حفظ ساختار استاندارد ذخیره‌سازی تاریخ در EDD.
• یکپارچه‌سازی کامل با Easy Digital Downloads (EDD).

Dokan

• شمسی‌سازی پنل مدیریت فروشندگان Dokan.
• شمسی‌سازی تاریخ تنظیم تخفیف محصولات در پنل فروشندگان Dokan.
• شمسی‌سازی تاریخ انقضای کوپن‌ها در Dokan.
• یکپارچه‌سازی کامل با Dokan.

JetEngine و JetSmartFilters

• تبدیل فیلدهای Date در JetEngine به تقویم شمسی.
• پشتیبانی از Query Builder در JetEngine.
• پشتیبانی از Dynamic Field در JetEngine.
• پشتیبانی از REST API در JetEngine.
• پشتیبانی از Date Range در JetSmartFilters.
• پشتیبانی از Date Period در JetSmartFilters.
• نمایش هفته، ماه و سال شمسی در JetSmartFilters.
• پشتیبانی از انتخاب بازه تاریخ شمسی.
• پشتیبانی از حالت Readonly.
• یکپارچه‌سازی کامل با JetEngine.
• یکپارچه‌سازی کامل با JetSmartFilters.

سازندگان تقویم و ابزارها

• دارای سازنده تقویم رومیزی.
• دارای سازنده تقویم دیواری.
• دارای سازنده کارت امروز.
• دارای سازنده ساعت و تاریخ.
• دارای سازنده تقویم فصل‌ها.
• دارای سازنده تقویم باحساب.
• دارای پیش‌نمایش زنده ابزارها.
• تولید خودکار شورت‌کد.
• کپی خودکار شورت‌کد.
• امکان شخصی‌سازی رنگ‌ها.
• امکان انتخاب قالب‌های متنوع.
• امکان نمایش ساعت.
• امکان نمایش تاریخ میلادی.
• امکان نمایش تاریخ قمری.
• امکان نمایش اعداد فارسی.
• امکان تغییر گوشه‌های گرد (Border Radius) تقویم‌ها.
• امکان شخصی‌سازی کامل ظاهر تقویم‌ها و ساعت‌ها.

شورت‌کدها

• دارای شورت‌کد تقویم شمسی.
• دارای شورت‌کد تقویم رومیزی.
• دارای شورت‌کد تقویم دیواری.
• دارای شورت‌کد کارت امروز.
• دارای شورت‌کد ساعت و تاریخ.
• دارای شورت‌کد تقویم فصل‌ها.
• دارای شورت‌کد باحساب.

ابزارک‌ها و بلاک‌ها

• دارای ابزارک تقویم رومیزی.
• دارای ابزارک تقویم دیواری.
• دارای ابزارک کارت امروز.
• دارای ابزارک ساعت.
• دارای ابزارک تقویم فصل‌های سال.
• دارای ابزارک باحساب.
• پشتیبانی از ابزارک‌های Elementor.
• پشتیبانی از بلاک‌های Gutenberg.
• پشتیبانی از ویجت‌های کلاسیک وردپرس.

یکپارچه‌سازی‌های پرو

• یکپارچه‌سازی کامل با WooCommerce.
• یکپارچه‌سازی کامل با Contact Form 7.
• یکپارچه‌سازی کامل با WPForms.
• یکپارچه‌سازی کامل با MetForm.
• یکپارچه‌سازی کامل با JetFormBuilder.
• یکپارچه‌سازی کامل با QuForm.
• یکپارچه‌سازی کامل با Advanced Custom Fields (ACF).
• یکپارچه‌سازی کامل با JetEngine.
• یکپارچه‌سازی کامل با JetSmartFilters.
• یکپارچه‌سازی کامل با Checkout Field Editor for WooCommerce.
• یکپارچه‌سازی کامل با YITH Checkout Manager.
• یکپارچه‌سازی کامل با Easy Digital Downloads (EDD).
• یکپارچه‌سازی کامل با Dokan.

نصب

1. افزونه را در مسیر /wp-content/plugins/ آپلود کنید یا از بخش افزونه‌ها > افزودن افزونه جدید آن را نصب کنید.
2. افزونه را فعال کنید.
3. از منوی مدیریت وردپرس، «کیت شمسی تم فور» را باز کنید. افزونه با تنظیمات پیش‌فرض منطقی آماده استفاده است و نیازی به پیکربندی اجباری ندارد.

پرسش‌های متداول

آیا این افزونه تاریخ‌های ذخیره‌شده در پایگاه داده را تغییر می‌دهد؟

خیر. تاریخ نوشته‌ها دقیقاً همان‌طور که وردپرس آن‌ها را ذخیره می‌کند باقی می‌مانند. فقط تاریخ نمایش‌داده‌شده تغییر می‌کند. اگر افزونه را غیرفعال کنید، تاریخ‌ها دوباره به صورت میلادی نمایش داده می‌شوند و نیازی به تبدیل مجدد یا برگرداندن تغییرات پایگاه داده وجود ندارد.

آیا این افزونه باعث خراب شدن نقشه سایت، فید RSS یا داده‌های ساختاریافته می‌شود؟

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

قالب سایت من ماه را قبل از روز نمایش می‌دهد. آیا می‌توانم این مشکل را برطرف کنم؟

بله. گزینه «ترتیب فارسی تاریخ» را فعال کنید. زمانی که قالب تاریخ با ترتیب انگلیسی نوشته شده باشد، افزونه روز را قبل از ماه قرار می‌دهد.

اگر قالب تاریخ سفارشی وارد کنید، افزونه دقیقاً از همان قالبی که وارد کرده‌اید استفاده می‌کند.

آیا می‌توانم قالب تاریخ را کنترل کنم؟

بله. اگر قالب تاریخ سفارشی را خالی بگذارید، افزونه از قالبی که در تنظیمات > عمومی وردپرس تعیین شده است استفاده می‌کند. همچنین می‌توانید قالبی مانند j F Y را وارد کنید تا فقط برای تاریخ‌های تبدیل‌شده، قالب موردنظر شما اعمال شود.

آیا با ووکامرس کار می‌کند؟

تاریخ‌هایی که ووکامرس از طریق توابع استاندارد تاریخ وردپرس نمایش می‌دهد، به تقویم جلالی تبدیل می‌شوند.

انتخابگرهای تاریخ جلالی در صفحات سفارش‌ها و محصولات ووکامرس، بخشی از افزونه تجاری جداگانه‌ای هستند که در themefour.com ارائه می‌شود و در این افزونه وجود ندارند.

منابع شخص ثالث

فونت وزیرمتن (Vazirmatn) همراه این افزونه منتشر می‌شود و فقط در صورت فعال بودن گزینه مربوطه بارگذاری می‌شود.

• نام فونت: Vazirmatn (وزیرمتن)، سازنده: صابر راستی‌ کردار
• مجوز: SIL Open Font License 1.1، نشانی مجوز: https://scripts.sil.org/OFL
• منبع: https://github.com/rastikerdar/vazirmatn
• متن کامل مجوز: admin/fonts/Vazirmatn-OFL.txt

فایل فونت از روی سرور خود سایت سرو می‌شود و هیچ ارتباطی با سرویس‌های بیرونی مانند Google Fonts برقرار نمی‌شود.

تصاویر

1. پنل تنظیمات افزونه کیت شمسی
2. تنظیمات بخش نمایش کیت شمسی وردپرس.
3. شمسی سازی تاریخ سفارشات ووکامرس
4. شمسی سازی تاریخ نوشته و برگه‌ها

تغییرات نسخه

1.1.0

جدید: امکان اعمال فونت وزیر متن برای داشبورد وردپرس

1.0.1

تمام آثار مربوط به افزونه تجاری جداگانه از این بسته حذف شد.

1.0.0

انتشار اولیه.