WPML GraphQL – WPGraphQL רב-לשוני עבור Headless WordPress

ביצוע שאילתות על תוכן לפי שפה מצד הלקוח שלך

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

query PostsES {
  posts(where: { language: "es" }) {
    nodes { slug uri title }
  }
}

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

רוצה הכל ללא קשר לשפה עבור מפת אתר או ספירה מצטברת? העבירו language: "all".

שליפת כל תרגום של Node בשאילתה אחת

השדה translations בפוסטים ובמונחי טקסונומיה מחזיר כל גרסה בשפה אחרת של node: מזהה כתובת, URI, קוד שפה, וכל שדה מקונן שתבקש. שאילתה אחת, סבב אחד, כל גרסת שפה של עמוד.

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

תפריטים רב-לשוניים, טקסונומיות, תגובות ונתוני שפה

מעבר לפוסטים, WPML GraphQL מרחיב את אותו ארגומנט language וטיפול בתרגום אל:

• תפריטים ופריטי תפריט. menu(language: "fr") עבור ניווט לפי שפה. נוסף ב־WPML GraphQL 1.1.0.
• מונחי טקסונומיה. קטגוריות, תגיות וטקסונומיות מותאמות אישית עוקבות אחר שפת הפוסט שלהן כברירת מחדל וניתן לבצע עליהן שאילתות לפי שפה באופן ישיר.
• תגובות. החזרת תגובות המשויכות לפוסטים בשפה מסוימת.
• שאילתות languages ו־defaultLanguage. רשימה של כל שפה המותקנת באתר עם קוד, אזור, שם מקורי, כתובת URL של דגל המדינה, וכתובת URL של דף הבית. מבנה הנתונים הנכון עבור בורר שפות מותאם אישית.

ביצוע שאילתה על פוסט מסוים לפי מזהה (ID) או מזהה כתובת, בכל שפה

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

query PostBySlug {
  post(id: "hola-mundo", idType: SLUG) {
    title slug uri
  }
}

query PostById {
  post(id: "2", idType: DATABASE_ID) {
    title slug uri
  }
}

כל אחת מהצורות מחזירה את הפוסט המתורגם עם הכותרת, מזהה הכתובת וה־URI המתורגמים שלו – ללא לוגיקת "האם זהו תרגום?" נפרדת בצד הלקוח.

מתוחזק מול הגרסה הנוכחית של WPGraphQL

WPML GraphQL 1.1.3 נבדק עד לגרסת WPGraphQL 2.0.0, נתיב הגרסה המרכזית שבו נמצא פרויקט WPGraphQL. הצוות שמתחזק את WPGraphQL עובד איתנו כדי שהשכבה הרב-לשונית תמשיך להתקדם יחד עם הסכמה. כאשר WPGraphQL משחרר גרסה חדשה, WPML GraphQL נמצא מיד אחריו.

עובד עם ACF כאשר אתה מוסיף את ACFML ו־WPGraphQL עבור ACF

עבור אתרים שבונים את מודלי התוכן שלהם ב־Advanced Custom Fields וחושפים שדות אלה דרך WPGraphQL, WPML GraphQL משתלב עם ACFML ו־WPGraphQL עבור ACF כדי להוסיף ארגומנט language לשאילתות של עמוד אפשרויות ACF:

query Settings {
  myOptionPage(language: "de") {
    addressFieldGroup {
      addressTitle
      repeaterAddressDetails { addressDetails }
    }
  }
}

שדות ACF בפוסטים ובסוגי תוכן מותאמים אישית עוקבים אוטומטית אחר שפת הפוסט המארח.