لوکو ترنسلیت (Loco Translate)
i18n ترجمه رشته‌ها و فایل‌های PO/MO

راهنمای جامع لوکو ترنسلیت (Loco Translate): معماری بومی‌سازی و مدیریت فایل‌های ترجمه در وردپرس

راهنمای فنی و عمیق افزونه Loco Translate برای بومی‌سازی قالب‌ها و افزونه‌های وردپرس، مدیریت فایل‌های PO/MO و حل چالش‌های زبان فارسی.

آخرین نگارش نسخه 2.8.8
نصب‌های فعال +1 میلیون
امتیاز کاربران ★ 4.8 (452 رأی)
توسعه‌دهنده رسمی Tim W

📋 تفکیک گزارش تغییرات (Changelog) در ۲ نسخه اخیر

پایش لحظه‌ای تغییرات، وصله‌های امنیتی و ویژگی‌های اضافه شده در نسخه کنونی و نسخه پیشین از مخزن رسمی WordPress.org:

نگارش فعلی (Latest) نسخه 2.8.8
• غیرفعال‌سازی لینک‌ها در تمامی یادداشت‌های ویرایشگر و فیلدهای خطا جهت رفع آسیب‌پذیری CVE-2026-15066 • اعمال اصلاحات فنی لازم جهت سازگاری کامل با نسخه ۸.۵ پی‌اچ‌پی • ارتقای سازگاری افزونه با نگارش ۷.۰.۲ هسته وردپرس
📑 فهرست عناوین و سرفصل‌های این مقاله:

معماری داخلی و سازوکار بومی‌سازی در وردپرس با Loco Translate

افزونه Loco Translate یکی از ابزارهای حیاتی در اکوسیستم وردپرس است که فرآیند ترجمه رشته‌های متنی (String Translation) قالب‌ها و افزونه‌ها را مستقیماً از طریق پیشخوان وردپرس امکان‌پذیر می‌سازد. به جای وابستگی به نرم‌افزارهای دسکتاپ مانند Poedit و آپلود دستی فایل‌های زبان، این افزونه با اسکن کدهای سورس قالب‌ها و افزونه‌ها، توابع استاندارد بین‌المللی‌سازی وردپرس نظیر __()، _e() و esc_html__() را شناسایی کرده و کاتالوگ‌های ترجمه را استخراج می‌کند. از منظر معماری نرم‌افزار، Loco Translate فایل‌های منبع با پسوند POT را مبنای کار قرار داده و آن‌ها را به فایل‌های شیء زبان یعنی PO (قابل ویرایش توسط انسان) و MO (کامپایل‌شده و قابل خواندن توسط ماشین) تبدیل می‌کند. این فایل‌ها در مسیرهای استاندارد وردپرس مانند wp-content/languages ذخیره می‌شوند تا در هنگام به‌روزرسانی قالب یا افزونه، بازنویسی و حذف نشوند. این مکانیزم جداسازی کد از محتوای زبانی، پایداری سیستم را در چرخه حیات به‌روزرسانی‌ها تضمین می‌کند. مدیریت چرخه کامپایل فایل‌های MO به صورت خودکار توسط این افزونه انجام می‌شود که تأثیر مستقیمی بر performance بارگذاری صفحات دارد. هنگامی که یک درخواست HTTP به سرور ارسال می‌شود، وردپرس فایل‌های ترجمه کامپایل‌شده را به سرعت بارگذاری می‌کند تا متون رابط کاربری بدون تأخیر زمانی ترجمه شوند. در نتیجه، توسعه‌دهندگان و مدیران سایت نیازی به دانش عمیق درباره دستورات کامپایل ابزار GNU gettext نخواهند داشت و تمامی عملیات از طریق رابط کاربری گرافیکی افزونه مدیریت می‌شود.

حل چالش‌های بومی‌سازی و زبان فارسی در اکوسیستم وب ایران

