הגדרת תאימות WPML עם ערכות עיצוב ותוספים של WordPress – הגדרות ו־wpml-config.xml מותאם אישית

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

שני תתי־עמודים של הגדרות עוסקים בתאימות, ועמוד זה מכסה את שניהם:

• WPML ← הגדרות ← תאימות מכיל את ההגדרות לתסמינים נפוצים.
• WPML ← הגדרות ← הגדרות XML מותאמות אישית הוא המקום שבו אתה כותב wpml-config.xml משלך – כפי שמתואר בחצי השני של עמוד זה.

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

הגדרות תאימות

העמוד מכיל ארבעה כרטיסים. כל כרטיס מטפל בסוג מסוים של בעיית תאימות.

אפשרויות לוקליזציה – עבור ערכות עיצוב ותוספים שהתרגומים שלהם אינם נטענים

כאשר ערכת עיצוב או תוסף כבר כוללים תרגומי ממשק משלהם (קבצי .mo בתיקיית /languages/) אך תרגומים אלה אינם מופיעים באתר שלך, הכרטיס Localization options כולל שלוש הגדרות שעוזרות ל־WPML למצוא ולהחיל אותם.

• Automatically load the theme’s .mo file using load_textdomain. מאלץ את WPML לקרוא ל־load_textdomain() עבור דומיין הטקסט (text domain) של ערכת העיצוב. השתמש באפשרות זו כאשר התרגומים של ערכת העיצוב נמצאים בשרת אך אינם מופיעים.
• Enter textdomain. דורס את דומיין הטקסט שזוהה אוטומטית. חלק מערכות העיצוב רושמות את דומיין הטקסט שלהן בדרכים לא סטנדרטיות; שדה זה מאפשר לך לציין אותו במפורש.
• Use theme or plugin text domains when gettext calls do not use a string literal. דגל תאימות עבור ערכות עיצוב ותוספים שמשתמשים בקריאות __() עם ארגומנטים משתנים במקום מחרוזות מדויקות. WPML אינו יכול לזהות אותם אוטומטית, והגדרה זו עוזרת לו להחיל תרגומים בכל זאת.

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

התאמת ערכות עיצוב לעבודה רב־לשונית

התאמת מזהים (IDs) עבור פונקציונליות רב-לשונית. שכבת תאימות עבור ערכות עיצוב שמקודדות הנחות של שפה יחידה (לדוגמה, ערכת עיצוב ששומרת "מזהה תמונה ראשית" פעם אחת ומשתמשת באותה תמונה בכל השפות).

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

סינון שפה עבור פעולות AJAX

Store a language cookie to support language filtering for AJAX. תוספים מסוימים משתמשים ב־AJAX כדי לאחזר תוכן: רשימות מוצרים מסוננות, רשימות פוסטים עם עימוד AJAX, תוצאות חיפוש בזמן אמת. ללא קובץ Cookie של שפה, נקודת הקצה של AJAX אינה יודעת באיזו שפה להשיב ומחזירה תוצאות בשפה שגויה.

הפעל את ה־Cookie אם אתה רואה את התסמין הבא: מבקרים בעמוד הצרפתי מקבלים תוצאות באנגלית מאזורים שנטענים באמצעות AJAX. זהו תיקון של תיבת סימון אחת עבור סוג שלם של באגים.

עמודי התחברות והרשמה

Allow translating the login and registration pages. ה־/wp-login.php המובנה של WordPress ומסך ההרשמה אינם חלק מהתוכן הרגיל ש־WPML מתרגם. הם נמצאים מחוץ לשרשרת התבניות של ערכת העיצוב. הגדרה זו מוסיפה אותם לאוסף העמודים הניתנים לתרגום של WPML.

אם האתר שלך פועל על nginx, ההגדרה דורשת גם התאמה בתצורת השרת. העמוד מקשר למדריך ה־nginx של WPML עם בלוק התצורה המדויק.

טקסטים של ערכות עיצוב ותוספים – ההגדרות כאן, הסורק במקום אחר

שני סוגים של עבודה עם מחרוזות של ערכות עיצוב/תוספים מפוצלים על פני שני מסכים:

