תרגום שורטקודים מותאמים אישית עם WPML

למדו כיצד לתרגם שורטקודים מתוספים, ערכות עיצוב, וכאלה שאתה מפתח בעצמך באמצעות WPML.

באמצעות WPML, תוכל לתרגם גם שורטקודים מבוססי טקסט וגם שורטקודים מבוססי מזהה (ID). שורטקודים מבוססי טקסט מציגים פלט של טקסט, כמו זה:

[goodmorning name="Dear client"]

מצד שני, שורטקודים מבוססי מזהה מציגים פלט של רכיב באמצעות מספר המזהה שלו:

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

כאן, כל שורטקוד מציג פלט של סליידר שונה. לדוגמה, אחד עשוי להציג סליידר באנגלית, והשני בספרדית.

כדי לתרגם את השורטקוד, עליך להחליף מזהה של סליידר אחד בשני (למשל, 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. לאחר מכן, תוכל לתרגם אותם יחד עם שאר תוכן העמוד.

תרגום טקסטים המקודדים קשיח (Hardcoded) בתוך שורטקודים

כברירת מחדל, טקסטים המקודדים קשיח אינם ניתנים לתרגום ב־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, עיין במדריכים הנוספים שלנו: