تسجيل محتوى أداة بناء الصفحات للترجمة

تعرّف على كيفية تسجيل محتوى أداة بناء الصفحات المخصص للترجمة باستخدام ملف wpml-config.xml. سجّل السلاسل النصية، والوسائط، وودجات أداة بناء الصفحات، ومعرفات الأكواد المختصرة، والمزيد.

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

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

هل تحتاج إلى إنشاء ملف wpml-config.xml؟ تفضل بزيارة دليلنا التفصيلي حول الإنشاء التلقائي لملف التكوين باستخدام إضافة Multilingual Tools.

ترجمة السلاسل النصية

لنأخذ مثالاً حيث لديك فاصل نصي مضاف إلى صفحة باستخدام Visual Composer. يحتوي هذا الفاصل على عنوان، ويبدو الكود المختصر الخاص به كما يلي:

[vc_text_separator title="Separator Title"]

لكي تتمكن من ترجمة عنوان هذا الفاصل النصي، تحتاج إلى إضافة بضعة أسطر إلى ملف wpml-config.xml الخاص بك. بهذه الطريقة، «سيعرف» WPML أن عنوان هذا الفاصل يحتاج إلى ترجمة.

الكود التالي هو مثال على ما تحتاج إلى إضافته إلى ملف wpml-config.xml في هذه الحالة.

<wpml-config>
  <shortcodes>
    <shortcode>
        <tag>vc_text_separator</tag>
        <attributes>
            <attribute>title</attribute>
        </attributes>
    </shortcode>
  </shortcodes>
</wpml-config>

دعنا نراجع بنية المثال أعلاه:

• ابدأ بوسم shortcodes. يجب وضع أي أكواد مختصرة في موقعك تحتاج إلى ترجمة أسفل هذا الوسم.
• استخدم وسم shortcode لتغليف جميع الوسوم التي تنتمي إلى كود مختصر واحد.
• استخدم الوسم المسمى tag لتحديد اسم الكود المختصر. في هذه الحالة، هو vc_text_separator. إذا كنت تفضل ذلك، يمكنك إضافة تسميات مخصصة اختيارية إلى الوسوم. ستُعرض هذه التسميات بجوار النص في كل من محرر الترجمة المتقدم ومحرر الترجمة الكلاسيكي. تتضمن ملفات XLIFF المُصدّرة أيضاً هذه التسميات. راجع المثال أدناه لمعرفة كيفية إضافة التسميات إلى الوسوم والسمات.
• يمكن أن تحتوي الأكواد المختصرة على سمة واحدة أو أكثر، لذا تحتاج إلى تغليفها في وسم attributes (الجمع) واستخدام وسم attribute (المفرد) لتحديد عنوان كل سمة.

تتضمن أدوات بناء الصفحات (أحياناً) عناصر تصميم تحتوي على سمات روابط.

يمكنك جعل الروابط الداخلية تشير تلقائياً إلى النسخة المترجمة من تلك المقالة باستخدام خيار الرابط: type="link".

يمكنك استخدام سمة encoding مع هذا الخيار. فهي تتعامل مع التشفير الخاص الذي تستخدمه أدوات بناء الصفحات المختلفة. عادةً ما تكون سمة التشفير خاصة بأداة بناء الصفحات التي تستخدمها. وهي تقبل القيم التالية:

• base64 – كود HTML المختصر الخام لـ Visual Composer. يخزن الكود المختصر HTML كسلسلة base64.
• vc_link – تنسيق روابط خاص لـ Visual Composer.
• vc_values – تشفير Visual Composer خاص للقيم في ودجات شريط التقدم، والمخطط الدائري، والمخطط الخطي.
• av_link – تنسيق روابط خاص لـ Enfold.
• allow_html_tags – عادةً ما تُزال وسوم HTML من سمات الكود المختصر. اضبط التشفير على allow_html_tags إذا كان يجب أن تسمح سمة الكود المختصر بوسوم HTML. استخدم هذا بحذر لأن السماح بوسوم HTML في بعض المواقف يمكن أن يفسد التنسيق وقد يمثل مشكلة أمنية.

