Beskrivelse
این افزونه بدون دستکاری مستقیم پایگاه داده، حروف عربی («ي»، «ك» و «ى»)، اعداد انگلیسی/عربی و تاریخهای میلادی را در خروجی قالب، نوشتهها، برگهها، عناوین آرشیو و دیدگاهها به معادل استاندارد فارسی و شمسی (جلالی) تبدیل میکند.
از نسخه ۲.۰ به بعد، تمامی پردازشها صرفاً در لایه نمایش (Runtime) و از طریق فیلترهای استاندارد وردپرس انجام میشوند. به این ترتیب، محتوای خام دیتابیس هرگز تغییر نمیکند و سلامت پستها، تصاویر، ویژگیهای بلاکهای گوتنبرگ، اسکیماهای سئو و قطعه کدهای سفارشی ۱۰۰٪ حفظ میشود.
ویژگیهای کلیدی
- عملکرد غیرمخرب در لایه نمایش (Run-time): محتوای دیتابیس هرگز دستکاری نمیشود و در صورت غیرفعال کردن افزونه، تمام دادههای اصلی سایت بدون هیچ تغییری به حالت قبل بازمیگردند.
- حفظ سلامت کدها، HTML و سئو: تفکیک هوشمند تگهای HTML، کلاسهای CSS، لینکها، ایمیلها، موجودیتهای عددی HTML (مانند
–)، بلاکهای تودرتوی کد (<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
- پوشه
persian-text-and-date-converterرا در مسیر/wp-content/plugins/بارگذاری کنید یا فایل زیپ آن را از بخش «افزودن افزونه» نصب کنید. - افزونه را از بخش «افزونهها» در پیشخوان وردپرس فعال کنید.
- تبدیل متنها، اعداد و تاریخها به صورت خودکار در بخش کاربری سایت شما اعمال خواهد شد.
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) کاملاً سازگار است.
Anmeldelser
Bidragsydere & udviklere
“Persian Text and Date Converter” er open source-software. Følgende personer har bidraget til dette plugin.
BidragsydereOversæt “Persian Text and Date Converter” til dit eget sprog.
Interesseret i udvikling?
Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.
Ændringslog
2.0.1
- رفع باگ: جلوگیری از تبدیل اعداد در موجودیتهای عددی HTML (مانند
–تولیدشده توسط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
- انتشار اولیه.