بومی‌سازی وب‌سایت‌های فارسی‌زبان فراتر از ترجمه ساده واژگان انگلیسی به فارسی است و نیازمند انطباق دقیق با ساختارهای فرهنگی، زبانی و فنی خاص این حوزه است. افزونه Loco Translate به مدیران سایت اجازه می‌دهد تا اصطلاحات رایج در قالب‌ها و افزونه‌های تجاری و متن‌باز را با لحن و اصطلاحات متناسب با بازار هدف فارسی تطبیق دهند. این امر به ویژه در بخش‌های کاربری، حساب کاربری و فرآیندهای تسویه حساب اهمیتچندانی پیدا می‌کند. یکی از چالش‌های رایج در قالب‌ها و افزونه‌های خارجی، عدم هماهنگی توابع زمانی با تقویم جلالی و عدم تبدیل ارقام انگلیسی به فارسی یا عربی در بخش‌های حیاتی است. با استفاده از Loco Translate می‌توان کلمات کلیدی مربوط به ماه‌های میلادی، روزهای هفته و برچسب‌های زمانی را به معادل‌های دقیق هجری شمسی تغییر داد یا آن‌ها را برای هماهنگی با افزونه‌های تبدیل تاریخ آماده کرد. همچنین اصلاح نویسه‌های عربی (مانند کلمات دارای ی و ک عربی) در رشته‌های ترجمه شده، مانع از بروز مشکلات در جستجوی پایگاه داده و ایندکس شدن صحیح صفحات توسط موتورهای جستجو می‌شود. در حوزه تجارت الکترونیک فارسی، سازگاری واحدهای پولی با ساختارهای مالی کشور یک ضرورت انکارناپذیر است. درگاه‌های پرداخت، فاکتورهای فروش و سبد خرید افزونه‌هایی مانند ووکامرس نیازمند برچسب‌های مالیاتی، هزینه‌های ارسال و واحدهای پولی مشخص نظیر «تومان» یا «ریال» هستند. Loco Translate به طراحان سایت امکان می‌دهد تا به جای واحدهای پیش‌فرض دلاری یا یورو، واحدهای پولی محلی را به صورت ساختاریافته در تمامی بخش‌های قالب و افزونه‌های وابسته تزریق کنند بدون اینکه نیازی به دستکاری کدهای اصلی (Core) افزونه‌های مالی باشد.

بهینه‌سازی سئو، ساختار داده‌ها و یکپارچگی با افزونه‌های امنیتی و پیامک

از دیدگاه سئو فنی (Technical SEO)، ترجمه دقیق و اصولی متون سایت تأثیر مستقیمی بر نرخ پرش (Bounce Rate) و تجربه کاربری (UX) دارد. وقتی کاربران با رابط کاربری کاملاً فارسی، روان و بدون خطاهای نگارشی مواجه شوند، تعامل بیشتری با سایت خواهند داشت. افزونه Loco Translate با فراهم کردن امکان ترجمه متا تگ‌ها، رشته‌های مربوط به نقشه‌های سایت (Sitemaps) و متون جایگزین در افزونه‌های سئو، به موتورهای جستجو کمک می‌کند تا ساختار محتوایی سایت را به درستی درک کنند. در بخش امنیت و اعتبارسنجی کاربران، بسیاری از وب‌سایت‌های ایرانی از سیستم‌های ورود با کد تایید یکبار مصرف (OTP) از طریق پیامک استفاده می‌کنند. افزونه‌های امنیتی و احراز هویت پیامکی دارای رشته‌های متنی خاصی برای ارسال کدهای تایید، خطاهای ورود و محدودیت‌های تلاش ناموفق هستند. با استفاده از Loco Translate، مدیران سایت می‌توانند تمامی پیام‌های هشدار امنیتی و اطلاعیه‌های ورود را به زبان فارسی روان و قابل فهم برای کاربر تبدیل کنند که این امر امنیت روانی کاربر و اعتماد به سیستم را افزایش می‌دهد. علاوه بر این، مدیریت صحیح فایل‌های زبان از طریق Loco Translate از ایجاد خطاهای مهلک PHP نظیر تداخل در توابع ترجمه جلوگیری می‌کند. ذخیره‌سازی فایل‌های زبان در پوشه‌های امن و ایزوله شده، مانع از دسترسی غیرمجاز به فایل‌های سیستمی می‌شود. این افزونه با استفاده از قابلیت‌های ایمن‌سازی وردپرس، دسترسی به بخش ترجمه‌ها را به کاربران دارای نقش کاربری خاص (مانند مدیر کل) محدود می‌کند تا از تغییرات مخرب یا ناخواسته در رشته‌های ترجمه سیستم جلوگیری به عمل آید.

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

یکی از بزرگ‌ترین دغدغه‌های مدیران وب‌سایت‌ها پس از سفارشی‌سازی ترجمه‌ها، خطر از دست رفتن تغییرات هنگام به‌روزرسانی قالب‌ها و افزونه‌ها است. به صورت پیش‌فرض، اگر فایل‌های ترجمه درون دایرکتوری اصلی افزونه یا قالب ذخیره شوند، با هر بار آپدیت کردن آن پکیج توسط توسعه‌دهنده اصلی، تمام فایل‌ها بازنویسی شده و ترجمه‌های انجام شده نابود می‌شوند. Loco Translate با ارائه یک معماری ذخیره‌سازی هوشمند، این مشکل بنیادین را به طور کامل حل می‌کند. این افزونه مکانیسم ذخیره‌سازی فایل‌های PO و MO را در پوشه امن سراسری وردپرس یعنی wp-content/languages/plugins یا wp-content/languages/themes مدیریت می‌کند. این مسیرها به عنوان دایرکتوری‌های حفاظتی وردپرس شناخته می‌شوند که تحت هیچ شرایطی در هنگام به‌روزرسانی افزونه‌ها یا قالب‌های شخص ثالث دستکاری یا پاک نمی‌شوند. در نتیجه، سرمایه گذاری زمانی و فنی تیم توسعه‌دهنده برای بومی‌سازی دقیق متن‌ها حفظ شده و در به‌روزرسانی‌های بعدی دست‌نخورده باقی می‌ماند. علاوه بر این، قابلیت همگام‌سازی (Sync) در Loco Translate این امکان را فراهم می‌کند که با انتشار نسخه جدید یک افزونه یا قالب و اضافه شدن توابع و رشته‌های جدید، توسعه‌دهنده نیازی به ترجمه مجدد کل سیستم نداشته باشد. با یک کلیک ساده، افزونه رشته‌های جدید را با فایل‌های ترجمه قبلی تطبیق داده و صرفاً عبارات جدید و ترجمه‌نشده را برای ویرایش نمایش می‌دهد که این مکانیزم بهینه‌سازی، کارایی مدیریت محتوا را به شکل چشمگیری افزایش می‌دهد.

❓ سوالات متداول درباره لوکو ترنسلیت (Loco Translate)

پاسخ به سوالات و چالش‌های فنی وبمسترها، طراحان سایت و مدیران سرور درباره افزونه لوکو ترنسلیت (Loco Translate) در این بخش گردآوری شده است:

این مشکل به دلیل ذخیره شدن فایل‌های ترجمه در دایرکتوری اختصاصی خود افزونه به جای پوشه سراسری وردپرس رخ می‌دهد. برای حل ریشه‌ای این مشکل، باید محل ذخیره‌سازی فایل‌های PO و MO را از تنظیمات Loco Translate به مسیر امن wp-content/languages منتقل کنید تا در آپدیت‌های بعدی بازنویسی نشوند.
برخی کدهای استاندارد نیستند و از توابع ترجمه gettext استفاده نمی‌کنند. برای این کار ابتدا باید کد منبع را اصلاح کرده و متن را درون توابع ترجمه وردپرس قرار دهید. پس از آن، Loco Translate قادر خواهد بود آن رشته را شناسایی کرده و فایل‌های زبان را برای آن کامپایل کند.
خیر. Loco Translate تنها در پیشخوان وردپرس و هنگام ویرایش یا کامپایل فایل‌ها فعالیت می‌کند. در فرانت‌اند سایت، وردپرس مستقیماً فایل‌های کامپایل‌شده MO را بارگذاری می‌کند که بسیار سبک و بهینه هستند و هیچ سربار پردازشی (CPU Overhead) اضافه‌ای ایجاد نمی‌کنند.
وردپرس از یک اولویت‌بندی مشخص برای بارگذاری فایل‌های زبان پیروی می‌کند. فایل‌هایی که در پوشه عمومی languages/plugins قرار دارند بر فایل‌های درون پوشه افزونه اولویت دارند. با تنظیم دقیق مسیرها در Loco Translate و اطمینان از عدم وجود نسخه‌های قدیمی متناقض در پوشه‌های دیگر، این تداخل به طور کامل مدیریت می‌شود.