שמירה על תאימות תוסף בניית העמודים CornerStone (ערכת העיצוב X) עם WPML

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

במאמר רישום וידג'טים מותאמים אישית של תוסף בניית עמודים לתרגום, אנו מסבירים בפירוט כיצד לרשום וידג'טים מותאמים אישית של תוסף בניית עמודים לתרגום באמצעות קובץ הגדרות שפה. כעת, נבדוק את המידע הדרוש כדי להשיג זאת עבור וידג'טים של Cornerstone.

איתור פרטי הרישום של הווידג'ט

כדי שתוכל לרשום וידג'ט מותאם אישית של Cornerstone בתוך הקובץ wpml-config.xml , עליך תחילה לאתר מידע בסיסי לגביו.

תוכל להשיג מידע זה בקלות מהשדה המותאם אישית _cornerstone_data או באמצעות שימוש בתוסף כמו JSM Show Post Metadata. תוסף זה מציג את המטא-נתונים של הפוסט ואת הערכים שלהם בצורה לא סריאלית (unserialized) בתיבת מטא בתחתית עמודי עריכת פוסטים.

לחלופין, תוכל לבצע את השלבים הבאים כדי להשיג מידע זה:

1. עבור אל העמוד WPML → הגדרות, גלול אל המקטע תרגום שדות מותאמים אישית ולחץ על הקישור Show system field.
2. הגדר את השדה המותאם אישית _cornerstone_data למצב תרגום.
3. צור עמוד חדש והוסף רק את הווידג'ט של CornerStone שברצונך לרשום. שמור את העמוד.
4. עבור אל WPML → הגדרות ובמקטע עורך תרגום , הפעל באופן זמני את האפשרות עורך תרגום קלאסי.
5. נסה לתרגם את העמוד שיצרת בשלב 3 באמצעות עורך תרגום קלאסי, ותבחין במערך סריאלי, כפי שמוצג כאן:

6. העתק את התוכן של המערך הסריאלי.
7. השתמש בכלי המועדף עליך לביטול סריאליזציה (unserialize) כדי לראות טוב יותר כיצד הווידג'ט מפיק את התוכן שלו. במקרה שלנו, השתמשנו באתר Unserialize.

להלן ההסבר על תוכן המערך שתראה:

• [_type] מכיל את השם שהוזן בתכונה name של תגית הווידג'ט.
• הערך field יהיה השם בתוך הסוגריים שיכיל את שם השדה. לדוגמה: [testimonial_content] => You are never too old to set another goal or to dream a new dream. במקרה זה, "title" הוא הטקסט שאתה צריך.

לאחר שיהיה בידיך מידע זה, תוכל להמשיך לרישום בפועל של הווידג'ט לתרגום.

לדוגמה, הווידג'ט Testimonial שמגיע עם Cornerstone מציג מבנה דומה לזה בשדה המותאם אישית _cornerstone_data שלו. בעזרת מידע זה, יש לרשום את הווידג'ט באופן הבא כדי ש־WPML יוכל לזהות ולתרגם אותו:

<wpml-config>
  <cornerstone-widgets>
    <widget name="testimonial">
      <fields>
        <field type="Testimonial: Content">testimonial_content</field>
      </fields>
    </widget>
  </cornerstone-widgets>
</wpml-config>

פעולה זו, כמובן, אינה הכרחית מכיוון שהווידג'ט Testimonial כבר רשום כברירת מחדל על ידי WPML במאגר שלנו. אך זה משמש כדוגמה עבור הווידג'טים המותאמים אישית שלך.

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

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

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

3. צור עמוד חדש, והוסף אליו את המודול(ים) החדש(ים). במקרה שעדכנת כמה תכונות עבור מודולים קיימים, הוסף גם אותם לעמוד. בדוגמה זו, נניח שהמודול Testimonial נוסף לאחרונה לתוסף בניית העמודים CornerStone. הוסף אותו לעמוד, ולחץ על פרסום.

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

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

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

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