<wpml-config>
  <shortcodes>
    <shortcode>
            <tag>av_button</tag>
            <attributes>
                <attribute>label</attribute>
                <attribute type="link" encoding="av_link">link</attribute>
            </attributes>
    </shortcode>
  </shortcodes>
</wpml-config>

إذا كنت تفكر في استخدام أكواد urlencoded المختصرة، فتأكد من قراءة الصفحة حول ترجمة الأكواد المختصرة المشفرة بـ urlencoded.

<wpml-config>
    <shortcodes>
        <shortcode>
            <tag label="My shortcode label">my_shortcode</tag>
            <attributes>
                <attribute label="Shortcode title">title</attribute>
            </attributes>
        </shortcode>
    </shortcodes>
</wpml-config>

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

تجميع الحقول لتنظيم أفضل

لتحسين وضوح وتنظيم تكوين XML الخاص بك، يمكنك إضافة اسم المجموعة كبادئة لتسميات الحقول. تأمل هذا المثال لزر دعوة لاتخاذ إجراء (CTA):

<wpml-config>
    <shortcodes>
        <shortcode>
            <tag label="Call To Action: Content">et_pb_cta</tag>
            <attributes>
                <attribute label="Call To Action: Title">title</attribute>
                <attribute label="Call To Action: Button Text">button_text</attribute>
                <attribute label="Call To Action: Button URL" type="link">button_url</attribute>
            </attributes>
        </shortcode>
    </shortcodes>
</wpml-config>

هنا، تُسبق كل سمة داخل الكود المختصر et_pb_cta بتسمية Call To Action: ، والتي تظهر أيضاً في محرر الترجمة المتقدم:

ترجمة الوسائط

يمكنك استخدام ترجمة الوسائط من WPML لاستخدام صور مختلفة للغات المختلفة في محتوى أداة بناء الصفحات. يتم ذلك عن طريق تحويل معرفات الصور وعناوين URL للصور. يجب أن «تخبر» أداة بناء الصفحات التي تستخدم الأكواد المختصرة بكيفية إجراء هذا التحويل. الكود التالي هو مثال على ما تحتاج إلى إضافته إلى ملف wpml-config.xml في هذه الحالة.

<wpml-config>
  <shortcodes>
    <shortcode>
        <!-- Convert media IDs in `gallery_ids` attribute, and ignore the shortcode content -->
        <tag ignore-content="1">et_pb_gallery</tag>
        <attributes>
          <attribute type="media-ids">gallery_ids</attribute>
        <attributes>
    </shortcode>
    <shortcode>
        <!-- Convert the media URL in the content, translate some string attributes for `title` and `alt`, convert media URL in `src` attribute -->
        <tag type="media-url">et_pb_image</tag>
        <attributes>
          <attribute>title_text</attribute>
          <attribute>alt</attribute>
          <attribute type="media-url">src</attribute>
        </attributes>
    </shortcode>
  </shortcodes>
</wpml-config>

يمكنك استخدام القيم التالية:

• ignore-content – يمكنك استخدامه داخل عنصر tag. هذه القيمة اختيارية ويمكن أن تكون إما 0 أو 1. يمكنك استخدام هذه السمة لتحقيق التوافق مع الإصدارات السابقة لأكواد الوسائط المختصرة الجديدة. إذا تم تعيين القيمة على 1 فلن تتم معالجة محتوى الكود المختصر.
• type – يمكنك استخدامه داخل عنصر tag. يمكنك أيضاً استخدام محتوى الكود المختصر الذي يحتوي على عنوان URL للوسائط كقيمة اختيارية داخل media-url.
• type – يمكنك أيضاً استخدامه داخل عنصر attribute. في هذه الحالة، يمكن أن يحتوي على إحدى القيم الاختيارية التالية:
  • media-ids – قائمة بمعرفات الوسائط مفصولة بفواصل.
  • media-url – عنوان URL للوسائط
  • link – يشير إلى صفحة أخرى على الموقع وسيقوم WPML بتحويله تلقائياً إلى عنوان URL للصفحة المترجمة

