WPML

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

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

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

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

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

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

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

תרגום מדיה

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

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

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

החל מ־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_ids</attribute>
    </attributes>
</shortcode>

בחזית האתר, השורטקוד מומר אוטומטית ל:

[foo_product_list product_ids="13,35,57"]

תוכל להשתמש במאפייני התצורה הבאים:

  • type – יכול להיות post-ids או taxonomy-ids
  • sub-type (אופציונלי) – ישות ספציפית של ה־type אם היא כבר ידועה. לדוגמה, product עבור סוג התוכן המותאם אישית Product שמגיע מ־WooCommerce. אם הוא לא מוגדר, הישות הספציפית תנוחש.

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

שמות מאפיינים עם תו כללי (Wildcard)

כמה שורטקודים מאחסנים מזהים במאפיינים רבים עם שמות דומים, לדוגמה include_category, include_portfolio_category ו־include_product_cat. שורת <attribute> אחת יכולה לכסות את כולם. שים * בשם המאפיין:

הצהרה שכל מאפייני include_ ו־exclude_ מכילים מזהי טקסונומיה
<shortcode>
    <tag>fusion_post_cards</tag>
    <attributes>
        <attribute type="taxonomy-ids" exclude="include_product_skus">include_*</attribute>
        <attribute type="taxonomy-ids" exclude="exclude_product_skus">exclude_*</attribute>
    </attributes>
</shortcode>
  • * מתאים לאות אחת או יותר, לספרות, ל־_ או ל־-.
  • * עובד רק עם type="post-ids" ו־type="taxonomy-ids".
  • WPML מתאים את שאר השם במדויק. WPML אינו מקבל ביטויים רגולריים (regular expressions) בשמות של מאפיינים.
  • exclude (אופציונלי) – רשימה של שמות מאפיינים מלאים מופרדים בפסיקים. WPML אינו ממיר את המזהים במאפיינים אלו. השתמש בזה עבור מאפיינים שתואמים לשם אך אינם מכילים מזהים, כגון include_product_skus.

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

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

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

נכתב על ידיAmir