Persian Text and Date Converter

Description

این افزونه بدون دستکاری مستقیم پایگاه داده، حروف عربی («ي»، «ك» و «ى»)، اعداد انگلیسی/عربی و تاریخ‌های میلادی را در خروجی قالب، نوشته‌ها، برگه‌ها، عناوین آرشیو و دیدگاه‌ها به معادل استاندارد فارسی و شمسی (جلالی) تبدیل می‌کند.

از نسخه ۲.۰ به بعد، تمامی پردازش‌ها صرفاً در لایه نمایش (Runtime) و از طریق فیلترهای استاندارد وردپرس انجام می‌شوند. به این ترتیب، محتوای خام دیتابیس هرگز تغییر نمی‌کند و سلامت پست‌ها، تصاویر، ویژگی‌های بلاک‌های گوتنبرگ، اسکیماهای سئو و قطعه کدهای سفارشی ۱۰۰٪ حفظ می‌شود.

ویژگی‌های کلیدی

  • عملکرد غیرمخرب در لایه نمایش (Run-time): محتوای دیتابیس هرگز دستکاری نمی‌شود و در صورت غیرفعال کردن افزونه، تمام داده‌های اصلی سایت بدون هیچ تغییری به حالت قبل بازمی‌گردند.
  • حفظ سلامت کدها، HTML و سئو: تفکیک هوشمند تگ‌های HTML، کلاس‌های CSS، لینک‌ها، ایمیل‌ها، موجودیت‌های عددی HTML (مانند &#8211;)، بلاک‌های تودرتوی کد (<pre> و <code>) و نقشه‌های سایت (XML Sitemaps).
  • تبدیل هوشمند اعداد: تبدیل ارقام انگلیسی و عربی به فارسی با حفظ عبارات فنی و مدل‌های ترکیبی لاتین (مانند MP3، PS5، H2O و v2.0).
  • پشتیبانی کامل و دقیق از تابع wp_date: سازگاری مدرن با سیستم تاریخ وردپرس ۵.۳ به بعد، محاسبه دقیق سال‌های کبیسه شمسی و محافظت از فرمت‌های تاریخ ماشینی و سئو (مانند Y-m-d و DATE_W3C در تگ‌های <time>).
  • اصلاح استاندارد حروف: تبدیل کاراکترهای عربی پرکاربرد به معادل استاندارد فارسی بدون تخریب حروف معتبر (مانند حفظ حروف دارای همزه مثل «ئ» و «ؤ»).
  • سبک و بسیار سریع: بدون فشار به منابع سرور و بدون اجرای کوئری‌های سنگین روی دیتابیس.

English Overview

Persian Text and Date Converter is a lightweight, non-destructive WordPress plugin that automatically converts Arabic characters to Persian, English/Arabic numerals to Persian digits, and Gregorian dates to the Jalali (Shamsi) calendar.

Operating purely at runtime via WordPress display filters, it never alters your raw database entries—ensuring complete safety for your posts, URLs, HTML entities, Gutenberg block attributes, SEO schemas, and custom code snippets.

Installation

  1. پوشه persian-text-and-date-converter را در مسیر /wp-content/plugins/ بارگذاری کنید یا فایل زیپ آن را از بخش «افزودن افزونه» نصب کنید.
  2. افزونه را از بخش «افزونه‌ها» در پیشخوان وردپرس فعال کنید.
  3. تبدیل متن‌ها، اعداد و تاریخ‌ها به صورت خودکار در بخش کاربری سایت شما اعمال خواهد شد.

FAQ

آیا فعال‌سازی این افزونه محتوای دیتابیس من را تغییر می‌دهد؟

خیر. تمامی تبدیل‌ها در لحظه رندر و نمایش صفحه انجام می‌شوند. دیتابیس و کدهای شما ۱۰۰٪ امن و بدون تغییر باقی می‌مانند.

آیا اعداد داخل لینک‌ها، بلاک‌های کد یا عبارات فنی به فارسی تبدیل می‌شوند؟

خیر. الگوریتم افزونه تگ‌های HTML، بلاک‌های کد (<pre> و <code>)، آدرس‌های اینترنتی و عبارات ترکیبی انگلیسی (مانند MP3 یا PS5) را تشخیص داده و از تغییر آن‌ها جلوگیری می‌کند تا تصاویر، پیوندها و متون فنی بدون مشکل نمایش داده شوند.

آیا این افزونه باعث خطا در اسکیما (Schema) یا نقشه سایت می‌شود؟

خیر. درخواست‌های مربوط به فیدها، REST API، نقشه سایت (XML) و فرمت‌های تاریخ استاندارد ماشینی (مانند Y-m-d و ISO 8601) به طور خودکار مستثنی شده‌اند تا سئو فنی سایت کاملاً استاندارد بماند.

افزونه با چه نسخه‌هایی از وردپرس و PHP سازگار است؟

این افزونه با وردپرس نسخه ۵.۳ و بالاتر (به دلیل استفاده از هوک‌های نوین wp_date) و PHP نسخه ۷.۴ و بالاتر (شامل PHP 8.1، 8.2، 8.3 و 8.4) کاملاً سازگار است.

Reviews

August 10, 2025
به محض فعال کردن این پلاگین، تمام اعداد (حتی URL) به اعداد فارسی تبدیل میشه! این یه باگ به شدت مهمه و کاملا سایت رو به مشکل می‌اندازه و حتی بعد از غیرفعال‌سازی هم اعداد درست نمیشه و این موضوع به شدت به سئو ضربه می‌زنه! حتما باید برطرف بشه، وگرنه اصلا فعال کردنش منطقی نیست! من مجبور شدم بکاپ برگردونم!
Read all 1 review

Contributors & Developers

“Persian Text and Date Converter” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

2.0.1

  • رفع باگ: جلوگیری از تبدیل اعداد در موجودیت‌های عددی HTML (مانند &#8211; تولیدشده توسط wptexturize).
  • رفع باگ: حل مشکل اعمال مضاعف اختلاف ساعت (Timezone Offset) با یکپارچه‌سازی فیلتر تاریخ روی هوک wp_date.
  • رفع باگ: اصلاح عبارت باقاعده (Regex) برای پشتیبانی دقیق از تگ‌های تودرتوی <pre> و <code> و افزودن محافظت برای تگ‌های <textarea>، <kbd>، <samp>، <var> و <math>.
  • رفع باگ: پیمایش ایمن کاراکترهای چندبایتی (UTF-8) در رشته‌های فرمت تاریخ سفارشی.
  • بهبود: حفظ اعداد چسبیده به حروف لاتین (مانند MP3، PS5، H2O) و محافظت از فرمت‌های تاریخ سئو (Y-m-d).
  • بهبود: افزودن پشتیبانی کامل از سال کبیسه شمسی (L)، تعداد روزهای ماه (t)، روز سال (z) و پسوند ترتیبی فارسی (S).

2.0.0

  • بازتولید معماری افزونه: حذف کامل دستکاری دیتابیس و انتقال کل فرآیند تبدیل به فیلترهای لایه نمایش (the_content, the_title, comment_text).
  • حل مشکل تگ‌های HTML: جلوگیری از تخریب آدرس تصاویر، کلاس‌های استایل و شورت‌کدها با جداسازی تگ‌ها پیش از تبدیل کاراکتر.
  • به‌روزرسانی موتور تاریخ: جایگزینی مکانیزم‌های منسوخ با پشتیبانی استاندارد از هوک wp_date.
  • اصلاح حروف مجاز: رفع اشکال جایگزینی نادرست کاراکترهایی چون «ئ» و «ؤ».
  • حذف هوک سنگین فعال‌سازی: رفع خطر خطای Timeout و اتمام حافظه (Memory Exhaustion) در سایت‌های دارای محتوای حجیم.

1.4

  • بهبود نام‌گذاری توابع و جلوگیری از دسترسی مستقیم به فایل افزونه.

1.0

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