ترجمة الأكواد المختصرة المخصصة باستخدام WPML

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

باستخدام WPML، يمكنك ترجمة الأكواد المختصرة المستندة إلى النصوص والمستندة إلى المعرّفات. تُخرج الأكواد المختصرة المستندة إلى النصوص نصاً، مثل هذا الكود:

[goodmorning name="Dear client"]

من ناحية أخرى، تُخرج الأكواد المختصرة المستندة إلى المعرّفات عنصراً باستخدام رقم المعرّف الخاص به:

[myslider id="1"]
[myslider id="2"]

هنا، يُخرج كل كود مختصر شريط تمرير (slider) مختلفاً. على سبيل المثال، قد يُخرج أحدهما شريط تمرير باللغة الإنجليزية، والآخر باللغة الإسبانية.

لترجمة الكود المختصر، ستقوم باستبدال معرّف أحد أشرطة التمرير بالآخر (على سبيل المثال، 1 → 2).

ترجمة الأكواد المختصرة من الإضافات والقوالب المتوافقة

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

على سبيل المثال، إليك كيف يظهر الكود المختصر التالي في المحرر:

[goodmorning name="Dear client"]

ترجمة كود مختصر مستند إلى النصوص في محرر الترجمة المتقدم

إذا كان الكود المختصر الخاص بك يتضمن سمة رابط (URL)، فاستخدم شريط البحث للعثور عليه. يُخفي WPML الروابط في الأكواد المختصرة افتراضياً.

ترجمة سمات روابط الأكواد المختصرة في محرر الترجمة المتقدم

ترجمة الأكواد المختصرة من الإضافات والقوالب غير المتوافقة

لترجمة الأكواد المختصرة من الإضافات والقوالب غير المتوافقة، تحتاج أولاً إلى تسجيلها في ملف تكوين XML مخصص الخاص بـ WPML.

تأمل هذا المثال الذي يحتوي على كودين مختصرين:

[fanpage link="https://example.com"]Some content[/fanpage]
[goodmorning name="dear client" type="official"]

لتسجيل هذه الأكواد المختصرة في WPML، سنستخدم كود التكوين التالي:

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>goodmorning</tag>
      <attributes>
        <attribute>name</attribute>
        <attribute>type</attribute>
      </attributes>
    </shortcode>
    <shortcode>
      <tag label="Fanpage shortcode">fanpage</tag>
      <attributes>
        <attribute>link</attribute>
      </attributes>
    </shortcode>
  </shortcodes>
</wpml-config>

إليك كيف يعمل التكوين في WPML:

ضع جميع الأكواد المختصرة داخل <shortcodes>
غلّف إعدادات الكود المختصر الفردية داخل <shortcode>
حدّد أسماء الأكواد المختصرة باستخدام <tag> وقم بتضمين تسميات مخصصة حسب الحاجة. تُعرض هذه التسميات بجوار النص في محرر الترجمة المتقدم.
حدّد عنوان كل سمة باستخدام <attribute>
غلّف جميع السمات باستخدام <attributes>

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

ترجمة الأكواد المختصرة المخصصة

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

ترجمة النصوص المبرمجة بشكل ثابت داخل الأكواد المختصرة

افتراضياً، النصوص المبرمجة بشكل ثابت غير قابلة للترجمة في WPML. لجعلها قابلة للترجمة، يمكنك استخدام إطار عمل Gettext. تأمل هذا المثال، مع استخدام «Good morning» كنص مبرمج بشكل ثابت:

function goodmorning_att($atts) {
    $default = array(
        'name' => 'there',
    );
    $a = shortcode_atts($default, $atts);
    return 'Good morning, '.$a['name'];
}
add_shortcode('goodmorning', 'goodmorning_att');

لجعل «Good morning» قابلة للترجمة، يمكنك تعديل الكود لاستخدام Gettext:

function goodmorning_att($atts) {
    $default = array(
        'name' => 'there',
    );
    $a = shortcode_atts($default, $atts);
    return __('Good morning, ', 'default').$a['name'];
}
add_shortcode('goodmorning', 'goodmorning_att');

سيجعل هذا نص «Good morning» قابلاً للترجمة، ويُدرجه في ترجمة النصوص.

موارد إضافية

لمعرفة المزيد حول ملف wpml-config.xml، تفضل بزيارة دليل ملفات تكوين اللغة. لتكوين عناصر أخرى في WPML، راجع أدلتنا الإضافية: