إضافة Multilingual Tools هي إضافة اختبار يمكنك استخدامها عند تسجيل ودجات Elementor المخصصة للترجمة. تتضمن الإضافة أداة WPML – Config Generator for Elementor التي تنشئ تلقائياً الإصدار الأول من كود XML لهذه الودجات المخصصة.
باستخدام هذه الأداة، ستتمكن من الحصول على المعلومات التي تحتاجها لـ تسجيل ودجتك.
هذا الدليل مخصص للمطورين الذين يبنون قوالب وإضافات Elementor ويرغبون في جعلها متوافقة مع WPML. إذا لم تكن مطوراً، فاطلع على دليلنا حول كيفية ترجمة موقع Elementor باستخدام WPML بدلاً من ذلك.
البدء
للبدء:
- نزّل إضافة Multilingual Tools (يفتح في علامة تبويب جديدة) من صفحة OnTheGoSystems على GitHub.
- تأكد من تثبيت وتفعيل إضافة WPML Multilingual CMS الأساسية وملحق WPML ترجمة النصوص على موقعك.
- تأكد من وجود بعض المحتوى المنشأ مسبقاً باستخدام Elementor على موقعك.
لماذا يجب استخدام إضافة Multilingual Tools
في إصدار WPML 4.9 والإصدارات الأحدث، يتعرف WPML تلقائياً على ودجات Elementor المخصصة ويجعلها قابلة للترجمة. ومع ذلك، قد يسجل سلاسل نصية لا ترغب في ترجمتها.
لهذا السبب نوصي باستخدام Multilingual Tools لتسجيل ودجة Elementor المخصصة الخاصة بك للترجمة. يمنحك هذا تحكماً دقيقاً في الحقول القابلة للترجمة.
كيفية العمل
عندما تنشئ صفحة باستخدام أداة بناء الصفحات Elementor، يتم حفظ كل المحتوى في الحقل المخصص _elementor_data.
بمجرد إضافة الودجات المخصصة التي تريد تسجيلها للترجمة إلى صفحة ما، تصل أداة WPML – Config Generator for Elementor إلى هذا الحقل _elementor_data لقراءة محتوياته. بعد القراءة، تحوّل البيانات إلى كود XML يتوافق مع الودجات المخصصة التي استخدمتها في صفحتك.
إنشاء كود XML باستخدام أداة WPML — Config Generator
لإنشاء كود XML تلقائياً لودجاتك المخصصة:
- أنشئ صفحة جديدة وانقر على التحرير بواسطة Elementor.
- أضف الودجات المخصصة التي تريد تسجيلها للترجمة إلى الصفحة.
هام: عند إضافة ودجتك لجعلها قابلة للترجمة، تأكد من ملء جميع الحقول وتمكين جميع الخيارات المتاحة.
ذلك لأن أداة WPML – Config Generator for Elementor لا تنشئ كود XML لأي حقل أو خيار غير مكوّن.
- انشر الصفحة وعد إلى شاشة تحرير WordPress لتلك الصفحة. افتح لوحة Meta Boxes ومرر إلى WPML – Config Generator for Elementor. بدءاً من WPML 4.9، تُسجّل WPML ودجات Elementor المخصصة بنفسها، لذا يشير المربع الموجود أعلى ذلك القسم إلى أن ودجات الصفحة مسجلة بالفعل. كود XML الذي تحتاجه موجود في اللوحة الموجودة أسفله، WPML Config XML (generated for all widgets in the page).
اختبار كود XML المنشأ تلقائياً
قبل إتاحة الكود للمستخدمين النهائيين، تأكد من مراجعته واختباره بدقة. تُعد أداة WPML – Config Generator for Elementor مجرد نقطة بداية.
لاختبار كود XML المنشأ تلقائياً:
- انسخ كود XML من لوحة WPML Config XML (generated for all widgets in the page) في شاشة تحرير WordPress لصفحتك التي تحتوي على الودجات المخصصة.
- اذهب إلى WPMLإعدادات وانقر على علامة التبويب تكوين XML مخصص.
- ألصق الكود في المحرر واضغط على زر حفظ. تحقق من عدم ظهور أي تحذيرات أو أخطاء في التحقق. تأكد من إزالة أي حقول لا ينبغي ترجمتها أو تعديلها من قبل المستخدمين، مثل حقول التكوين والحقول ذات القيم المنطقية (boolean). قد يتسبب ترك هذه الحقول متاحة للترجمة في حدوث مشكلات وأخطاء للمستخدمين النهائيين.
- عد إلى شاشة تحرير الصفحة التي تحتوي على الودجات المخصصة. أجرِ تغييراً صغيراً على الصفحة، مثل تعديل عنوان الصفحة، وانقر على تحديث.
- من مربع اللغة، انقر على أيقونة الزائد لترجمة الصفحة. سيُفتح محرر الترجمة المتقدم ويجب أن ترى الحقول المسجلة من الودجت المخصصة متاحة للترجمة. راجع الترجمات التلقائية أو أدخل ترجماتك الخاصة وانقر على حفظ وإكمال عند الانتهاء.
- ألقِ نظرة على الصفحة المترجمة في الواجهة الأمامية للتأكد من ظهور حقول الودجة المخصصة بشكل صحيح.
استخدام ميزات الفحص الإضافية
اللوحة التي تحتوي على XML هي واحدة من أربع لوحات. واللوحات الأخرى هي معلومات تصحيح الأخطاء التي تحتفظ بها WPML – Config Generator for Elementor بجانبها.
تتيح لك هذه المعلومات فحص وفهم البيانات الأساسية وكيفية استخدامها. قد تكون مفيدة في حالات معينة، مثل عندما لا يعمل كود XML كما هو متوقع.
WPML Config XML (تم إنشاؤه لجميع الودجات في الصفحة)
ما يفعله: يوفر كود XML لجميع الودجات الموجودة في الصفحة، بما في ذلك تلك المسجلة مسبقاً للترجمة.
لماذا هو مفيد: يتيح لك مراجعة أو تعديل كود XML لإعدادات الودجة الحالية.
قيمة RAW من _elementor_data (JSON)
ما يفعله: يعرض القيمة الأصلية لحقل _elementor_data الخاص بالمقالة.
لماذا هو مفيد: يتيح لك رؤية البيانات التي تستخدمها أداة WPML – Config Generator for Elementor Widgets لإنشاء كود XML.
المصفوفة المنشأة من _elementor_data
ما يفعله: يوفر قيمة حقل _elementor_data الخاص بالمقالة، محولة إلى مصفوفة.
لماذا هو مفيد: يمكنك استخدام المصفوفة لأغراض تصحيح الأخطاء.
الودجات المستخرجة من _elementor_data
ما يفعله: يعرض الودجات المخصصة التي تمكنت الإضافة من استخراجها واستخدامها من حقل _elementor_data.
لماذا هو مفيد: إذا لم ترَ ودجة مخصصة، أو حقل ودجة مخصصة، أو خيار ودجة مخصصة هنا، فلن تتم إضافته إلى XML. هذا مفيد لتصحيح الأخطاء.