• ההגדרות בעמוד זה. הן מטפלות בתאימות עבור תרגומים שערכת העיצוב/התוסף כבר כוללים: load_textdomain, דריסת דומיין טקסט, וקריאות gettext לא מדויקות.
• הסורק נמצא במסך משלו. כאשר עליך למצוא מחרוזות של ערכות עיצוב ותוספים שעדיין אינן רשומות לתרגום, השתמש במסך תרגום טקסטים של ממשק הניהול. ניתן להגיע אליו מהלשונית מחרוזות בתרגומים תחת האזור "לא רואה את המחרוזות שאתה מחפש?".

לתהליך העבודה המלא של סריקת מחרוזות, ראה תרגום מחרוזות.

wpml-config.xml מותאם אישית

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

כאשר ה־wpml-config.xml שמגיע עם ערכת העיצוב או התוסף אינו מספיק עבור האתר שלך, אתה כותב אחד משלך. WPML מחיל אותו על גבי מה שערכת העיצוב או התוסף מספקים.

מתי כדאי לכתוב wpml-config.xml משלך

שלושה תרחישים.

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

בכל מקרה, התמיכה של WPML עשויה להפנות אותך לכאן עם ה־wpml-config.xml המדויק שיש להדביק. לרוב זוהי פעולה המונחית על ידי התמיכה, ולעיתים פעולה של מפתח.

למה לערוך את wpml-config.xml באזור הניהול של WPML במקום בקובץ ערכת העיצוב

אתה יכול לערוך ישירות את ה־wpml-config.xml של ערכת העיצוב או התוסף. אך שינוי זה יאבד בפעם הבאה שערכת העיצוב או התוסף יתעדכנו. העורך המובנה של WPML ב־WPML ← הגדרות ← הגדרות XML מותאמות אישית מוסיף את ה־wpml-config.xml שלך על גבי זה שמסופק על ידי ערכת העיצוב או התוסף, ושורד עדכונים. זהו המקום הנכון להתאמות ספציפיות לאתר.

המבנה של wpml-config.xml

העמוד הוא עורך XML. הדבק בלוק <wpml-config>...</wpml-config>, שמור, ו־WPML יחיל את ה־wpml-config.xml שלך.

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

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>add_to_cart_link</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

סוגי האלמנטים שלרוב תגדיר:

• <custom-fields>. סימון שדה מותאם אישית כ־translate, copy, copy-once, או nothing.
• <custom-types>. הגדרת סוג תוכן מותאם אישית כניתן לתרגום.
• <taxonomies>. הגדרת טקסונומיה מותאמת אישית כניתנת לתרגום.
• <shortcodes>. רשימת שורטקודים ש־WPML צריך לתרגם את התוכן שלהם.
• <custom-term-fields>. עבור מטא של מונח.

לכל אלמנט יש מאפיינים משלו (לדוגמה, action="translate" בשדה מותאם אישית). לתיעוד המלא של wpml-config.xml (כל אלמנט, כל מאפיין, כל ערך מותר), ראה את המידע למפתחי WPML.

תהליך עבודה מעשי

אם התמיכה של WPML נותנת לך בלוק wpml-config.xml להדבקה:

1. עבור אל WPML ← הגדרות ← הגדרות XML מותאמות אישית.
2. הדבק את ה־XML שלהם בתוך בלוק ה־<wpml-config> הקיים (או החלף את התוכן אם הם נתנו לך את הבלוק המלא).
3. שמור.
4. WPML מחיל את ה־wpml-config.xml שלך באופן מיידי. אם הוא מגדיר סוג תוכן או שדה חדשים כניתנים לתרגום, הרשומה תופיע מיד ב־WPML ← הגדרות ← תרגום סוגי פוסטים או ב־WPML ← הגדרות ← תרגום שדות מותאמים אישית.

אם אתה בונה ערכת עיצוב או תוסף מותאמים אישית ורוצה לצרף את תצורת ה־WPML שלהם עם הקוד, עליך לשים את אותו בלוק <wpml-config> בתוך קובץ wpml-config.xml בתיקיית השורש של ערכת העיצוב או התוסף שלך במקום זאת. WPML קורא אותו בעת ההפעלה. העורך באזור הניהול מיועד להתאמות ספציפיות לאתר; הקובץ המצורף מיועד לברירות המחדל של ערכת העיצוב/התוסף עצמם.