الحفاظ على توافق Divi Builder مع WPML

تعرف على كيفية الحفاظ على توافق وحدات Divi مع WPML من خلال ملف تكوين اللغة wpml-config.xml.

هذه الوثائق مخصصة لفريق تطوير Divi ومطوري الويب الذين يستخدمون Divi. وهي تشرح عملية الحفاظ على توافق Divi Builder مع WPML، والتي تتم عن طريق تحديث ملف تكوين اللغة.

تشير هذه الصفحة إلى Divi 5 الذي يخزن المحتوى ككتل متوافقة مع Gutenberg (كان Divi 4 يستخدم الأكواد المختصرة).

كيفية عمل تكامل Divi Builder مع WPML

لفهم كيفية عمل Divi Builder مع WPML، لنبدأ بإنشاء صفحة بسيطة باستخدام Divi Builder. لقد أضفنا بعض الوحدات في مثالنا أدناه، مثل Text، و Number Counter، و Icon، وما إلى ذلك.

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

استخدام ملف تكوين اللغة

في ملف wpml-config.xml، يمكنك تكوين العناصر التالية:

• كتل أداة بناء الصفحات
• الحقول المخصصة
• التصنيفات المخصصة
• نصوص المسؤول / wp_options
• تكوين مبدل اللغة

لمزيد من المعلومات حول البنية والصياغة، راجع دليل ملف تكوين اللغة الخاص بنا.

الحصول على ملف التكوين لـ Divi

يؤدي تكوين ملف wpml-config.xml إلى استخراج السلاسل النصية من الصفحات التي تم إنشاؤها باستخدام Divi Builder وتحميلها في محرر الترجمة المتقدم. استخدم هذا الملف لإضافة أنواع كتل وسمات جديدة، بالإضافة إلى إزالة أنواع الكتل القديمة.

يمكنك تنزيل ملف تكوين اللغة من مستودعنا ووضعه في المجلد الجذري لقالبك بمجرد تكوينه.

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

تكوين الكتل في ملف تكوين اللغة

يستخدم Divi 5 صياغة الكتل، لذا فإن تسجيل وحدات Divi للترجمة يشبه عملية ترجمة كتل Gutenberg:

• يتم تغليف جميع تعريفات الكتل داخل عنصر أصلي <gutenberg-blocks>.
• يتم الإعلان عن كل كتلة فردية باستخدام عنصر <gutenberg-block>، حيث تتوافق السمة type مع الاسم المسجل للكتلة.
• يتم الإعلان عن الحقول القابلة للترجمة كعناصر فرعية <key>.

لنأخذ مثالاً على وحدة Call to Action في Divi:

<!-- wp:divi/cta {"module":{"title":"CTA","button_text":"Contact Us","button_url":"https://example.com/contact/"}} /-->

إليك كيفية تكوينها في wpml-config.xml:

<gutenberg-blocks>
    <gutenberg-block type="divi/cta" translate="1">
       <key name="module">
         <key name="title" />
         <key name="button_text" />
         <key name="button_url" type="link" />
       </key>
    </gutenberg-block>
</gutenberg-blocks>

تتوزع البنية على النحو التالي:

• يغلف العنصر <gutenberg-blocks> جميع تعريفات الكتل.
• يحدد العنصر <gutenberg-block> نوع كتلة واحد، يتم تحديده بواسطة السمة type. يخبر translate="1" WPML بمعالجة هذا.
• يحدد كل عنصر <key> حقلاً واحداً قابلاً للترجمة: title و button_text لحقول النص العادي، و button_url للرابط.
• تخبر السمة type="link" WPML باستبدال عنوان URL تلقائياً بالنسخة المترجمة من المقالة أو الصفحة المرتبطة.

اختبار ملف تكوين اللغة

لاختبار ملف تكوين اللغة المحدث، اتبع هذه الخطوات:

1. أعدّ موقعاً مع تفعيل كل من Divi و WPML. تأكد أيضاً من تفعيل ملحقي ترجمة النصوص و ترجمة الوسائط.

2. لتجاوز ملف تكوين اللغة عن بُعد بالنسخة المحدثة، انتقل إلى WPML → إعدادات وانقر على علامة التبويب تكوين XML مخصص. انسخ محتوى ملف تكوين اللغة المحدث إلى المحرر ثم انقر على حفظ.

3. أنشئ صفحة جديدة، وأضف الوحدة (الوحدات) الجديدة إليها. إذا قمت بتحديث بعض السمات للوحدات الموجودة، أضفها إلى الصفحة أيضاً. في هذا المثال، سنفترض أن وحدة Button تمت إضافتها حديثاً إلى Divi Builder. أضفها إلى الصفحة ثم انقر على نشر.

4. لترجمة الصفحة التي تحتوي على الزر، يمكنك استخدام لوحة إدارة الترجمة. كبديل، يمكنك استخدام محرر الترجمة المتقدم (ATE)، والذي يمكن أن يكون مفيداً عند الاختبار — فهو يتيح لك رؤية وسم الوحدة لكل عنصر Divi في الصفحة. لفتح ATE، اذهب إلى تعديل الصفحة وانقر على أيقونة الجمع أسفل مربع اللغة في الشريط الجانبي الأيمن.

5. تحقق من العناصر، وأضف ترجماتك أو اسمح لـ ATE بالترجمة تلقائياً.

الآن، يمكنك إلقاء نظرة على الصفحة المترجمة في الواجهة الأمامية. يجب أن تعرض الصفحة المترجمة جميع السلاسل النصية المترجمة، مما يعني أن ملف تكوين اللغة المحدث يعمل بشكل صحيح.

في حال واجهت أي مشاكل، يرجى الاتصال بفريق تطوير التوافق لدينا. سيسعدهم التحقق من المشاكل المتعلقة بملف تكوين اللغة.

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