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

למד כיצד לשמור על התאימות של המודולים של Divi ל־WPML באמצעות קובץ תצורת השפה wpml-config.xml.

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

עמוד זה מתייחס ל־Divi 5, ששומר תוכן כבלוקים התואמים ל־Gutenberg (גרסה Divi 4 השתמשה בשורטקודים).

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

כדי להבין כיצד Divi Builder עובד עם WPML, נתחיל ביצירת עמוד פשוט באמצעות Divi Builder. הוספנו כמה מודולים בדוגמה שלנו למטה, כגון Text, Number Counter, Icon וכן הלאה.

כדי לתרגם, עבור אל WPML → לוח בקרת תרגום ומצא את העמוד תחת הקטע Pages (עמודים). בחר אותו ולחץ על תרגם את התוכן שלך כדי לבחור את שיטת התרגום. אם יש לך קרדיטים לתרגום אוטומטי, תוכל לתרגם עמוד זה אוטומטית בתוך דקות.

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

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

• בלוקים של תוסף בניית עמודים
• שדות מותאמים אישית
• טקסונומיות מותאמות אישית
• טקסטים של ממשק הניהול / wp_options
• הגדרת בורר שפות

למידע נוסף על מבנה ותחביר, עיין במדריך שלנו לקובץ תצורת השפה.

קבלת קובץ התצורה עבור Divi

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

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

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

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

Divi 5 משתמש בתחביר של בלוקים, כך שרישום מודולים של Divi לתרגום דומה לתהליך של תרגום בלוקים של Gutenberg:

• כל הגדרות הבלוקים עטופות בתוך רכיב אב <gutenberg-blocks>.
• כל בלוק בודד מוצהר באמצעות רכיב <gutenberg-block>, כאשר המאפיין type תואם לשם הרשום של הבלוק.
• שדות הניתנים לתרגום מוצהרים כרכיבי צאצא <key>.

ניקח כדוגמה מודול הנעה לפעולה (Call to Action) של Divi:

<!-- wp:divi/cta {"module":{"title":"CTA","button_text":"Contact Us","button_url":"https://example.com/contact/"}} /-->

כך זה מוגדר בקובץ wpml-config.xml:

<gutenberg-blocks>
    <gutenberg-block type="divi/cta" translate="1">
       <key name="module">
         <key name="title" />
         <key name="button_text" />
         <key name="button_url" type="link" />
       </key>
    </gutenberg-block>
</gutenberg-blocks>

המבנה מתחלק באופן הבא:

• הרכיב <gutenberg-blocks> עוטף את כל הגדרות הבלוקים.
• רכיב <gutenberg-block> מגדיר סוג בלוק יחיד, המזוהה על ידי המאפיין type. ה־translate="1" מורה ל־WPML לעבד זאת.
• כל רכיב <key> מזהה שדה אחד שניתן לתרגום: title ו־button_text עבור שדות טקסט רגיל, ו־button_url עבור קישור.
• המאפיין type="link" מורה ל־WPML להחליף אוטומטית את ה־URL בגרסה המתורגמת של הפוסט או העמוד המקושרים.

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

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

1. הגדר אתר שבו מופעלים גם Divi וגם WPML. ודא שאתה מפעיל גם את התוספים הנלווים תרגום מחרוזות ותרגום מדיה.

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

3. צרו עמוד חדש, והוסיפו אליו את המודול(ים) החדש(ים). אם עדכנתם מאפיינים מסוימים עבור מודולים קיימים, הוסיפו גם אותם לעמוד. בדוגמה זו, נניח שהמודול Button נוסף לאחרונה ל־Divi Builder. הוסיפו אותו לעמוד ולאחר מכן לחצו על פרסום.

4. כדי לתרגם את העמוד עם הכפתור, תוכל להשתמש בלוח בקרת תרגום. חלופה נוספת היא שימוש בעורך תרגום מתקדם (ATE), שיכול להיות שימושי בעת בדיקה — הוא מאפשר לך לראות את תגית המודול עבור כל רכיב של Divi בעמוד. כדי לפתוח את ATE, עבור אל עריכה של העמוד ולחץ על סמל הפלוס תחת תיבת השפה (Language Box) בסרגל הצד הימני.

5. בדוק את הרכיבים, והוסף את התרגומים שלך או אפשר ל־ATE לתרגם אוטומטית.

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

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

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