پلاگین شمسی‌ساز قالب‌های تایپ‌چو

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

امکانات اصلی پلاگین

• تبدیل دقیق تاریخ میلادی به شمسی (جلالی) 📅
• نمایش نام ماه‌های فارسی 🇮🇷
• بدون نیاز به تغییر در هسته یا پایگاه داده تایپ‌چو 🛠️
• نصب و استفاده آسان در قالب‌ها ⚡

---

آموزش کامل استفاده از پلاگین تاریخ شمسی Typecho + نمونه کد برای قالب

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

روش استفاده در قالب (بدون تابع کمکی سراسری)

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

در پوسته Typecho معمولاً تاریخها اینگونه نمایش داده میشوند:

date(); ?>

یا برای کامنتها:

date('Y-m-d H:i'); ?>

هدف:

تاریخ را میلادی نمایش بده اگر پلاگین غیرفعال است و شمسی نمایش بده اگر پلاگین فعال است.

نمونه کد قابل استفاده در همه بخشهای قالب

نمایش تاریخ پست (index, single, ...):

created);
} else {
    // اگر پلاگین غیرفعال است = نمایش معمول Typecho (میلادی)
    $this->date('Y-m-d');
}
?>

• فرمت 'Y-m-d' را به دلخواه خودتان میتوانید تغییر دهید (مثلاً 'Y/m/d H:i').
• اگر $this->date() بدون فرمت است، قسمت 'Y-m-d' را در هر دو جایگزین حذف کنید.

نمایش تاریخ کامنت:

created);
} else {
    $comments->date('Y-m-d H:i');
}
?>

نمایش در آرشیو (تاریخهای گروهی):

به جای فرمول؛

$year = $date->format('Y');
$monthDay = $date->format('m-d');

استفاده کن:

getTimestamp());
    $monthDay = jalali_date('m-d', $date->getTimestamp());
} else {
    $year = $date->format('Y');
    $monthDay = $date->format('m-d');
}
?>

نکات کلیدی

• کافیست هرجا در قالب خروجی تاریخ داری، جایش را با همین شرط ساده جایگزین کنی.
• هیچ نیاز به ویرایش functions.php یا Hook نویسی نیست؛ فقط همین قطعه را در هر جای مورد نیاز بگذار!
• اگر پلاگین را غیرفعال کنی، خودکار همه تاریخهای قالب به حالت میلادی بازمیگردند.

درباره تابع jalali_date

تابع jalali_date($format, $timestamp)

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

امیدواریم این افزونه برای شما مفید باشد! 🙌