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

يتم ضمان توافق WPBakery Page Builder مع WPML من خلال ملف تكوين اللغة. تعرّف على كيفية استخدام هذا الملف للحفاظ على التوافق.

هذه الصفحة مخصصة لفريق تطوير WPBakery، والمطورين الذين يقدمون نسخة مخصصة من أداة بناء الصفحات، والمطورين الذين يبرمجون ملحقات لـ WPBakery، ومطوري الويب الذين يستخدمون WPBakery Page Builder.

إذا كنت عميلاً يتطلع إلى ترجمة موقع مبني باستخدام WPBakery، فيرجى الاطلاع على وثائقنا المفصلة لمعرفة المزيد حول بناء مواقع متعددة اللغات باستخدام WPBakery Page Builder وWPML.

كيف يعمل تكامل WPBakery Page Builder مع WPML

لفهم كيفية عمل WPBakery Page Builder مع WPML، سنبدأ بإنشاء صفحة بسيطة باستخدام WPBakery Page Builder. سنقوم بتضمين بعض الوحدات، مثل Text Block، وMessage Box، وHover Box.

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

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

تحديث ملف تكوين اللغة

قد تحتاج إلى تحديث الأكواد المختصرة لأداة بناء الصفحات في ملف تكوين اللغة لأسباب مختلفة:

1. إضافة كود مختصر جديد إلى أداة بناء الصفحات
2. إضافة سمة جديدة إلى كود مختصر موجود
3. إزالة كود مختصر قديم

يمكنك تنزيل ملف تكوين اللغة من مستودعنا. أضف الأكواد المختصرة أو السمات إلى الأكواد المختصرة الموجودة داخل ملف تكوين اللغة.

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

بنية الكود المختصر لأداة بناء الصفحات في ملف تكوين اللغة

لاستخراج السلاسل النصية من الصفحات المبنية باستخدام WPBakery Page Builder وتحميلها في شاشة محرر الترجمة، نحتاج إلى تكوين WPML للتعرف على الأكواد المختصرة والسمات التي تحتوي على السلاسل النصية التي تتطلب الترجمة. يتم ذلك عن طريق إضافة ملف يُسمى wpml-config.xml، والذي يوضع عادةً في المجلد الجذري لقالبك. بالنسبة لـ WPBakery Page Builder، نحن نستضيف ملف تكوين اللغة على خوادمنا. تم إعداده لتجاوز ملف التكوين المحلي الموجود في المجلد الجذري لـ WPBakery Page Builder، مما يضمن أن يكون ملف التكوين محدثاً دائماً.

يُستخدم ملف wpml-config.xml أيضاً لتكوين العناصر التالية:

1. الحقول المخصصة
2. التصنيفات المخصصة
3. نصوص المسؤول / wp_options
4. تكوين مبدل اللغة
5. الأكواد المختصرة لأداة بناء الصفحات

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

كمثال، دعنا نرى كيف أضفنا الكود المختصر Tabs إلى ملف wpml-config.xml.

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

يمكن تقسيم بنية المثال أعلاه على النحو التالي:

• تُغلف جميع الأكواد المختصرة بالوسم الرئيسي shortcodes (بصيغة الجمع).
• يُغلف الوسم shortcode جميع الوسوم التي تنتمي إلى كود مختصر واحد.
• يحدد الوسم tag اسم الكود المختصر، والذي هو في هذه الحالة vc_tta_tabs.
• يمكن أن تحتوي الأكواد المختصرة على سمة واحدة أو أكثر؛ وبالتالي، نغلفها في الوسم attributes (بصيغة الجمع) ونستخدم الوسم attribute (بصيغة المفرد) لتحديد عنوان كل سمة. في هذه الحالة، لدينا السمة title.

بالنسبة للأكواد المختصرة التي تتضمن سمات روابط، يمكنك جعل الروابط الداخلية تشير تلقائياً إلى النسخة المترجمة من تلك المقالة باستخدام الخيار type للسمة. إليك مثال:

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

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

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

1. قم بإعداد تثبيت يحتوي على كل من WPBakery Page Builder وWPML مفعلين. قم بتنزيل وتفعيل ملحقي ترجمة النصوص وترجمة الوسائط.
2. ستحتاج إلى تجاوز ملف تكوين اللغة البعيد بالملف المحدّث. للقيام بذلك، انتقل إلى صفحة WPML → إعدادات وانقر على علامة التبويب تكوين XML مخصص. انسخ محتوى ملف تكوين اللغة المحدّث إلى المحرر، ثم انقر على حفظ.

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

4. انقر على أيقونة الجمع لترجمة الصفحة. سينقلك هذا إلى شاشة محرر الترجمة المتقدم.
5. تأكد من عرض العناصر النصية للوحدة في محرر الترجمة المتقدم.
6. املأ ترجماتك وأكّدها بعلامة الصح الخضراء. بمجرد الانتهاء، انقر على زر مكتمل.

7. تحقق من الصفحة المترجمة في الواجهة الأمامية.

تعرض الصفحة المترجمة جميع السلاسل النصية المترجمة، مما يعني أن ملف تكوين اللغة المحدّث يعمل بشكل صحيح.

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

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

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

يرجى ملاحظة أن ملف تكوين اللغة المستضاف في مستودعنا مخصص للنسخة الافتراضية من WPBakery Page Builder. في حال كنت تقوم بتحديث ملف تكوين اللغة لنسخة مخصصة من WPBakery Page Builder، قم بتطبيق التغييرات على ملف التكوين داخل المجلد الجذري لإضافتك.