ترجمة الوسائط في سمات الكتل

يمكنك أيضاً استخدام نوعي السمات media-url و media-ids مع كتل Gutenberg لترجمة الوسائط مثل صور الخلفية. يعمل هذا بشكل مشابه للأكواد المختصرة، ولكنه يستخدم عنصر <gutenberg-block> مع عناصر <key> متداخلة لتحديد type="media-url" و type="media-ids".

يتيح استخدام هذا العنصر لملحق ترجمة الوسائط من WPML ترجمة صور الخلفية.

يعمل هذا مع كل من كتل Gutenberg و Divi 5. يستخدم إصدار Divi هذا الكتل لتخزين المحتوى، لذا يعمل عنصر <gutenberg-block> على إضافة ترجمة الوسائط.

إليك مثالاً على إضافة ترجمة الوسائط لسمات كتلة Gutenberg:

<wpml-config>
  <gutenberg-blocks>
        <gutenberg-block type="divi/section" translate="1">
            <key name="module">
                <key name="decoration">
                    <key name="background">
                        <key name="desktop">
                            <key name="value">
                                <key name="image">
                                    <key name="url" type="media-url" />
                                </key>
                            </key>
                        </key>
                    </key>
                </key>
            </key>
        </gutenberg-block>
  </gutenberg-blocks>
</wpml-config>

ترجمة ودجات أداة بناء الصفحات

يتيح لك WPML تسجيل ودجات أداة بناء الصفحات داخل ملف تكوين اللغة الخاص بك. للحصول على معلومات تفصيلية، راجع صفحة وثائقنا حول كيفية تسجيل ودجات أداة بناء الصفحات للترجمة.

التحويل التلقائي لمعرفات الأكواد المختصرة

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

بدءاً من الإصدار WPML 4.8، يمتد هذا المنطق نفسه إلى معرفات الكائنات المخزنة في نصوص المسؤول، بالإضافة إلى المعرفات في الحقول المخصصة للمقالات وحقول مصطلحات التصنيف المخصصة.

على سبيل المثال، تأمل الكود المختصر التالي:

[foo_product_list product_ids="12,34,56"]

يمكنك التصريح بأن سمة product_ids تحتوي على معرفات المقالات باستخدام التكوين التالي:

<shortcode>
    <tag ignore-content="1">foo_product_list</tag>
    <attributes>
        <attribute type="post-ids" sub-type="product">product</attribute>
    </attributes>
</shortcode>

في الواجهة الأمامية، يتحول الكود المختصر تلقائياً إلى:

[foo_product_list product_ids="13,35,57"]

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

• type – إما post-ids أو taxonomy-ids
• sub-type (اختياري) – كيان محدد من type إذا كان معروفاً بالفعل. على سبيل المثال، product لنوع المنشور المخصص Product القادم من WooCommerce. إذا لم يتم تحديده، فسيتم تخمين الكيان المحدد.

يتميز تحويل المعرفات بتعدد استخداماته ويحاول التكيف مع معظم التنسيقات الممكنة للمعرفات (معرف فردي، قائمة معرفات، مصفوفة متسلسلة، مصفوفة مشفرة بـ JSON).

موارد إضافية

لمعرفة المزيد حول ملف wpml-config.xml، تفضل بزيارة دليل ملفات تكوين اللغة.

لتخصيص العناصر الأخرى باستخدام ملف wpml-config.xml، تفضل بزيارة أدلتنا الإضافية:

• تسجيل ودجات أداة بناء الصفحات المخصصة للترجمة
• ترجمة الأكواد المختصرة المخصصة باستخدام WPML
• تعيين خيارات الترجمة للحقول المخصصة باستخدام ملف تكوين WPML
• تسجيل المصطلحات والأنواع والتصنيفات المخصصة كقابلة للترجمة
• جعل كتل Gutenberg المخصصة قابلة للترجمة
• ترجمة النصوص التي تحفظها القوالب والإضافات في wp_options
• تخصيص مبدل لغة WPML باستخدام ملف تكوين WPML