# Kifejezés-lekérdezés

> A Terms Query blokk: kategóriák, címkék vagy egyedi taxonómia kifejezéseinek listája vagy rácsa a sablonokban.

A **Terms Query** blokk (a felületen ezen az angol néven jelenik meg) taxonómiakifejezések, vagyis kategóriák, címkék vagy egyedi taxonómia elemeinek listáját vagy rácsát jeleníti meg. Sablonokban hasznos, például egy „Kategóriák” áttekintő oldalon vagy egy tartalomjegyzék-jellegű oldalon, ahol te döntöd el, hogyan nézzen ki egy-egy kifejezés.

## Követelmények

- WordPress 6.9 vagy újabb.
- Blokktéma, mert a sablonokat a Webhelyszerkesztőben szerkeszted.
- A megjeleníteni kívánt taxonómiának nyilvánosnak és a szerkesztőben elérhetőnek kell lennie (`show_in_rest` engedélyezve).

## A blokk felépítése

A Terms Query beágyazott blokkokból áll, ezeket a **Listanézet** mutatja:

- **Terms Query**: a lekérdezés paraméterei;
- **Kifejezés Sablon**: a megjelenítés módja, lista vagy rács;
- **Kifejezés neve**: a kifejezés neve;
- **Kifejezés leírása**: a kifejezés leírása;
- **Kifejezés száma**: hány elem tartozik az adott kifejezéshez.

## Beszúrás sablonba

1. Nyisd meg a **Webhelyszerkesztőt** (**Megjelenés → Szerkesztő**).
2. Nyisd meg azt a sablont, ahol a kifejezéseket meg akarod jeleníteni (például egy saját „Kategóriák” sablont).
3. Vidd a kurzort a kívánt helyre.
4. Kattints a blokkbeszúróra (**+**), keress rá a **Terms Query** blokkra, és kattints rá.

A beszúráskor két elrendezés közül választhatsz: a **Név** csak a kifejezés nevét mutatja, a **Név és szám** a nevét és az elemek számát is.

![A Terms Query blokk kijelölve a szerkesztőben, jobbra a lekérdezés beállításai](./kepek/temablokkok-kifejezes-lekerdezes-beallitasok.webp)

*A Terms Query blokk kijelölve a szerkesztőben, jobbra a lekérdezés beállításai* (https://minta-bolt.hu/wp-admin/post.php?post=23&action=edit)

A képen a kijelölt blokk látszik: alatta a kategóriák nevei és a darabszámok (például „Receptek (2)”), jobbra a lekérdezés beállításai.

## Megjelenés testreszabása

A blokk beágyazott blokkokból épül fel, ezeket áthelyezheted, bővítheted. Ha egy beágyazott blokkon módosítasz, a változás az azonos típusú blokkokra is érvényes. A szerkesztés közben a **Listanézet** (a felső eszköztáron) segít eligazodni. Néhány ötlet:

- A blokk egyes részeinek szélességét módosíthatod.
- A beágyazott blokkok igazítását átállíthatod.
- A blokkok sorrendjét húzással vagy a mozgatónyilakkal rendezheted át.
- A megjelenített kifejezések számát a **Kifejezések maximális száma** mezővel korlátozhatod.
- A beágyazott blokkoknak színt adhatsz.
- A kifejezések számának formátumát a **Kifejezés száma** blokk eszköztárán állíthatod.
- A kifejezés leírását a **Kifejezés leírása** blokk beszúrásával jelenítheted meg, és a stílusát a blokk beállításaiban módosíthatod.

## Blokk-eszköztár

- **Átalakítás**: **Csoport** vagy **Oszlopok** blokká.
- **Igazítás módosítása**: **Nincs**, **Széles** vagy **Teljes szélesség**. A széles és teljes szélességet a témának támogatnia kell.
- **Húzófogó** és **mozgatás nyilakkal**: a blokk áthelyezése a sablonban.
- **Egyebek**: másolás, duplikálás, zárolás, törlés és a többi szokásos művelet.

A **Kifejezés Sablon** blokk kijelölésekor két nézet közül választhatsz:

- **Lista** (alapértelmezett): a kifejezések egymás alatt jelennek meg. Hierarchikus taxonómiához ez a jobb.
- **Rács**: a kifejezések rácsban jelennek meg, sok kifejezés gyors áttekintéséhez praktikus.

## Blokk-beállítások

| Beállítás | Mit csinál | Alapérték |
| --- | --- | --- |
| **Osztályozási rendszer** | Melyik taxonómia kifejezéseit mutatja (például **Kategóriák**). | Kategóriák |
| **Rendezés** | **Név: A → Z**, **Név: Z → A**, **Darabszám: csökkenő** vagy **Darabszám: növekvő** sorrend. | Név: A → Z |
| **Kiválasztott kifejezések** | Meghatározott kifejezések kiválasztása kereséssel. Ha üres, az összeset mutatja. | üres |
| **Üres kifejezések megjelenítése** | Bekapcsolva az olyan kifejezések is megjelennek, amelyekhez nem tartozik elem. | kikapcsolva |
| **Beágyazott kifejezések megjelenítése** | Bekapcsolva az alárendelt (beágyazott) kifejezések is megjelennek. | kikapcsolva |
| **Kifejezések maximális száma** | Legfeljebb ennyi kifejezést mutat. Mindegyik megjelenítéséhez használj 0-t. | 10 |
| **Haladó** | **HTML-horgony**, **További CSS-osztály(ok)**, **További CSS**, HTML-elem megadása. | |

A **Kifejezés neve** blokkban a **A kifejezés neve legyen hivatkozás** kapcsolóval a kifejezés neve az archívumoldalára mutató hivatkozás lesz.

## Tippek

- Hierarchikus taxonómiához a listát, sok kifejezés gyors átnézéséhez a rácsot használd.
- A kifejezés nevét tartsd hangsúlyosan, a leírást a gyűjtőoldalakon adhatod hozzá, hogy az olvasó értse, miről szól a kifejezés.
- Kapcsold ki az **Üres kifejezések megjelenítése** beállítást, hogy ne legyenek üres archívumok a listában.
- A beállított Terms Query részt mentheted mintaként, és más sablonokban is felhasználhatod.

## Gyakori kérdések

**Megjeleníthetem csak a legfelső szintű kifejezéseket?** Igen: hagyd kikapcsolva a **Beágyazott kifejezések megjelenítése** beállítást.

**Megjeleníthetek egyedi taxonómiát?** Igen, ha nyilvános, és a szerkesztőben elérhető (`show_in_rest`).

**Hivatkozhatom a kifejezés nevét az archívumára?** Igen, a **Kifejezés neve** blokk hivatkozás-kapcsolójával.