Tovább a tartalomhoz

ACF, szerzők és ismert korlátozások

ACF-mezők és beállítóoldalak nyelv szerint, a hiányzó fordítások viselkedése, fordított szerzői adatok és ismert korlátozások.

Sok headless webhely az Advanced Custom Fields-ben építi fel a tartalommodelljét, és a WPGraphQL-en át teszi elérhetővé. Ha az ACFML és a WPGraphQL for ACF is aktív, az ACF-adatok ugyanazokat a nyelvi szabályokat követik, mint a séma többi része.

A bejegyzések és egyéni bejegyzéstípusok ACF-mezői a bejegyzésen mentett értéket adják vissza. Minden fordításnak saját értékei vannak, ezért elég a bejegyzést a kívánt nyelven lekérdezned, külön argumentum nem kell.

ACF beállítóoldal lekérdezése tetszőleges nyelven

Szekció neve “ACF beállítóoldal lekérdezése tetszőleges nyelven”

A beállítóoldalak (Options Page) nem tartoznak egyetlen bejegyzéshez sem, ezért saját language argumentumot kapnak. A kapcsolódó ismétlő- és rugalmas tartalommezők almezői szintén ezen a nyelven jönnek vissza.

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

Az argumentumnak a webhely egyik aktív nyelvének kódját kell megadnod.

A WPGraphQL for ACF 3.0.0 óta a beállítóoldal csak akkor kerül be a GraphQL-sémába, ha bekapcsolod hozzá a show_in_graphql beállítást. Enélkül sem a beállítóoldal lekérdezése, sem a language argumentuma nem létezik. Ha kódból regisztrálod az oldalt, ott add meg a beállítást:

acf_add_options_page( array(
'page_title' => 'Site Settings',
'menu_slug' => 'site-settings',
'show_in_graphql' => true,
'graphql_field_name' => 'siteSettings',
) );

Kapcsolat-mezők: a lefordított bejegyzés jön vissza

Szekció neve “Kapcsolat-mezők: a lefordított bejegyzés jön vissza”

A bejegyzések és egyéni bejegyzéstípusok ACF-mezői nem kapnak saját language argumentumot, hanem a kérés nyelvét követik. A következő lekérdezésben a where: { language: "es" } az egész lekérdezés nyelvét beállítja:

query BlendsES {
posts(where: { language: "es" }) {
nodes {
title
postExtras {
relatedGuide {
nodes { ... on Post { title languageCode } }
}
}
}
}
}

A spanyol bejegyzés a spanyol útmutatót adja vissza.

Az olyan kapcsolat-mező, amelynek fordítási beállítása Copy, már fordított azonosítókat tartalmaz: amikor a WPML a mezőt a fordításra másolja, az ACFML minden azonosítót a fordítására cserél. Ha a fordítás még nem létezik, az eredeti azonosító marad. Ezt a beállítást mezőnként az ACF mezőcsoport-szerkesztőjében, a Translation preferences résznél adod meg.

Mindig add meg a nyelvet a kérésben. Az a lekérdezés, amely egyetlen bejegyzést azonosító vagy slug alapján olvas, nem hordoz language szűrőt, ezért az alapnyelven fut, és a kapcsolódó bejegyzések is alapnyelven jönnek vissza.

A nyelv megadása a WPML URL-formátumától függ:

URL-formátum Hogyan add meg a nyelvet
Nyelvenként külön domain Az adott nyelv végpontját hívd, például https://es.example.com/graphql
Nyelv paraméter Add a végponthoz: /graphql?lang=es
Könyvtár (alkönyvtár) Nincs nyelvenkénti végpont, a nyelvre magában a lekérdezésben szűrj

A WPML nem esik vissza az alapnyelvre. Ha egy kapcsolódó bejegyzésnek nincs fordítása a kérés nyelvén, kiesik az eredményből:

{
"data": {
"posts": {
"nodes": [
{
"title": "Nuestras mezclas de la casa",
"postExtras": {
"relatedGuide": {
"nodes": [
{ "title": "Guía de compra de espresso", "languageCode": "es" }
]
}
}
}
]
}
}
}

A mező két útmutatóra mutat, de csak az egyik van lefordítva spanyolra, ezért a spanyol lekérdezés egyet ad vissza. A front-end rövidebb listát kap, soha nem nyelvekből kevert listát. Ha a hiányzó bejegyzést lefordítod, ugyanebben a lekérdezésben megjelenik.

A lista akkor marad egynyelvű, ha a bejegyzéstípus fordítható. Ha a bejegyzéstípust Display as translated (fordítottként jelenik meg) módra állítod, a WPML a le nem fordított útmutatót alapnyelven adja vissza, és a lista nyelvei keverednek.

A WPML GraphQL a felhasználók firstName, lastName, nickname és description mezőit is fordítva adja vissza. Beállítás:

  1. Nyisd meg a WPML → String Translation oldalt.
  2. A Translate User properties beállításnál jelöld ki a felhasználói szerepköröket, és mentsd.
  3. Fordítsd le a sztringeket az Authors doménben.
  • Fordított URI-k egyes lekérdezésformákban. Ha egy fordított bejegyzést URI alapján kérsz le (contentNode(id: "/de/some-slug/", idType: URI)), ellenőrizd, hogy a visszaadott URI egyezik-e a nyelven közzétettel, mert néhány lekérdezésforma következetlen útvonalat ad. Az útválasztásba építés előtt próbáld ki a GraphQL IDE-ben.
  • ACF beállítóoldalak language argumentum nélkül az alapnyelvre esnek vissza. Többnyelvű webhelyen a beállítóoldal-lekérdezésben mindig add meg a language argumentumot.

Készült:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások