راه‌اندازی تقویم شمسی وردپرس

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

این قابلیت، نمایش و انتخاب تاریخ را تغییر می‌دهد. تاریخ‌های ذخیره‌شده و تاریخ‌هایی که از REST API دریافت می‌شوند، با قالب استاندارد وردپرس باقی می‌مانند. بنابراین لازم نیست تاریخ‌های قبلی را تبدیل کنید؛ با خاموش‌کردن قابلیت هم آن‌ها حفظ می‌شوند.

تنظیم منطقه زمانی وردپرس

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

1. در پیشخوان وردپرس به «تنظیمات ← عمومی» بروید.
2. در بخش منطقه زمانی، شهر یا اختلاف زمانی صحیح سایت را انتخاب کنید.
3. تنظیمات را ذخیره کنید.

انتخاب شهر مناسب معمولاً از واردکردن یک اختلاف ثابت مانند +03:30 مطمئن‌تر است، زیرا وردپرس قواعد زمانی را بر اساس همان منطقه مدیریت می‌کند.

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

ورود به تنظیمات تقویم شمسی

برای بازکردن تنظیمات:

1. از پیشخوان وردپرس وارد «جم پک» شوید.
2. از منوی کناری افزونه، «تقویم شمسی» را انتخاب کنید.
3. کارت «تاریخ‌های مدیریت وردپرس» را پیدا کنید.

پیوند مستقیم این بخش:

/wp-admin/admin.php?page=gempack#persian-calendar

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

گزینه‌های تقویم شمسی وردپرس

تبدیل تاریخ‌های فهرست و جدول

با فعال‌کردن «تبدیل تاریخ‌های فهرست و جدول»، تاریخ‌های نمایشی در بخش‌های عمومی پیشخوان به تقویم شمسی تبدیل می‌شوند. محدوده‌های پشتیبانی‌شده شامل این موارد است:

• فهرست نوشته‌ها؛
• فهرست برگه‌ها؛
• کتابخانه و صفحه ویرایش رسانه؛
• فهرست انواع محتوای سفارشی (Post Type) که تاریخ را با توابع استاندارد وردپرس نمایش می‌دهند؛
• تاریخ نمایشی انتشار یا ویرایش در بخش‌های پشتیبانی‌شده مدیریت.

این گزینه فقط خروجی نمایشی را تغییر می‌دهد و مقدار خام post_date یا post_modified را دستکاری نمی‌کند.

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

تبدیل انتخابگرهای تاریخ وردپرس

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

• انتخاب تاریخ در فیلترهای فهرست‌های پشتیبانی‌شده؛
• انتخاب تاریخ در بخش‌های مرتبط کتابخانه رسانه؛
• انتخاب تاریخ انتشار یا زمان‌بندی در ویرایشگر بلوکی گوتنبرگ.

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

تبدیل انتخابگرهای تاریخ مدیریت

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

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

تنظیم پیشنهادی برای بیشتر سایت‌ها

برای یک سایت محتوایی فارسی، تنظیم اولیه زیر پیشنهاد می‌شود:

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

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

فعال‌سازی مرحله‌به‌مرحله

1. وارد «جم پک ← تقویم شمسی» شوید.
2. «تبدیل تاریخ‌های فهرست و جدول» را فعال کنید.
3. «تبدیل انتخابگرهای تاریخ وردپرس» را فعال کنید.
4. در صورت نیاز، «تبدیل انتخابگرهای تاریخ مدیریت» را نیز روشن کنید.
5. روی «ذخیره تنظیمات» بزنید.
6. صفحه فهرست نوشته‌ها را دوباره بارگذاری کنید.
7. یک نوشته آزمایشی را باز و انتخابگر تاریخ انتشار را بررسی کنید.

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

بررسی نتیجه در فهرست نوشته‌ها

برای آزمایش نمایش تاریخ:

1. به «نوشته‌ها ← همه نوشته‌ها» بروید.
2. ستون تاریخ را بررسی کنید.
3. یک نوشته منتشرشده و یک پیش‌نویس یا نوشته زمان‌بندی‌شده را مقایسه کنید.
4. در صورت وجود برگه یا Post Type سفارشی، فهرست آن را نیز بررسی کنید.

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

بررسی نتیجه در کتابخانه رسانه

پس از فعال‌کردن نمایش تاریخ‌های وردپرس:

