WPML

רישום תוכן של תוסף בניית עמודים לתרגום

עודכן: 4 בפברואר 2026

למד כיצד לרשום תוכן מותאם אישית של תוסף בניית עמודים לתרגום באמצעות הקובץ wpml-config.xml. רשום מחרוזות, מדיה, וידג'טים של תוסף בניית עמודים, מזהי שורטקוד (IDs) ועוד.

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

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

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

תרגום מחרוזות

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

[vc_text_separator title="Separator Title"]

כדי לתרגם את הכותרת של מפריד טקסט זה, עליך להוסיף כמה שורות לקובץ wpml-config.xml שלך. בדרך זו, WPML "ידע" שהכותרת של מפריד זה דורשת תרגום.

הקוד הבא הוא דוגמה למה שעליך להוסיף לקובץ wpml-config.xml במקרה זה.

דוגמה להוספת שורטקוד של תוסף בניית עמודים לקובץ 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 יחד איתה. היא מטפלת בקידוד מיוחד שבו משתמשים תוספי בניית עמודים שונים. התכונה encoding היא בדרך כלל ספציפית לתוסף בניית העמודים שבו אתה משתמש. היא מקבלת את הערכים הבאים:

  • base64 – שורטקוד HTML גולמי של Visual Composer. השורטקוד מאחסן את ה־HTML כמחרוזת base64.
  • vc_link – עיצוב קישור מיוחד עבור Visual Composer.
  • vc_values – קידוד מיוחד של Visual Composer לערכים בווידג'טים של סרגל התקדמות (progress-bar), תרשים עוגה (pie-chart) ותרשים קווים (line-chart).
  • av_link – עיצוב קישור מיוחד עבור Enfold.
  • allow_html_tags – בדרך כלל תגיות HTML מוסרות מתכונות של שורטקוד. הגדר את הקידוד ל־allow_html_tags אם תכונת השורטקוד צריכה לאפשר תגיות HTML. השתמש בזה בזהירות, מכיוון שמתן אפשרות לתגיות HTML במצבים מסוימים עלול לשבש את העיצוב ולהוות בעיית אבטחה.
דוגמה להוספת תכונת קישור בשורטקוד: type="link"
<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: , שמופיעה גם בעורך תרגום מתקדם:

תרגום כפתור קריאה לפעולה (CTA) בעורך תרגום מתקדם
תרגום כפתור קריאה לפעולה (CTA) בעורך תרגום מתקדם

תרגום מדיה

באפשרותך להשתמש בתרגום מדיה של WPML כדי להשתמש בתמונות שונות עבור שפות שונות בתוכן של תוסף בניית עמודים. פעולה זו מתבצעת על ידי המרת מזהי תמונות (IDs) וכתובות URL של תמונות. עליך "להגיד" לתוסף בניית העמודים שמשתמש בשורטקודים כיצד לבצע המרה זו. הקוד הבא הוא דוגמה למה שעליך להוסיף לקובץ wpml-config.xml במקרה זה.

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

המרה אוטומטית של מזהי שורטקוד (IDs)

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

החל מ־WPML 4.8, אותו היגיון חל גם על מזהי אובייקטים המאוחסנים בטקסטים של ממשק הניהול, וכן על מזהים בשדות מותאמים אישית של פוסטים ובשדות של מונחי טקסונומיה מותאמים אישית.

לדוגמה, בחן את השורטקוד הבא:

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

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

הצהרה שהתכונה 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. אם היא לא מוגדרת, המערכת תנסה לנחש את הישות הספציפית.

המרת המזהים (ID) היא רב־תכליתית ומנסה להתאים לרוב הפורמטים האפשריים של מזהים (מזהה יחיד, רשימת מזהים, מערך בסיריאליזציה, מערך מקודד ב־JSON).

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

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

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

נכתב על ידי Amir · עודכן לאחרונה: 4 בפברואר 2026