شرح الإضافة
الإضافة بتعمل إيه
Free Translator بتترجم نصوص واجهة EspoCRM (أسماء الحقول والعلاقات واختيارات القوائم والأزرار والرسائل) من لغة متثبتة للغة تانية، وبتحفظها كملفات لغة مخصصة مبتتمسحش مع تحديثات Espo.
أهم المميزات
- 3 مزودين للترجمة: MyMemory (مجاني)، LibreTranslate (على سيرفرك)، وOpenRouter (موديلات ذكاء اصطناعي زي GPT-4o-mini).
- محرر ترجمة: النص الأصلي والترجمة الحالية جنب بعض، تعدّل أي سطر وتحفظ.
- الوضع الذكي: قاموس CRM عربي مدمج، وذاكرة ترجمة بتعيد استخدام الجمل المعتمدة، وبديل عربي يشتغل من غير إنترنت.
- ترجمة جماعية: Translate All وSmart Translate All وTranslate Module بيشتغلوا عنصر بعنصر مع عرض التقدم، ولو عنصر فشل الباقي بيكمّل.
- AI Improve: مع OpenRouter الموديل بيراجع الترجمات الظاهرة ويحسّنها.
- فحص الناقص: بيعد السطور اللي لسه مش مترجمة ويعلّم عليها.
- بتحافظ على ترجمات Espo الأصلية ومبتكتبش نصوص فاضية أبدًا.
طريقة الاستخدام
- افتح Administration ← Free Translator.
- اختار Provider (لو OpenRouter حط الـ API key، ولو MyMemory ممكن تضيف إيميل يزوّد الكوتة المجانية).
- اختار Source Language (غالبًا en_US) وTarget Language (مثلًا ar_AR).
- اختار عنصر أو أكتر من Entity / Module File (Ctrl/Cmd + Click لأكتر من عنصر)، واستخدم Fields / Links / Options / Labels لتحديد الأقسام.
- دوس Translate للعنصر المختار، أو Translate All / Smart Translate All لعناصر كتير.
- راجع السطور في المحرر (فلتر: Missing / Manual / Ready)، عدّل أي نص، ودوس Save Edits.
- ادخل Administration ← Clear Cache واعمل reload للصفحة عشان تشوف النصوص الجديدة.
الإعدادات والصلاحيات
- الصفحة والـ API للأدمن بس.
- مفاتيح الـ API بتتحفظ على السيرفر ومبتظهرش تاني في المتصفح، وسيب الخانة فاضية عشان تحتفظ بالمفتاح المحفوظ.
- Clear memory بيمسح كل الجمل المحفوظة، وClean bad languages بيشيل لغة ar_EG الغلط من قائمة اللغات.
ملاحظات
- خدمة MyMemory المجانية ليها كوتة يومية، ولما تخلص الأداة بتنبهك وبتملى السطور العربي من القاموس المدمج — راجع السطور دي.
- الترجمة الآلية نقطة بداية: راجع النصوص المهمة قبل الحفظ.
- ترجمة ملفات الإضافات التانية بتتكتب جوه فولدر الإضافة نفسها، فأعد ترجمتها بعد تحديث الإضافة دي.
التثبيت والتفعيل
- نزّل ملف الإضافة من اللينك اللي هيوصلك مع مفتاح الترخيص.
- من EspoCRM: Administration ← Extensions ← Upload ← Install.
- من Administration ← Integrations افتح ترخيص الإضافة، فعّله، والصق المفتاح، واحفظ.
- هتلاقي شرح الإضافة وحالة الترخيص في صفحة الإضافة جوه الـ Administration.
سجل التغييرات
v2.5.0 Minor 2026-10-11
- إصلاح All translator endpoints are now restricted to administrators.
- إصلاح Language codes and entity/module names are validated before any file is written (path traversal fix).
- تغيير API keys are no longer sent to the browser; an empty key field keeps the saved key.
- إصلاح Empty values are no longer saved, so labels never turn blank in the CRM.
- إصلاح MyMemory quota warnings are detected instead of being saved as translations; optional contact e-mail raises the free quota.
- تحسين Espo's built-in translations are shown in the editor and are not re-translated or duplicated.
- تحسين OpenRouter translates up to 25 rows per request, and AI Improve now really reviews translations with the model.
- تحسين Smart Translate All and Translate Module run item by item with progress, so they no longer time out, and one failed item doesn't stop the run.
- جديد Provider errors are shown clearly, and translation stops calling a failing provider after 3 errors.
- إصلاح Label keys containing dots (e.g. "e.g.") are saved correctly, and section filters work in Translate.