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

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

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

מתגי תאימות

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

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

כאשר ערכת עיצוב או תוסף כבר כוללים תרגומי ממשק משתמש משלהם (קבצי .mo בתיקיית /languages/) אך תרגומים אלה אינם מופיעים באתר שלך, בכרטיס אפשרויות לוקליזציה ישנם שלושה מתגים שעוזרים ל־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

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

הפעל את העוגייה אם אתה רואה את התסמין הבא: מבקרים בעמוד בצרפתית מקבלים תוצאות באנגלית מאזורים שנטענים באמצעות 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-config> בתוך קובץ wpml-config.xml בספריית השורש של ערכת העיצוב או התוסף שלך במקום זאת. WPML קורא אותו בעת ההפעלה. העורך הפנימי באזור הניהול מיועד להתאמות ספציפיות לאתר; הקובץ המצורף מיועד לברירות המחדל של ערכת העיצוב/התוסף עצמם.