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.
ACF-mezők nyelv szerint
Szekció neve “ACF-mezők nyelv szerint”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 |
Ha hiányzik a fordítás
Szekció neve “Ha hiányzik a fordítás”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.
Fordított szerzői adatok
Szekció neve “Fordított szerzői adatok”A WPML GraphQL a felhasználók firstName, lastName, nickname és description mezőit is fordítva adja vissza. Beállítás:
- Nyisd meg a WPML → String Translation oldalt.
- A Translate User properties beállításnál jelöld ki a felhasználói szerepköröket, és mentsd.
- Fordítsd le a sztringeket az Authors doménben.
Ismert korlátozások és megoldások
Szekció neve “Ismert korlátozások és megoldások”- 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
languageargumentum nélkül az alapnyelvre esnek vissza. Többnyelvű webhelyen a beállítóoldal-lekérdezésben mindig add meg alanguageargumentumot.
Készült: