ترجمة إضافات WooCommerce

الإضافات المباعة على WooCommerce.com جاهزة للترجمة ويمكن استخدامها مع أي إضافة للترجمة. بعضها يحتوي حتى على ترجمات مدمجة، ويسعدنا دائماً العمل مع المترجمين لزيادة تغطية الترجمة!

إذا كنت مهتماً بترجمة وووكامرس أو إضافاتها، يُرجى مراجعة هذا المستند حول التوطين (localization) للبدء.

استخدام ترجمة مدمجة (Using a Bundled Translation)

إذا كانت الإضافة تحتوي على ترجمة مدمجة، فسوف يتم تحميلها تلقائياً عند تغيير لغة موقعك بعيداً عن الإنجليزية. نحاول تضمين ترجمات كاملة كلما أمكن ذلك، ولكننا سنقوم بتضمين ترجمات جزئية إذا لم تتوفر ترجمة كاملة، لذا فقد تكون بعض النصوص مفقودة من الترجمة.

إذا قمت بناء ترجمتك الخاصة وتريد تقديمها للتضمين، يُرجى التواصل مع مكتب المساعدة الخاص بنا لتمرير الترجمة إلى مطور الإضافة.

إنشاء ترجمة جديدة (Generating a New Translation)

إذا كنت ترغب في ترجمة إضافة إلى لغتك الخاصة يدوياً، ستكون أداة gettext مثل PoEdit مفيدة. يُرجى التأكد من معرفتك بكيفية ترجمة ملف .pot بشكل صحيح، وستكون هذه الدروس مفيدة:

• ترجمة إضافة ووردبريس (Translate a WordPress Plugin)
• ترجمة قوالب أو إضافات ووردبريس (Translate WordPress Themes or Plugins)

ستحتاج إلى بضعة أمور لبدء الترجمة:

• أداة gettext المفضلة لديك، أي PoEdit (موصى بها) أو LocoTranslate
• نطاق النص (textdomain) الخاص بالإضافة. إذا لم تكن متأكداً من نطاق النص الذي يجب استخدامه، فإنه عادةً ما يُذكَر في أعلى ملف الإضافة الرئيسي — قم بتنزيل الإضافة، وفك ضغطها، وافتح المجلد، وانظر في الملف الذي يحمل نفس اسم الإضافة (لن يكون في مجلد فرعي، بل سيكون دائماً في المجلد الرئيسي).
• ملف .pot الخاص بالإضافة — عادة ما يكون في مجلد /languages/ أو مجلد /i18n/ داخل الإضافة.

بمجرد حصولك على نطاق النص الخاص بالإضافة وملف .pot الخاص بها، يمكنك البدء في الترجمة

عند الانتهاء، يمكنك إضافة ترجماتك إلى نفس المجلد الذي وجودت فيه ملف .pot. تأكد من تسميتها بشكل صحيح!

على سبيل المثال، إذا كان ملف .pot الخاص بالإضافة يحمل اسم woocommerce-plugin-textdomain.pot، فيجب أن تُسمّى ملفات الترجمة الخاصة بك woocommerce-plugin-textdomain-aa_AA.po و woocommerce-plugin-textdomain-aa_AA.mo، حيث aa_AA هو كود لغتك (على سبيل المثال، fr_FR).

تحتوي بعض الإضافات على نطاق نص (text-domain) مختلف مقارنة باسم ملف .pot. وفي هذه الحالة، يُرجى التأكد من أن ملفات الترجمة تتطابق مع نطاق النص وليس مع اسم ملف .pot المضمن مع الإضافة.

إذا كنت تريد حفظ ترجماتك في حال ترقيات الإضافة، يمكنك أيضاً نقلها إلى مجلد ووردبريس الأساسي — يمكن حفظ ترجمات الإضافة في:

wp-content/languages/plugins/woocommerce-plugin-textdomain-aa_AA.po

سيحمل مجلد wp-content/languages/plugins/ الترجمات لأي إضافة. يمكنك تخزين ترجمتك المخصصة بأمان هناك ولن يتم استبدالها بتحديثات الإضافة.

ملاحظة رقم 1: يقدم Loco Translate ثلاثة مواقع مختلفة لمكان إنشاء الترجمة. الخيار الأفضل لترجمتك الخاصة هو Custom (مخصص)، ليس فقط لمنع التحديثات من إلغاء الترجمات المخصصة، ولكن أيضاً لأنه مطلوب للترجمة الصحيحة للنصوص في إضافات مثل WooCommerce Subscriptions.

تجنب موقع Author (المؤلف) لأنه داخل الإضافة وسيتم استبداله بتحديثات الإضافة، وكذلك موقع System (النظام)، والذي يمكن استبداله بالترجمات من translate.wordpress.org.

