# Galéria ACF-galériamezőből

> A Galéria listázása widget bekötése egy ACF-galériamezőre, hogy minden bejegyzés a saját képeit mutassa.

Az **ACF-galéria** forrás akkor jó, ha minden bejegyzésnek más képei vannak, de egyetlen Elementor-sablonból szeretnéd megjeleníteni őket. A képeket az ACF-galériamező a bejegyzéshez tárolja, a widget pedig a mező nevét megadva beolvassa.

| Elem | Feladata |
|---|---|
| ACF-galériamező | A képeket tárolja bejegyzésenként |
| Elementor-sablon | Egyszer megadja az elrendezést |
| **Galéria listázása** widget | A mezőt név szerint olvassa és kirajzolja a képeket |

Mivel a képek a bejegyzésen vannak, új kép felvételekor a bejegyzést szerkeszted, nem a sablont.

## Mielőtt elkezdesz

- A forrás a Pro kiadás funkciója. Az alap bővítményben a lehetőség látszik, de frissítési értesítést mutat.
- Kell az ACF Pro is, mert a Galéria mezőtípus csak abban van meg.
- Kell egy bejegyzéstípus, amelynek bejegyzéseiben már vannak képek az adott mezőben, különben üres galéria jelenik meg.
- A **Galéria listázása** widget legyen bekapcsolva a **The Plus Addons → Widgets** oldalon.

## Lépések

1. Az ACF mezőcsoportjainak oldalán (angol felületen ACF → Field Groups) hozz létre új csoportot. Nevezd el, majd adj hozzá egy mezőt, amelynek típusa Galéria (Gallery), és adj neki címkét. A visszatérési formátum és a könyvtár maradjon az alapértéken. Meglévő mezőcsoportba is felvehetsz Galéria mezőt.
2. A csoport beállításaiban a hely szabályát állítsd arra a bejegyzéstípusra, amelyiken meg akarod jeleníteni (például **Bejegyzés**). Mentsd a csoportot, és másold ki a mező nevét.
3. Nyiss meg egy bejegyzést. Megjelenik rajta a galériamező: add hozzá a bejegyzéshez tartozó képeket. Legalább két bejegyzésnél tedd meg, hogy a sablon építésekor legyen mit látnod.
4. A sablonba húzd be a **Galéria listázása** widgetet, válassz elrendezést, majd a **Tartalom → Tartalom** szakaszban állítsd a **Válaszd ki az opciót** értékét **ACF-galéria**ra.
5. Megjelenik a **Galéria mező neve** mező. Írd be az ACF mező nevét. A mező nevét add meg, ne a címkéjét: a „Projekt képek” címke neve általában `projekt_kepek`.

![A Tartalom szakasz ACF-galéria forrással és a mező nevével](./kepek/galeria-csapat-velemenyek-1-panel-acf.webp)

*A Tartalom szakasz ACF-galéria forrással és a mező nevével* (https://minta-bolt.hu/wp-admin/post.php?post=263&action=elementor)

A képen a **Válaszd ki az opciót** értéke **ACF-galéria**, alatta a **Galéria mező neve** mezőbe a `projekt_kepek` van beírva.

| Beállítás | Hol | Megjegyzés |
|---|---|---|
| **Válaszd ki az opciót** | **Tartalom → Tartalom** | **Normál**, **Ismétlő** (Pro), **ACF-galéria** (Pro) |
| **Galéria mező neve** | **Tartalom → Tartalom** | Az ACF mező neve, nem a címkéje |
| Elrendezés | **Tartalom → Elrendezés** | Mind a négy elrendezés működik |
| **Képméret megjelenítése** | **Tartalom → Extra opciók** | Ugyanaz, mint más forrásnál |

## Korlátozások

- ACF Pro kell hozzá, az ingyenes ACF-ben nincs Galéria mezőtípus.
- Mindkét bővítménynek a fizetős változata kell.
- A mező nevének pontosan egyeznie kell. Nincs választó és nincs ellenőrzés: hibás névnél a galéria hibaüzenet nélkül üres marad.
- Csak dinamikus környezetben működik. Statikus oldalon nincs aktuális bejegyzés, amelyből a mezőt olvashatná, ezért egyedi bejegyzéssablonban vagy lista elemében használd.
- Képenkénti kategória nincs, a kategóriaszűrőhöz az **Ismétlő** forrás kell, az ACF csak képeket ad.

## Hibaelhárítás

**A galéria üres.** Három dolgot nézz meg ebben a sorrendben: a **Galéria mező neve** pontosan egyezik-e az ACF mező nevével; a mezőcsoport helyszabálya lefedi-e ezt a bejegyzéstípust; van-e kép a megtekintett bejegyzés mezőjében.

**Az egyik bejegyzésen működik, a másikon nem.** Annak a bejegyzésnek üres a galériamezője. A mező bejegyzésenként külön van, mindegyiknek kellenek a saját képei.

**Normál oldalon nem jelenik meg semmi.** Nincs aktuális bejegyzés, amelyből az ACF olvasna. Használd egyedi bejegyzéssablonban vagy hurokelemben.

**A címkét írtam be, és nem működik.** A mező nevét kell megadni. Az ACF-ben a címke az emberi olvasatú szöveg, a név a kisbetűs, aláhúzásos kulcs alatta.