הגדרת אפשרויות תרגום עבור שדות מותאמים אישית באמצעות קובץ התצורה של WPML

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

הגדרת אפשרויות תרגום עבור שדות מותאמים אישית

WPML מספק ארבע אפשרויות תרגום עבור שדות מותאמים אישית:

<wpml-config>
  <custom-fields>
     <custom-field action="copy">quantity</custom-field>
     <custom-field action="translate">custom-title</custom-field>
     <custom-field action="copy">weight</custom-field>
     <custom-field action="copy-once">bg-color</custom-field>
     <custom-field action="translate">custom-description</custom-field>
     <custom-field action="ignore">date-added</custom-field>
  </custom-fields>
</wpml-config>

הוספת מאפיינים עבור שדות מותאמים אישית

מאפייני תווית (Label) וקבוצה (Group)

WPML מאפשר לך להוסיף מאפיינים שמופיעים בעורך התרגום המתקדם. זה כולל:

• style – תצוגת שורה בודדת (line), אזור טקסט (textarea) או WYSIWYG (visual)
• label – מציג תווית לצד השדה
• group – מציין לאיזו קבוצה שייך השדה המותאם אישית. כאשר שדה נמצא בקבוצה:
  • השדה מוסר מהאזור של שדות מותאמים אישית
  • השדה מתווסף לאזור של הקבוצה הקשורה

<wpml-config>
  <custom-fields>
    <custom-field action="translate" style="line" label="Title">custom-title</custom-field>
    <custom-field action="translate" style="textarea" label="Description">custom-description</custom-field>
    <custom-field action="translate" style="visual" label="Some content" group="Custom group">custom-wysiwyg</custom-field>
  </custom-fields>
</wpml-config>

כך ייראו מאפיינים אלה בעורך התרגום המתקדם:

מאפיין קידוד (Encode)

באפשרותך גם להוסיף מאפייני encode אופציונליים כדי לשנות את הקידוד מערך ברירת המחדל (ללא קידוד - no).  המאפיין Encoding מקבל את הערכים הבאים:

• json
• base64
• urlencode

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

<wpml-config>
  <custom-fields>
    <custom-field action="translate" encoding="json,base64">keywords</custom-field>
  </custom-fields>
</wpml-config>

מאפיין תרגום קישור (Translate Link)

אם השדה המותאם אישית שלך מכיל קישור, תוכל להשתמש במאפיין translate_link_target כדי לאלץ את WPML לבדוק ולהתאים קישורים בשדה המותאם אישית. כדי שמאפיין זה יעבוד, ודא שהקישור עטוף בתגיות <a>.

<wpml-config>
  <custom-fields>
    <custom-field action="translate" translate_link_target="1">name_of_the_acf_field</custom-field>
  </custom-fields>
</wpml-config>

כברירת מחדל, WPML מתרגם את כל מפתחות־המשנה (sub-keys) בשדות מותאמים אישית. כדי לעקוף זאת, ציין אילו מפתחות־משנה יש לתרגם.

<wpml-config>
  <custom-fields>
    <custom-field action="translate">with_attributes</custom-field>
    <custom-field action="translate">with_deep_attributes</custom-field>
    <custom-field action="translate">no_attributes</custom-field>
  </custom-fields>
  <custom-fields-texts>
    <key name="with_attributes">
        <key name="attribute1" />
        <key name="attribute2" />
    </key>
    <key name="with_deep_attributes">
        <key name="attribute1" />
        <key name="attribute2">
          <key name="level1">
          <key name="level2">
          </key>
          </key>
        </key>
    </key>
  </custom-fields-texts>
</wpml-config>

תווים כלליים (Wildcards)

באפשרותך גם להשתמש בתווים כלליים באותו אופן שבו הם משמשים עבור טקסטים של ממשק הניהול:

• התאמת כל תת־השדות המתחילים ב־title- באמצעות הקוד:
  <key name="title-*" />
• התאמת כל תת־השדות, ובדרך כלל משמש להתאמת אינדקס מערך באמצעות הקוד:
  <key name="*" />
• כדי לקבל את [{"title":"First title"},{"title":"Second title"}] השתמש בקוד

<wpml-config>
  <custom-fields-texts>
    <key name="key-name">
    <key name="*">
    <key name="title" />
    </key>
    </key>
  </custom-fields-texts>
</wpml-config>

המרה אוטומטית של מזהים (IDs) בשדות מותאמים אישית של פוסטים

החל מ־WPML 4.8, באפשרותך להצהיר על מזהים (IDs) הממוקמים בשדות מותאמים אישית של פוסטים. WPML מחליף את המזהים בגרסאות המתורגמות שלהם בחזית האתר.