ملاحظة رقم 2: إذا واجهت أي مشاكل تقنية أثناء استخدام Loco Translate، يُرجى التواصل مع فريق دعم Loco Translate.

ترجمة إضافات SkyVerge (Translating SkyVerge Extensions)

تستخدم إضافات SkyVerge هيكلاً أساسياً (skeleton) مشتركاً للتطوير، ونتيجة لذلك، سيكون للإضافة نطاق نص وترجمة، بالإضافة إلى نطاق نص وترجمة للهيكل الأساسي. على هذا النحو، قد تكون بعض النصوص في إضافتك جزءاً من الهيكل الأساسي.

يمكنك ترجمة الهيكل الأساسي تماماً مثل الإضافة، ولكن سيحتاج حفظ ترجمته إلى موقع مختلف (مع ميزة أنه إذا ترجمتها مرة واحدة، فسوف تنطبق على جميع إضافات SkyVerge التي تستخدم تلك النصوص).

نوصي بترجمة ما تحتاجه من الهيكل الأساسي/الإطار باتباع الخطوات أدناه، ثم الانتقال إلى نصوص الإضافة باتباع الخطوات الواردة في القسم أعلاه.

إليك بعض الخطوات لتجمة إطار إضافة SkyVerge — تأكد من استبدال nb_NO في الخطوات أدناه بنطاق النص المناسب لترجمتك.

إذا كنت قد بدأت بالفعل ترجمة ملف .pot للإطار، يمكنك تخطي الخطوات من 1 إلى 5 وإعادة تسمية ملفي .po و .mo إلى woocommerce-plugin-framework-nb_NO.po و woocommerce-plugin-framework-nb_NO.mo.

1. في إضافتك، ابحث عن ملف woocommerce-plugin-framework.pot في أحد الموقعين التاليين (ستحتوي إضافتك على أحد هذين الموقعين فقط):
   

   vendor/skyverge/wc-plugin-framework/woocommerce/i18n/languages/woocommerce-plugin-framework.pot
   lib/skyverge/woocommerce/i18n/languages/woocommerce-plugin-framework.pot

2. افتح ملف woocommerce-plugin-framework.pot في PoEdit أو ما يعادله وانقر على Create New Translation (إنشاء ترجمة جديدة).
   
   
3. قم بتعيين لغة الترجمة وانقر على OK
   
   
4. حدد File > Save ثم احفظ الملف على جهاز الكمبيوتر الخاص بك، مع التأكد من تسميته تماماً woocommerce-plugin-framework-nb_NO.po (يجب إضافة الامتداد .po تلقائياً بواسطة التطبيق).
5. ترجم بعض النصوص وانقر على File > Compile to MO… وتأكد من تسمية الملف تماماً woocommerce-plugin-framework-nb_NO.mo
6. بمجرد إجراء بعض الترجمات التجريبية، قم بتحميل ملفي .po و .mo عبر FTP إلى مجلد wp-content/languages/woocommerce-plugin-framework/ في موقعك (قد تضطر غالباً إلى إنشاء هذا المجلد). يجب أن يكون للملفين المسارين التاليين:
   

   wp-content/languages/woocommerce-plugin-framework/woocommerce-plugin-framework-nb_NO.mo
   wp-content/languages/woocommerce-plugin-framework/woocommerce-plugin-framework-nb_NO.po

7. قم بزيارة الواجهة الأمامية أو لوحة تحكم موقعك للتحقق مما إذا كانت الترجمات الجديدة قد تم التقاطها. إذا لم يكن الأمر كذلك، فيرجى إرسال بيانات اعتماد المسؤول (admin) و FTP وسنسعد أكثر بالمساعدة في تحري الخلل وإصلاحه.
8. بافتراض نجاح اختبار الترجمة، أكمل الترجمات على جهاز الكمبيوتر المحلي الخاص بك، وأعد تجميع ملف MO عندما تكون راضياً، ثم قم بتحميل الملفين مرة أخرى إلى مجلد wp-content/languages/woocommerce-plugin-framework/.

إذا كنت ترغب في تقديم ترجمة لـ woocommerce-plugin-framework، فيرجى فتح مشكلة (issue) أو طلب سحب (pull request) على GitHub.

العمل مع WPML (Working with WPML)

إذا كنت ترغب في استخدام لغات متعددة أو عرض لغة تختلف عن لغة موقعك، فسوف تلعب أداة متعددة اللغات مثل WPML دوراً أساسياً. يحتوي WPML على مستند متاح حول ترجمة الإضافات.

استخدام WPML مع وووكامرس يتطلب تثبيت إضافة وووكامرس متعددة اللغات (WooCommerce Multilingual plugin)، والتي يمكن لفريقهم مساعدتك فيها من حيث الإعداد والتكوين.

العمل مع Loco Translate (Working with Loco Translate)

تعتبر Loco Translate نهجاً قوياً في إدارة لغاتك في وووكامرس.