1. وارد «رسانه ← کتابخانه» شوید.
2. نمای فهرستی و اطلاعات یک فایل رسانه‌ای را بررسی کنید.
3. در صورت استفاده از فیلتر تاریخ، انتخابگر یا مقدار نمایشی آن را آزمایش کنید.

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

زمان‌بندی نوشته در گوتنبرگ

جم پک در ویرایشگر بلوکی یک انتخابگر واقعی تقویم شمسی برای تاریخ انتشار اضافه می‌کند. برای زمان‌بندی نوشته:

1. یک نوشته یا برگه را در ویرایشگر بلوکی باز کنید.
2. پنل وضعیت نوشته را باز کنید.
3. در ردیف «تاریخ انتشار»، روی تاریخ شمسی بزنید.
4. ماه و سال موردنظر را انتخاب کنید.
5. روز، ساعت و دقیقه را تعیین کنید.
6. تغییرات نوشته را ذخیره یا برای زمان انتخاب‌شده زمان‌بندی کنید.

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

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

• زمان‌بندی داخلی وردپرس همچنان به روش معمول کار می‌کند؛
• REST API تاریخ استاندارد دریافت می‌کند؛
• سایر افزونه‌ها مجبور نیستند تاریخ شمسی را تفسیر کنند؛
• با خاموش‌کردن انتخابگر شمسی، نوشته زمان‌بندی‌شده از بین نمی‌رود.

تفاوت نمایش شمسی و ذخیره تاریخ

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

این رفتار چند مزیت دارد:

• سازگاری با هسته وردپرس حفظ می‌شود؛
• ترتیب زمانی نوشته‌ها تغییر نمی‌کند؛
• جست‌وجوی اطلاعات، زمان‌بندی و API از تاریخ استاندارد استفاده می‌کنند؛
• غیرفعال‌سازی ماژول باعث ازدست‌رفتن یا جابه‌جایی تاریخ نمی‌شود.

به همین دلیل نباید مقدار خام تاریخ در پایگاه داده را برای شمسی‌کردن سایت ویرایش کنید.

نمایش تاریخ در محتوای سایت

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

تاریخ جاری

نمایش تاریخ جاری با تنظیم پیش‌فرض:

[aio_wc_date]

نمایش اجباری تاریخ شمسی:

[aio_wc_date_persian]

نمایش اجباری تاریخ میلادی:

[aio_wc_date_gregorian]

نمایش هم‌زمان تاریخ شمسی و میلادی:

[aio_wc_date_both]

تاریخ انتشار یا ویرایش نوشته

نمایش تاریخ انتشار نوشته فعلی:

[aio_wc_post_date]

نمایش تاریخ آخرین ویرایش:

[aio_wc_post_date field="post_modified"]

نمایش تاریخ یک نوشته مشخص:

[aio_wc_post_date post_id="123"]

عدد 123 را با شناسه واقعی نوشته جایگزین کنید.

تعیین نوع و قالب تاریخ

برای اجبار خروجی شمسی یا میلادی می‌توانید از پارامتر type استفاده کنید:

[aio_wc_post_date type="persian"]
[aio_wc_post_date type="gregorian"]

برای تغییر شکل نمایش، پارامتر format را اضافه کنید:

[aio_wc_date format="Y/m/d"]
[aio_wc_date format="j F Y"]
[aio_wc_post_date format="l j F Y"]

نمونه آخر، نام روز هفته، روز ماه، نام ماه و سال را نمایش می‌دهد.

ترتیب تاریخ در خروجی دوگانه

در شورت‌کد دوگانه می‌توانید تاریخ اصلی و جداکننده را مشخص کنید:

[aio_wc_date_both primary="gregorian" separator=" | " format="j F Y"]

مقادیر قابل استفاده برای primary عبارت‌اند از:

persian
gregorian

مرجع کوتاه فرمت تاریخ

مهم‌ترین نشانه‌های قابل استفاده در format:

نشانه	خروجی
Y	سال چهاررقمی شمسی
y	سال دورقمی
m	شماره ماه با صفر ابتدایی
n	شماره ماه بدون صفر ابتدایی
d	روز ماه با صفر ابتدایی
j	روز ماه بدون صفر ابتدایی
F یا M	نام ماه شمسی
l یا D	نام روز هفته
H	ساعت با قالب ۲۴ ساعته
i	دقیقه

برای قرار دادن متن ثابت در قالب، حروفی را که ممکن است به‌عنوان نشانه تاریخ شناخته شوند با \ جدا کنید. نمونه:

[aio_wc_date format="j F Y \ساعت H:i"]

استفاده در صفحه‌سازها

شورت‌کدهای تاریخ را می‌توانید در ابزارهای رایج قرار دهید:

• در Bricks از عنصر Shortcode استفاده کنید؛
• در گوتنبرگ از بلوک Shortcode استفاده کنید؛
• در Elementor از ابزارک Shortcode استفاده کنید؛
• در سایر صفحه‌سازها، عنصر یا ابزارک اجرای شورت‌کد را انتخاب کنید.

جم پک برچسب‌های تاریخ را نیز برای داده‌های پویا در Bricks ثبت می‌کند؛ با این حال، استفاده از عنصر Shortcode ساده‌ترین روش مشترک میان صفحه‌سازهاست.

چه بخش‌هایی عمداً تغییر نمی‌کنند؟

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

• مقدارهای تاریخ در پایگاه داده وردپرس؛
• تاریخ‌های ISO در REST API؛
• منطق زمان‌بندی انتشار نوشته؛
• همه فیلدهای سفارشی ساخته‌شده توسط افزونه‌های دیگر؛
• تمام انتخابگرهای تاریخ کتابخانه‌های ثالث؛
• تنظیم منطقه زمانی سایت.

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

جلوگیری از تداخل با افزونه‌های تقویم دیگر

استفاده هم‌زمان از چند افزونه شمسی‌ساز ممکن است باعث تبدیل دوباره تاریخ، نمایش سال نادرست یا بارگذاری چند انتخابگر روی یک فیلد شود. پیش از فعال‌سازی:

1. افزونه‌های تقویم و فارسی‌ساز فعال را بررسی کنید.
2. فقط یک ابزار را مسئول تبدیل هر بخش قرار دهید.
3. کش مرورگر و سایت را پاک کنید.
4. فهرست نوشته‌ها، رسانه و ویرایشگر را دوباره آزمایش کنید.

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

غیرفعال‌کردن تقویم شمسی وردپرس

برای بازگرداندن رابط تاریخ وردپرس:

1. وارد «جم پک ← تقویم شمسی» شوید.
2. گزینه‌های وردپرسی فعال را خاموش کنید.
3. تنظیمات را ذخیره کنید.
4. صفحه‌های باز پیشخوان را دوباره بارگذاری کنید.
5. کش مرورگر یا افزونه بهینه‌سازی را در صورت نیاز تازه‌سازی کنید.

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

خطاهای رایج

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

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

انتخابگر شمسی در گوتنبرگ نمایش داده نمی‌شود

• «تبدیل انتخابگرهای تاریخ وردپرس» باید فعال باشد.
• مطمئن شوید نوشته در ویرایشگر بلوکی باز شده است.
• صفحه ویرایش را پس از ذخیره تنظیمات کاملاً تازه‌سازی کنید.
• خطا یا تداخل جاوااسکریپت افزونه‌های ویرایشگر را بررسی کنید.

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

تاریخ یا ساعت یک روز جابه‌جا دیده می‌شود

• منطقه زمانی «تنظیمات ← عمومی» را بررسی کنید.
• زمان محلی سرور و وردپرس را مقایسه کنید.
• تاریخ واقعی ذخیره‌شده نوشته را کنترل کنید.
• اگر فقط یک افزونه یا Post Type مشکل دارد، احتمالاً آن بخش تاریخ را با روش اختصاصی نمایش می‌دهد.

بعضی تاریخ‌ها شمسی و بعضی میلادی‌اند

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

تاریخ یک Post Type سفارشی تبدیل نمی‌شود

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

خروجی شورت‌کد خالی است

• در post_id از شناسه معتبر استفاده کنید.
• شورت‌کد تاریخ نوشته را در محتوایی اجرا کنید که نوشته جاری مشخص دارد.
• املا و علامت‌های نقل‌قول پارامترها را بررسی کنید.
• برای نمایش تاریخ جاری از [aio_wc_date] استفاده کنید.

آموزش‌های مرتبط

• آشنایی با محیط جم پک و مدیریت ماژول‌ها
• نصب، فعال‌سازی و ثبت لایسنس جم پک
• راه‌اندازی تقویم شمسی ووکامرس