שמירה על תאימות של WPBakery Page Builder עם WPML

התאימות של WPBakery Page Builder עם WPML מובטחת באמצעות קובץ תצורת השפה. למד כיצד להשתמש בקובץ זה כדי לשמור על התאימות.

עמוד זה מיועד לצוות הפיתוח של WPBakery, למפתחים המציעים גרסה מותאמת אישית של תוסף בניית העמודים, למפתחי תוספים נלווים ל־WPBakery ולמפתחי אתרים המשתמשים ב־WPBakery Page Builder.

אם אתה לקוח המעוניין לתרגם אתר שנבנה עם WPBakery, אנא עיין בתיעוד המפורט שלנו כדי ללמוד עוד על בניית אתרים רב-לשוניים עם WPBakery Page Builder ו־WPML.

כיצד השילוב של WPBakery Page Builder עובד עם WPML

כדי להבין כיצד WPBakery Page Builder עובד עם WPML, נתחיל ביצירת עמוד פשוט באמצעות WPBakery Page Builder. נכלול מספר מודולים, כגון Text Block, Message Box, ו־Hover Box.

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

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

עדכון קובץ תצורת השפה

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

1. הוספת שורטקוד חדש לתוסף בניית העמודים
2. הוספת מאפיין חדש לשורטקוד קיים
3. הסרת שורטקוד מיושן

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

עבור מפתחי ערכות עיצוב המשלבים גרסה מותאמת אישית של WPBakery Page Builder בערכת העיצוב שלהם, אנא קח בחשבון שתצטרך לעדכן את קובץ תצורת השפה של הגרסה המותאמת אישית של התוסף.

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

כדי לחלץ מחרוזות מעמודים שנבנו באמצעות WPBakery Page Builder ולטעון אותן במסך עורך תרגום, עלינו להגדיר את WPML כך שיזהה את השורטקודים והמאפיינים המכילים את המחרוזות הדורשות תרגום. פעולה זו מתבצעת על ידי הוספת קובץ בשם wpml-config.xml, הממוקם בדרך כלל בתיקיית השורש של ערכת העיצוב שלך. עבור WPBakery Page Builder, אנו מארחים את קובץ תצורת השפה בשרתים שלנו. הוא מוגדר לדרוס את קובץ התצורה המקומי הממוקם בתיקיית השורש של WPBakery Page Builder, מה שמבטיח שקובץ התצורה תמיד מעודכן.

הקובץ wpml-config.xml משמש גם להגדרת הרכיבים הבאים:

1. שדות מותאמים אישית
2. טקסונומיות מותאמות אישית
3. טקסטים של ממשק הניהול / wp_options
4. תצורת בורר שפות
5. שורטקודים של תוסף בניית עמודים

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

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

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

ניתן לפרק את המבנה של הדוגמה לעיל באופן הבא:

• כל השורטקודים עטופים בתגית הראשית shortcodes (ברבים).
• התגית shortcode עוטפת את כל התגיות השייכות לשורטקוד אחד ויחיד.
• התגית tag מגדירה את שם השורטקוד, שבמקרה זה הוא vc_tta_tabs.
• לשורטקודים יכולים להיות מאפיין אחד או יותר; לפיכך, אנו עוטפים אותם בתגית attributes (ברבים) ומשתמשים בתגית attribute (ביחיד) כדי להגדיר את הכותרת של כל מאפיין. במקרה זה, יש לנו את המאפיין title.

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

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

בדיקת קובץ תצורת השפה

כדי לבדוק את קובץ תצורת השפה המעודכן, בצע את השלבים הבאים:

1. הגדר התקנה שבה גם WPBakery Page Builder וגם WPML מופעלים. הורד והפעל את התוספים הנלווים תרגום מחרוזות ותרגום מדיה.
2. תצטרך לדרוס את קובץ תצורת השפה המרוחק באמצעות הקובץ המעודכן. לשם כך, נווט אל העמוד WPML → הגדרות ולחץ על הלשונית הגדרות XML מותאמות אישית. העתק את התוכן של קובץ תצורת השפה המעודכן שלך לעורך, ולאחר מכן לחץ על שמירה.

3. צור עמוד חדש והוסף אליו את המודול(ים) החדש(ים). במקרה שעדכנת מאפיינים מסוימים עבור מודולים קיימים, הוסף גם אותם לעמוד. בדוגמה זו, נניח שהמודול Call To Action נוסף לאחרונה ל־WPBakery Page Builder. הוסף אותו לעמוד ולחץ על פרסם.

4. לחץ על סמל הפלוס כדי לתרגם את העמוד. פעולה זו תוביל אותך למסך עורך התרגום המתקדם.
5. ודא שרכיבי הטקסט של המודול מוצגים בעורך התרגום המתקדם.
6. הזן את התרגומים שלך ואשר אותם באמצעות סימן ה-V הירוק. לאחר שתסיים, לחץ על הכפתור הושלם.

7. בדוק את העמוד המתורגם בצד הלקוח.

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

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

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

לאחר סיום הבדיקות, אנא שלח בקשת מיזוג (merge request) למאגר שלנו. מפתחי התאימות שלנו יקבלו את בקשתך ויסקרו אותה.

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