# 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

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

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.

```graphql
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:

```php
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

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:

```graphql
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

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:

```json
{
  "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

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.

## 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 `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.
