תרגום טקסטים שערכות עיצוב ותוספים שומרים ב־wp_options

למד כיצד להפוך טקסטים השמורים בטבלת wp_options לניתנים לתרגום ולהמיר אוטומטית מזהי אובייקטים.

ערכות עיצוב ותוספים כוללים לעתים טקסטים כחלק מהאפשרויות שהם שומרים בטבלת wp_options. WPML מאפשר לך לתרגם טקסטים אלה על ידי החלפת הקריאות ל־get_option בתרגומים שהגדרת בקובץ wpml-config.xml.

הקובץ wpml-config.xml הוא מסמך תצורה המנחה את WPML אילו מחרוזות באפשרויות השמורות דורשות תרגום.

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

צריך ליצור קובץ wpml-config.xml? בקר במדריך השלבים שלנו ליצירה אוטומטית של קובץ תצורה באמצעות התוסף Multilingual Tools.

תרגום מחרוזות בטבלת wp_options

כאשר ערכות עיצוב ותוספים משתמשים ב־get_option, הם קוראים ערכים מטבלת wp_options. WPML יכול לסנן קריאות אלו ולספק תרגום לערכים של אפשרויות אלו.

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

כדי לתרגם אפשרות בודדת, הוסף רשומת key תחת admin-texts. כדי לתרגם מערך שעבר סריאליזציה, הוסף מספר מפתחות תחת key, כפי שניתן לראות ב־my_plugin_options בדוגמה להלן.

טקסטים של ממשק הניהול בקובץ תצורת השפה

<wpml-config>
  <admin-texts>
    <key name="my_plugins_options">
      <key name="option_name_1" />
      <key name="option_name_2" />
    <key name="options_group_1">
      <key name="sub_option_name_11" />
      <key name="sub_option_name_12" />
    </key>
      <key name="options_group_2">
      <key name="sub_option_name_21" />
    <key name="sub_option_name_22" />
    </key>
    </key>
  <key name="simple_string_option"/>
</admin-texts>
 
</wpml-config>

ניתן להשתמש בתו הכללי * בתת־מפתחות, כמו במקרה הבא.

דוגמה לשימוש בתו כללי

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="*"/>
    </key>
  </admin-texts>
</wpml-config>

זה שווה ערך לקוד זה:

הקוד שווה הערך

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="sub_key_1"/>
      <key name="sub_key_2">
        <key name="sub_sub_21">
          <key name="sub_sub_211"/> 
        </key> 
        <key name="sub_sub_21"/>
        </key>
      <key name="more_sub_keys"/>
    </key>
  </admin-texts>
</wpml-config>

שים לב שהתו הכללי * לא עובד במפתחות אב:

התו הכללי אינו עובד במפתחות אב

<wpml-config>
  <admin-texts>
    <key name="some_option_*" />
    <key name="*"/>
  </admin-texts>
</wpml-config>

המרת מזהי אובייקטים אוטומטית בטקסטים של ממשק הניהול

החל מ־WPML 4.8, באפשרותך להצהיר שטקסטים מסוימים של ממשק הניהול מכילים מזהי אובייקטים כמו מזהי פוסטים, מוצרים או טקסונומיות. WPML ממיר אוטומטית מזהים אלה בחזית האתר.

זוהי הרחבה של פונקציונליות קיימת בנושא המרת מזהי שורטקודים אוטומטית, והיא משתמשת באותו תחביר.

ברשומות key תחת admin-texts, השתמש ב:

type כדי לציין לאיזה אובייקט יש הפניה, כלומר post-ids או taxonomy-ids
sub-type (אופציונלי) כאשר ברצונך להצהיר על הישות הספציפית (למשל product)

ניתן להוסיף את המאפיינים Type ו־sub-type בכל רמת קינון.

WPML יכול לזהות ולהמיר מזהים בפורמטים הבאים:

מזהה בודד (למשל 123)
מערך (ומערך מקודד) של מזהים (למשל [123,456,789])
רשימת מזהים מופרדת בפסיקים (למשל "123,456,789")

דוגמה להצהרה על מזהי אובייקטים בטקסטים של ממשק הניהול

<wpml-config>
  <admin-texts>
    <key name="admin_text_option_key" type="post-ids" sub-type="product" />
    <key name="admin_text_with_nested_ids">
      <key name="admin_text_nested_key_with_ids" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_ids_with_wildcard_*" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_subkey">
        <key name="admin_text_nested_key_with_subkey_with_ids" type="post-ids" sub-type="product" />
          </key>
      </key>
  </admin-texts>
</wpml-config>

משאבים נוספים

כדי ללמוד עוד על הקובץ wpml-config.xml , בקר במדריך קבצי תצורת שפה.

להתאמה אישית של אלמנטים אחרים באמצעות הקובץ wpml-config.xml, בקר במדריכים הנוספים שלנו: