قابلیت تقویم شمسی ووکامرس، مدیریت تاریخ‌های فروشگاه را برای کاربران فارسی‌زبان ساده‌تر می‌کند. با فعال‌کردن گزینه‌های موردنیاز می‌توانید تاریخ سفارش‌ها، محصولات، کوپن‌ها و بخش‌های پشتیبانی‌شده ووکامرس را به‌صورت شمسی ببینید، بازه‌های زمانی را با انتخابگر فارسی تعیین کنید و گزارش‌ها را با تاریخ‌های شمسی بررسی کنید.
تاریخ‌های اصلی فروشگاه با قالب استاندارد وردپرس و ووکامرس ذخیره می‌شوند. جم پک نمایش و انتخاب تاریخ را شمسی می‌کند و پیش از اجرای فیلتر یا گزارش، تاریخ انتخاب‌شده را به معادل استاندارد تبدیل می‌کند. محاسبات فروش، APIها، وب‌هوک‌ها و زمان‌بندی‌ها همچنان از تاریخ استاندارد استفاده می‌کنند.
ورود به تنظیمات تقویم شمسی ووکامرس
برای دسترسی به تنظیمات:
- وارد پیشخوان وردپرس شوید.
- از منوی جم پک، «تقویم شمسی» را انتخاب کنید.
- کارت تنظیمات مربوط به ووکامرس را پیدا کنید.
پیوند مستقیم این بخش:
/wp-admin/admin.php?page=gempack#persian-calendarاگر ووکامرس فعال نباشد، گزینه‌های اختصاصی آن غیرفعال نمایش داده می‌شوند. این وضعیت مانع استفاده از تقویم شمسی در بخش‌های عمومی وردپرس نمی‌شود.
گزینه‌های تقویم شمسی ووکامرس
سه گزینه مستقل برای ووکامرس وجود دارد. هر گزینه را بر اساس نیاز فروشگاه فعال کنید.
تبدیل تاریخ‌های ووکامرس
با فعال‌کردن این گزینه، تاریخ‌های نمایشی بخش‌های پشتیبانی‌شده ووکامرس به شمسی تبدیل می‌شوند؛ از جمله:
- تاریخ سفارش‌ها در فهرست مدیریت؛
- تاریخ‌های نمایشی صفحه سفارش؛
- تاریخ محصولات و کوپن‌ها در بخش‌های پشتیبانی‌شده؛
- تاریخ‌های قابل مشاهده در بعضی صفحه‌های حساب کاربری و سفارش؛
- ستون‌ها یا خروجی‌هایی که از ساختار استاندارد تاریخ ووکامرس استفاده می‌کنند.
پشتیبانی از هر دو روش ذخیره‌سازی سفارش‌ها، شامل ساختار قدیمی و HPOS، در نظر گرفته شده است. HPOS سفارش‌ها را در جدول‌های اختصاصی ووکامرس ذخیره می‌کند. ستون‌های اختصاصی افزونه‌های دیگر ممکن است به سازگاری جداگانه نیاز داشته باشند.
فعال‌کردن این گزینه مقدار تاریخ سفارش را ویرایش نمی‌کند و ترتیب زمانی سفارش‌ها، زمان پرداخت یا زمان تکمیل آن‌ها را تغییر نمی‌دهد.
تبدیل انتخابگرهای تاریخ ووکامرس
این گزینه انتخاب و فیلترکردن تاریخ را در صفحه‌های پشتیبانی‌شده ووکامرس به تقویم فارسی مجهز می‌کند. کاربردهای رایج آن عبارت‌اند از:
- تعیین بازه تاریخ در فهرست سفارش‌ها؛
- فیلترکردن محصولات و صفحه‌های پشتیبانی‌شده بر اساس تاریخ؛
- کار با فیلدهای استاندارد تاریخ ووکامرس؛
- انتخاب روز، ماه و سال از رابط شمسی به‌جای واردکردن دستی تاریخ میلادی.
روز موردنظر را از تقویم شمسی انتخاب کنید. جم پک پیش از ارسال فرم یا اجرای فیلتر، معادل استاندارد آن را به ووکامرس می‌دهد.
این گزینه همه فیلدهای تاریخ ساخته‌شده توسط افزونه‌های دیگر را به‌طور خودکار تغییر نمی‌دهد. اگر یک افزونه از انتخابگر اختصاصی یا فیلد غیر استاندارد استفاده کند، ممکن است تحت پوشش این تنظیم نباشد.
تبدیل گزارش‌ها و Analytics
با فعال‌کردن این گزینه، تاریخ‌ها و کنترل بازه زمانی در دو نسل از ابزارهای گزارش‌گیری ووکامرس بومی می‌شوند:
- بخش جدید Analytics ووکامرس؛
- گزارش‌های قدیمی ووکامرس در صفحه
wc-reports.
در بخش Analytics، جم پک یک کنترل بازه زمانی شمسی در اختیار مدیر قرار می‌دهد و بازه انتخاب‌شده را با پارامترهای استاندارد ووکامرس اجرا می‌کند. در گزارش‌های قدیمی نیز انتخابگر بازه سفارشی می‌تواند با تقویم فارسی استفاده شود.
نکته مهم این است که اعداد گزارش بر اساس همان منطق و تاریخ استاندارد ووکامرس محاسبه می‌شوند. جم پک تاریخ‌ها، عنوان بازه و برچسب‌های زمانی پشتیبانی‌شده را شمسی نمایش می‌دهد، اما مبلغ فروش، تعداد سفارش‌ها، مقایسه دوره‌ها و سایر شاخص‌ها را دوباره محاسبه نمی‌کند.
بخش Analytics به‌تدریج بارگذاری می‌شود. ممکن است هنگام بازشدن صفحه، تاریخ برای لحظه‌ای میلادی باشد و سپس شمسی شود. برای بررسی نتیجه، تا پایان بارگذاری صبر کنید.
تنظیم پیشنهادی برای بیشتر فروشگاه‌ها
| گزینه | مقدار پیشنهادی | دلیل |
|---|---|---|
| تبدیل تاریخ‌های ووکامرس | فعال | مشاهده تاریخ شمسی سفارش‌ها، محصولات و کوپن‌ها |
| تبدیل انتخابگرهای تاریخ ووکامرس | فعال | فیلتر و انتخاب بازه با تقویم فارسی |
| تبدیل گزارش‌ها و Analytics | فعال در صورت استفاده از گزارش‌ها | مشاهده و انتخاب بازه شمسی بدون تغییر محاسبات فروش |
اگر فروشگاه از گزارش‌های ووکامرس استفاده نمی‌کند، گزینه سوم را می‌توان خاموش نگه داشت. خاموش‌بودن آن روی نمایش تاریخ سفارش‌ها یا انتخابگرهای عمومی ووکامرس اثری ندارد.
فعال‌سازی مرحله‌به‌مرحله
- وارد «جم پک ← تقویم شمسی» شوید.
- در کارت ووکامرس، «تبدیل تاریخ‌های ووکامرس» را فعال کنید.
- «تبدیل انتخابگرهای تاریخ ووکامرس» را روشن کنید.
- در صورت استفاده از گزارش‌ها، «تبدیل گزارش‌ها و Analytics» را نیز فعال کنید.
- روی «ذخیره تنظیمات» بزنید.
- صفحه‌های باز ووکامرس را کاملاً دوباره بارگذاری کنید.
- نتیجه را در فهرست سفارش‌ها، یک فیلتر تاریخی و بخش Analytics آزمایش کنید.
هر گزینه را بر اساس نتیجه واقعی آن بررسی کنید. روشن‌بودن سوییچ به‌تنهایی برای اطمینان از نبود تداخل با قالب مدیریت یا افزونه‌های دیگر کافی نیست.
بررسی تاریخ‌ها در فهرست سفارش‌ها
برای آزمایش تبدیل تاریخ سفارش:
- به «ووکامرس ← سفارش‌ها» بروید.
- تاریخ چند سفارش با وضعیت‌های متفاوت را بررسی کنید.
- یک سفارش قدیمی و یک سفارش جدید را باز کنید.
- تاریخ‌های نمایشی فهرست و صفحه سفارش را با یکدیگر مقایسه کنید.
سال، ماه و روز باید به‌صورت شمسی دیده شوند، اما زمان ایجاد، پرداخت یا تکمیل سفارش نباید جابه‌جا شود. اگر HPOS در فروشگاه فعال است، آزمایش را روی همان صفحه جدید سفارش‌ها انجام دهید؛ پشتیبانی از ستون تاریخ اصلی سفارش برای این ساختار در نظر گرفته شده است.
اگر افزونه دیگری ستونی اختصاصی مانند «تاریخ تحویل» ایجاد کرده است، شمسی‌شدن تاریخ اصلی سفارش به معنی پشتیبانی خودکار از آن ستون نیست.
استفاده از انتخابگر تاریخ در فیلترها
برای بررسی انتخابگر شمسی:
- صفحه سفارش‌ها یا یکی از صفحه‌های پشتیبانی‌شده ووکامرس را باز کنید.
- فیلتر تاریخ یا بازه زمانی را انتخاب کنید.
- تاریخ شروع و پایان را از تقویم شمسی تعیین کنید.
- فیلتر را اجرا کنید.
- قدیمی‌ترین و جدیدترین نتیجه را با بازه انتخاب‌شده مقایسه کنید.
هنگام اجرای فیلتر، تاریخ شمسی به معادل استاندارد تبدیل می‌شود و ووکامرس نتایج را با همان روش معمول پیدا می‌کند.
برای بازه‌های یک‌روزه، ساعت شروع و پایان روز نیز می‌تواند روی نتیجه اثر بگذارد. اگر سفارش موردنظر در مرز بازه نمایش داده نمی‌شود، منطقه زمانی سایت و ترتیب تاریخ شروع و پایان را بررسی کنید.
استفاده از تاریخ شمسی در Analytics ووکامرس
برای کار با گزارش‌های جدید:
- وارد «ووکامرس ← Analytics» شوید.
- گزارش موردنظر مانند سفارش‌ها، درآمد یا محصولات را باز کنید.
- کنترل بازه تاریخ شمسی را انتخاب کنید.
- تاریخ شروع و پایان را تعیین کنید.
- بازه را اعمال کنید.
- عنوان بازه، نمودار و جدول گزارش را بررسی کنید.
ممکن است در نشانی صفحه Analytics یا درخواست‌های آن، معادل میلادی بازه انتخاب‌شده را ببینید. این رفتار طبیعی است؛ ووکامرس برای محاسبه گزارش از تاریخ استاندارد استفاده می‌کند.
برای اطمینان از صحت نتیجه، یک بازه کوتاه و مشخص را یک بار با کنترل شمسی و یک بار با تاریخ معادل در حالت معمول مقایسه کنید. مبلغ و تعداد سفارش‌ها باید برای بازه یکسان برابر باشد.
استفاده در گزارش‌های قدیمی ووکامرس
بعضی فروشگاه‌ها یا افزونه‌ها همچنان از گزارش‌های قدیمی ووکامرس استفاده می‌کنند. این گزارش‌ها معمولاً از مسیر زیر در دسترس‌اند:
/wp-admin/admin.php?page=wc-reportsدر بازه سفارشی گزارش:
- گزارش موردنظر را باز کنید.
- بازه سفارشی را انتخاب کنید.
- تاریخ شروع و پایان را با انتخابگر شمسی تعیین کنید.
- گزارش را اجرا کنید.
- عنوان بازه و برچسب‌های زمانی نمودار را بررسی کنید.
جم پک هنگام اجرای بازه سفارشی از سازوکار استاندارد و امنیتی ووکامرس استفاده می‌کند. تاریخ‌ها پیش از درخواست گزارش تبدیل می‌شوند و محاسبات اصلی همچنان بر عهده ووکامرس باقی می‌ماند.
نمایش تاریخ سفارش با شورت‌کد
برای نمایش تاریخ یک سفارش در برگه، قالب یا صفحه‌ساز می‌توانید از شورت‌کد زیر استفاده کنید:
[aio_wc_order_date order_id="123"]عدد 123 را با شناسه سفارش موردنظر جایگزین کنید. نوع تاریخ با پارامتر type تعیین می‌شود.
تاریخ ایجاد سفارش
[aio_wc_order_date order_id="123" type="created"]مقدار created پیش‌فرض است و در صورت حذف پارامتر type نیز استفاده می‌شود.
تاریخ پرداخت سفارش
[aio_wc_order_date order_id="123" type="paid"]تاریخ تکمیل سفارش
[aio_wc_order_date order_id="123" type="completed"]تغییر قالب خروجی
[aio_wc_order_date order_id="123" format="Y/m/d"]
[aio_wc_order_date order_id="123" format="j F Y \ساعت H:i"]اگر شناسه سفارش معتبر نباشد، ووکامرس فعال نباشد یا تاریخ انتخاب‌شده هنوز برای سفارش ثبت نشده باشد، خروجی می‌تواند خالی باشد. برای نمونه، سفارش پرداخت‌نشده تاریخ paid ندارد.
در صفحه‌سازهایی مانند Bricks، شورت‌کد را داخل عنصر Shortcode قرار دهید. هنگام نمایش اطلاعات سفارش در بخش عمومی سایت، کنترل دسترسی کاربر و محرمانگی اطلاعات سفارش را در طراحی صفحه رعایت کنید.
چه اطلاعاتی تغییر نمی‌کنند؟
فعال‌سازی تقویم شمسی ووکامرس موارد زیر را به مقدار خام شمسی تبدیل نمی‌کند:
- زمان ایجاد، پرداخت یا تکمیل سفارش در پایگاه داده؛
- تاریخ محصولات، کوپن‌ها و سفارش‌ها در REST API؛
- تاریخ درخواست‌ها و پاسخ‌های درگاه‌های پرداخت؛
- زمان اجرای کرون‌ها و کارهای زمان‌بندی‌شده؛
- ترتیب زمانی سفارش‌ها؛
- محاسبات فروش و شاخص‌های گزارش؛
- پارامترهای استانداردی که ووکامرس برای اجرای کوئری نیاز دارد؛
- فیلدهای تاریخ اختصاصی همه افزونه‌های ثالث.
برای شمسی‌کردن فروشگاه، نیازی به تغییر یا تبدیل تاریخ‌های ذخیره‌شده در پایگاه داده ندارید.
رابطه این تنظیمات با تقویم وردپرس
گزینه‌های وردپرس و ووکامرس مستقل‌اند. برای مثال می‌توانید:
- فقط تاریخ‌های نوشته‌ها را شمسی کنید؛
- فقط تاریخ سفارش‌ها و محصولات را شمسی کنید؛
- نمایش تاریخ‌های ووکامرس را فعال و گزارش‌ها را غیرفعال نگه دارید؛
- انتخابگرهای شمسی را بدون تغییر تمام تاریخ‌های نمایشی استفاده کنید.
این تفکیک باعث می‌شود فعال‌سازی تدریجی و عیب‌یابی ساده‌تر باشد. برای یک تجربه یکپارچه در پیشخوان فروشگاه فارسی، معمولاً فعال‌کردن تاریخ‌های وردپرس و ووکامرس در کنار یکدیگر مناسب‌تر است.
غیرفعال‌کردن تقویم شمسی ووکامرس
برای بازگرداندن رابط تاریخ ووکامرس:
- وارد «جم پک ← تقویم شمسی» شوید.
- گزینه یا گزینه‌های ووکامرس را خاموش کنید.
- تنظیمات را ذخیره کنید.
- صفحه سفارش‌ها و گزارش‌ها را دوباره بارگذاری کنید.
- در صورت باقی‌ماندن خروجی قبلی، کش مرورگر و افزونه‌های بهینه‌سازی را تازه‌سازی کنید.
غیرفعال‌کردن این تنظیمات هیچ سفارش، محصول، گزارش یا تاریخ ذخیره‌شده‌ای را حذف نمی‌کند. فقط رابط نمایشی و انتخابگرهای پشتیبانی‌شده به حالت معمول بازمی‌گردند.
چک‌لیست آزمایش پس از فعال‌سازی
- تاریخ یک سفارش جدید و یک سفارش قدیمی شمسی نمایش داده شود؛
- زمان ایجاد یا پرداخت سفارش جابه‌جا نشده باشد؛
- انتخابگر فارسی در فیلتر سفارش‌ها باز شود؛
- نتیجه فیلتر با بازه شمسی انتخاب‌شده مطابقت داشته باشد؛
- تاریخ‌های محصول یا کوپن در صفحه‌های پشتیبانی‌شده بررسی شوند؛
- یک بازه کوتاه در Analytics با تاریخ معادل مقایسه شود؛
- مبلغ و تعداد سفارش‌های گزارش در بازه یکسان تغییر نکرده باشد؛
- در صورت استفاده از گزارش قدیمی، بازه سفارشی آن نیز آزمایش شود؛
- تاریخ‌های اختصاصی افزونه‌های دیگر جداگانه بررسی شوند؛
- سایت با افزونه شمسی‌ساز دیگری دچار تبدیل دوباره نشده باشد.
خطاهای رایج
گزینه‌های ووکامرس غیرفعال‌اند
- مطمئن شوید ووکامرس نصب و فعال است.
- صفحه تنظیمات جم پک را بعد از فعال‌سازی ووکامرس دوباره بارگذاری کنید.
- دسترسی حساب فعلی به مدیریت افزونه‌ها و ووکامرس را بررسی کنید.
غیرفعال‌بودن ووکامرس مانع استفاده از بخش تقویم شمسی وردپرس نمی‌شود، اما کنترل‌های اختصاصی فروشگاه تا زمان فعال‌شدن ووکامرس قابل استفاده نیستند.
تاریخ سفارش‌ها هنوز میلادی نمایش داده می‌شود
- فعال‌بودن «تبدیل تاریخ‌های ووکامرس» را بررسی کنید.
- پس از تغییر سوییچ، تنظیمات را ذخیره کنید.
- صفحه سفارش‌ها را به‌طور کامل تازه‌سازی کنید.
- کش مرورگر یا افزونه‌های بهینه‌سازی مدیریت را بررسی کنید.
- ببینید تاریخ موردنظر ستون اصلی ووکامرس است یا ستونی اختصاصی از افزونه دیگر.
- تداخل با افزونه شمسی‌ساز دیگری را آزمایش کنید.
انتخابگر شمسی باز می‌شود اما نتیجه فیلتر درست نیست
- ترتیب تاریخ شروع و پایان را بررسی کنید.
- منطقه زمانی وردپرس را کنترل کنید.
- با یک بازه کوتاه و سفارش‌های دارای تاریخ مشخص دوباره آزمایش کنید.
- افزونه‌ای را که فرم فیلتر یا پارامترهای آن را بازنویسی می‌کند بررسی کنید.
- مطمئن شوید هر دو تاریخ از خود انتخابگر انتخاب شده‌اند و مقدار ناقص وارد نشده است.
جم پک پیش از اجرای فیلتر تاریخ شمسی را به معادل استاندارد تبدیل می‌کند. اگر نتیجه فقط در یک صفحه سفارشی نادرست است، احتمال دارد آن صفحه از پارامتر یا فیلد اختصاصی استفاده کند.
تاریخ‌های Analytics ابتدا میلادی دیده می‌شوند
Analytics ووکامرس به‌صورت پویا ساخته می‌شود. کمی برای تکمیل بارگذاری صبر کنید و در صورت نیاز صفحه را دوباره تازه‌سازی کنید. اگر تبدیل انجام نشد، فعال‌بودن گزینه گزارش‌ها و نبود خطای جاوااسکریپت را بررسی کنید.
اعداد گزارش با انتظار من متفاوت است
تقویم شمسی اعداد گزارش را تغییر نمی‌دهد. در این وضعیت:
- تاریخ معادل شروع و پایان را بررسی کنید؛
- منطقه زمانی سایت را کنترل کنید؛
- نوع مبنای گزارش، وضعیت سفارش‌ها و فیلترهای فعال را مقایسه کنید؛
- بازه مشابه قبلی را با طول روزهای دوره فعلی اشتباه نگیرید؛
- همان بازه را در حالت استاندارد ووکامرس اجرا و نتیجه را مقایسه کنید.
تفاوت عدد معمولاً از تفاوت بازه یا فیلترهای ووکامرس ناشی می‌شود، نه از شکل نمایش تاریخ.
بعضی تاریخ‌ها شمسی و بعضی میلادی‌اند
سه گزینه ووکامرس مستقل‌اند. همچنین کنترل‌های ساخته‌شده توسط افزونه‌های ثالث ممکن است از خروجی یا انتخابگر اختصاصی استفاده کنند. ابتدا مشخص کنید تاریخ میلادی در صفحه سفارش، انتخابگر، گزارش یا فیلد افزونه دیگری دیده می‌شود. سپس تنظیم مربوط به همان بخش را بررسی کنید.
در HPOS یک ستون اختصاصی تبدیل نمی‌شود
تاریخ اصلی سفارش در صفحه سفارش‌های HPOS پشتیبانی می‌شود، اما ستون‌های اختصاصی افزونه‌های دیگر ممکن است قالب متفاوتی داشته باشند. مشکل را با ستون تاریخ پیش‌فرض ووکامرس مقایسه کنید. اگر فقط ستون سفارشی میلادی است، برای همان افزونه به سازگاری جداگانه نیاز خواهد بود.
تاریخ دوبار تبدیل شده یا سال نادرست است
این مشکل معمولاً هنگام استفاده هم‌زمان از چند افزونه شمسی‌ساز رخ می‌دهد. تبدیل تاریخ ووکامرس را فقط در یک افزونه فعال نگه دارید، کش‌ها را پاک کنید و دوباره فهرست سفارش‌ها و گزارش‌ها را آزمایش کنید.
خروجی شورت‌کد تاریخ سفارش خالی است
- مقدار
order_idباید شناسه یک سفارش معتبر باشد. - ووکامرس باید فعال باشد.
- نوع تاریخ را با یکی از مقادیر
created،paidیاcompletedوارد کنید. - سفارش پرداخت‌نشده یا تکمیل‌نشده ممکن است تاریخ مربوط به همان وضعیت را نداشته باشد.
- شورت‌کد و علامت‌های نقل‌قول را بدون تغییر تایپ کنید.