באפשרותך לעשות זאת רק כאשר אפשרות התרגום היא העתקה (כלומר, בעת שימוש ב־<custom-field action="copy">).

ב־custom-fields של הקובץ wpml-config.xml שלך, השתמש ב:

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

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

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

<custom-fields>
	<custom-field action="copy" type="post-ids" sub-type="product">custom_field_with_id</custom-field>
</custom-fields>

כאשר מזהים מקוננים באזור custom-fields-texts ברמת־משנה, WPML יזהה וימיר אותם ללא קשר להגדרת התרגום של השדה (העתקה, תרגום וכו').

<wpml-config>
  <custom-fields-texts>
    <key name="custom_field_with_nested_ids">
      <key name="custom_field_nested_key_with_ids" type="post-ids" sub-type="product" />
      <key name="custom_field_nested_key_with_ids_with_wildcard_*" type="post-ids" sub-type="product" />
      <key name="custom_field_nested_key_with_subkey">
        <key name="custom_field_nested_key_with_subkey_with_ids" type="post-ids" sub-type="product" />
      </key>
    </key>
  </custom-fields-texts>
</wpml-config>

באמצעות אותו תחביר של type ו־sub-type, באפשרותך להצהיר על מזהים בטקסטים של ממשק הניהול (טבלת wp_options).

הגדרת אפשרויות תרגום עבור שדות מותאמים אישית של מונחי טקסונומיה

כדי לתרגם שדות מותאמים אישית של מונחי טקסונומיה, עליך לציין את שם השדה ואת הפעולה ש־WPML צריך לבצע: translate, copy, copy-once, ignore.

קנן את קוד המקור הזה תחת התגית wpml-config.

באפשרותך להגדיר את אפשרויות התרגום הבאות עבור שדות מותאמים אישית של מונחים:

• translate: מאפשר למשתמש שלך לתרגם את הערך של המונח המותאם אישית. מונחים אלה מופיעים במסך עורך תרגום וניתן לתרגם אותם באופן ידני או אוטומטי או לשלוח אותם למתרגמים אחרים.
• copy: מעתיק את ערך המונח המותאם אישית של שפת ברירת המחדל לשפות המשניות. המשמעות היא שעדכון ערך המונח המותאם אישית של שפת ברירת המחדל יועתק תמיד לשפה המשנית. המונחים המותאמים אישית המוגדרים כ־copy אינם מוצגים במסך עורך תרגום.
• copy-once: מעתיק את הערך של המונח המותאם אישית לשפה המשנית בתהליך התרגום הראשוני. המונחים המותאמים אישית המשתמשים בפעולה copy-once לא יופיעו במסך עורך תרגום. עם זאת, המשתמש יכול לשנות את ערך המונח המותאם אישית של השפה המשנית כך שיהיה שונה משפת ברירת המחדל באמצעות מסך עריכת הפוסט.
• ignore: מונע את העתקת המונח המותאם אישית לשפה המשנית.

<wpml-config>
  <custom-term-fields>
    <custom-term-field action="copy">term_meta_A</custom-term-field>
    <custom-term-field action="translate">term_meta_B</custom-term-field>
    <custom-term-field action="ignore">term_meta_C</custom-term-field>
    <custom-term-field action="copy-once">term_meta_D</custom-term-field>
  </custom-term-fields>
</wpml-config>

המרה אוטומטית של מזהים (IDs) המאוחסנים בשדות מותאמים אישית של מונחי טקסונומיה

באפשרותך לעשות זאת רק כאשר השדה מוגדר כהעתקה (כלומר, בעת שימוש ב־<custom-term-field action="copy">).

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

באזור custom-term-fields, השתמש ב:

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

<wpml-config>
  <custom-term-fields>
    <custom-term-field action="copy" type="post-ids" sub-type="product">custom_term_field_with_id</custom-term-field>
  </custom-term-fields>
</wpml-config>

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

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

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

• תרגום שורטקודים מותאמים אישית עם WPML
• רישום תוכן של תוסף בניית עמודים לתרגום
• רישום וידג'טים מותאמים אישית של תוסף בניית עמודים לתרגום
• רישום מונחים, סוגי תוכן וטקסונומיות מותאמים אישית כניתנים לתרגום
• הפיכת בלוקים מותאמים אישית של Gutenberg לניתנים לתרגום
• תרגום טקסטים שערכת עיצוב ותוספים שומרים ב־wp_options
• התאמה אישית של בורר שפות של WPML באמצעות קובץ התצורה של WPML