# Lekérdezések

> A Query Builder beállításai bejegyzésekhez, kifejezésekhez, felhasználókhoz, hozzászólásokhoz, JSON-adatokhoz és az aktuális WP-lekérdezéshez, valamint a Query Loop használata.

A Query Builderrel egyedi lekérdezéseket hozol létre: különböző típusokat, szűrőket és megjelenítési beállításokat adsz meg, hogy dinamikus tartalmat kérj le a WordPressből. A lekérdezések bejegyzéseket, kifejezéseket, felhasználókat, hozzászólásokat és egyedi adatkészleteket érhetnek el. Az eredményt a **Query Loop** elem jeleníti meg.

## Megnyitás és a lekérdezések listája

A Query Builder a CrocoBuilderrel szerkesztett oldalakon, bejegyzéseken és sablonokon érhető el: **Tools → Query Builder**. Megnyílik a lekérdezések listája (**ID**, **NAME**, **TYPE**, **ACTIONS**), keresővel és **Refresh** gombbal. Új lekérdezést az **Add new query** gombbal hozol létre. A sorokon a szerkesztés, a másolás és a törlés ikon érhető el.

![A lekérdezések listája](./kepek/lekerdezes-lista.webp)

*A lekérdezések listája* (https://minta-bolt.hu/wp-admin/post.php?post=5&action=crocoblocks)

## Általános beállítások

| Beállítás | Mit csinál |
| --- | --- |
| **Query name** | A lekérdezés neve a listában. |
| **Query type** | **Bejegyzések**, **Kifejezések**, **Felhasználók**, **Hozzászólások**, **JSON-tömb** vagy **Aktuális WP-lekérdezés**. |
| **Description** | Rövid leírás, a listában való eligazodáshoz. |
| **Enable cache** | A lekérdezés gyorsítótárazása. Kapcsold ki, ha gondod van az eredményekkel. Alapérték: bekapcsolt. |
| **Query args** | A lekérdezés argumentumainak megadása: **Builder** (vizuális felület csoportosított WP_Query vezérlőkkel), **Raw JSON** (a teljes argumentumobjektum JSON-ban), **Preview** (a lekérdezés futtatása, az eredmény megjelenítése teszteléshez). |

![Egy bejegyzés-lekérdezés általános beállításai](./kepek/lekerdezes-bejegyzesek.webp)

*Egy bejegyzés-lekérdezés általános beállításai* (https://minta-bolt.hu/wp-admin/post.php?post=5&action=crocoblocks)

## Bejegyzések (Posts) lekérdezés

Fülek: **General**, **Meta Query**, **Tax Query**, **Date Query**, **Post & Page**, **Pagination**, **Author**.

![A Posts lekérdezés General füle](./kepek/lekerdezes-bejegyzesek-args.webp)

*A Posts lekérdezés General füle* (https://minta-bolt.hu/wp-admin/post.php?post=5&action=crocoblocks)

### General

| Beállítás | Mit csinál |
| --- | --- |
| **Post types** | A lekérdezett tartalomtípusok. Ha egyet sem választasz, minden típus szerepel. |
| **Post status** | Egy vagy több bejegyzésállapot, például **Published**. |
| **Search** | Kulcsszó a címben, kivonatban vagy tartalomban. Kötőjellel kezdve (például `-cipő`) kizárja a szót tartalmazó bejegyzéseket. A `{ }` ikonnal dinamikus adat is beszúrható. |
| **Ignore sticky posts** | Bekapcsolva a kiemelt bejegyzések az eredeti helyükön jelennek meg, nem a lista tetején. |
| **Ordering** | A rendezési szabályok az **Add order rule** gombbal. **Order by**: **Date**, **Title**, **ID**, **Menu order**, **Random**, **Comment count**, **Meta value**, **Meta value (numeric)**, **Meta clause**, **Post order (post__in)**. **Order**: **DESC** (csökkenő) vagy **ASC** (növekvő). |
| **Fields** | Mennyi adatot húz be az adatbázisból: **All fields** (a teljes objektum) vagy **IDs only** (csak azonosítók, ez gyorsabb). |
| **Enable cache results** | Bekapcsolva az eredmény gyorsítótárba kerül, csökkentve az adatbázis-lekérdezéseket. |
| **Update meta cache** | Előre betölti a lekérdezett bejegyzések egyedi mezőit. |
| **Update post term cache** | Előre betölti a bejegyzésekhez rendelt kifejezéseket (kategóriákat, címkéket). |

### Meta Query

A bejegyzéseket az egyedi mezők értéke szerint szűri. Több feltételt az **Add meta clause** gombbal adhatsz meg.

- **Relation**: **AND** (minden feltételnek teljesülnie kell) vagy **OR** (legalább egynek).
- **Key**: az egyedi mező neve.
- **Value**: az összehasonlítandó érték.
- **Treat value as a comma-separated list**: az értéket vesszővel tagolt listaként kezeli.
- **Compare**: `=`, `!=`, `>`, `>=`, `<`, `<=` (a nagyobb és kisebb összehasonlítások csak számokra működnek), `LIKE`, `NOT LIKE`, `IN`, `NOT IN`, `BETWEEN`, `NOT BETWEEN`, `EXISTS`, `NOT EXISTS` (ezeknél hagyd üresen a **Value** mezőt), `REGEXP`, `NOT REGEXP` (jellemzően jelölőnégyzet és rádiógomb mezőkhöz). Az `IN`, `NOT IN`, `BETWEEN` és `NOT BETWEEN` több értéket igényel: vesszővel tagolva add meg, és kapcsold be a vesszős listaként kezelést.
- **Type**: **Char**, **Numeric**, **Date**, **Datetime**, **Decimal**, **Time**, **Binary** (kis- és nagybetűre érzékeny szöveg), **Signed**, **Unsigned**.
- **Clause name**: a feltétel opcionális neve.

### Tax Query

A bejegyzéseket a hozzájuk rendelt osztályozások, kategóriák vagy kifejezések szerint szűri. Több feltétel az **Add tax clause** gombbal.

- **Relation**: **AND** vagy **OR**.
- **Taxonomy**: a kiválasztott tartalomtípusokhoz tartozó osztályozások.
- **Field**: a kifejezés azonosítása **Term ID**, **Slug** vagy **Name** szerint.
- **Terms**: a kifejezések a kiválasztott módon.
- **Exclude children**: hierarchikus osztályozásnál kizárja a gyermekkifejezésekhez rendelt bejegyzéseket.
- **Compare operator**: **IN** (valamelyik kifejezés), **NOT IN** (kizárás), **AND** (az összes megadott kifejezés), **EXISTS** (van kifejezés az osztályozásban), **NOT EXISTS** (nincs).

### Date Query

- **After**, **Before**: az ezen dátum után vagy előtt létrehozott vagy módosított bejegyzések.
- **Include boundary dates**: a megadott dátumok is beleszámítanak.
- **Year**, **Month**, **Day**: az adott évben, hónapban vagy napon létrehozott vagy módosított bejegyzések.

### Post & Page

- **Include by IDs**, **Exclude by IDs**: bejegyzések felvétele vagy kizárása azonosítóval, vesszővel tagolva.
- **Parent/child**: **Parent ID** (csak az adott szülő gyermekei), **Parent include IDs** (több szülő gyermekei), **Parent exclude IDs** (adott szülők gyermekeinek kizárása).

### Pagination

- **Items per page**: az oldalankénti bejegyzések száma. A `-1` az összes találatot egy oldalra teszi, ilyenkor az **Offset** figyelmen kívül marad.
- **Use all matching items**: minden találatot visszaad, az **Items per page** rejtett és figyelmen kívül marad.
- **Page**: a lekérdezendő oldal száma, egyedi lapozáshoz vagy statikus címoldalhoz.
- **Offset**: ennyi bejegyzést kihagy az elejéről.
- **Disable found rows**: nem számolja ki az összes találat számát.

### Author

- **Author ID**: szerzők azonosítói vesszővel tagolva. Mínuszjellel (például `-5`) az adott szerző bejegyzései kizárhatók.

## Kifejezések (Terms) lekérdezés

Osztályozási kifejezések listáját állítja össze.

- **General**: **Taxonomy** (üresen minden osztályozás), **Exclude empty terms**, **Search** (kötőjellel kizárhat), **Name filter**, **Slug filter**, **Order by**, **Order**, **Items per page**, **Page**, **Offset**, **Fields** (teljes objektumok, csak azonosítók vagy nevek, illetve azonosító és szülő, név, slug vagy bejegyzésszám párosítások).
- **Include/Exclude**: **Include term IDs**, **Exclude term IDs**, **Exclude tree** (egy szülő és minden gyermeke kizárása).
- **Parent/Child**: **Parent** (csak a közvetlen gyermekek, a `0` a felső szintű kifejezések), **Child Of** (minden leszármazott), **Enable hierarchy handling**, **Include child term counts**, **Include descendant terms**.
- **Meta Query**: a bejegyzés Meta Queryjéhez hasonló.

## Felhasználók (Users) lekérdezés

- **User Role**: **Role** (egy szerepkör vagy **Any**), **Roles include**, **Role exclude**.
- **Include/Exclude**: **Include user IDs**, **Exclude user IDs**.
- **Misc**: **Search** (helyettesítő karakterekkel: `érték*` az adott szöveggel kezdődőt, `*érték` az azzal végződőt, `*érték*` az azt tartalmazót keresi), **Search Columns** (például login, e-mail, URL), **Order By**, **Order**, **Items per page**, **Page**, **Offset**, **Blog ID** (többhelyes hálózatban egy adott webhely felhasználói), **Fields**, **Who** (**Any** vagy **Authors**, vagyis akik közzétehetnek bejegyzést), **Has published posts** (**Any**, **Yes**, **No**).
- **Meta Query**: a bejegyzés Meta Queryjéhez hasonló.

## Hozzászólások (Comments) lekérdezés

- **Include/Exclude**: **Include comment IDs**, **Exclude comment IDs**.
- **Author**: **User ID**, **Author email**.
- **Meta Query**: a bejegyzés Meta Queryjéhez hasonló.
- **Date Query**: **After**, **Before**, **Include boundary dates**.
- **Pagination**: **Items per page**, **Page**, **Offset**.
- **Post**: **Post ID**, **Posts include**, **Posts exclude**, **Parent comment** (csak a közvetlen válaszok).
- **Misc**: **Status** (**Approved**, **Pending**, **Spam**, **Trash**, **All**, valamint más bővítmények állapotai), **Type** (**Any**, **Comment**, **Pingback**, **Trackback**), **Order By**, **Order**, **Fields**.

## JSON-tömb (JSON Array) lekérdezés

Egyedi adatkészletet adhatsz meg közvetlenül a Query Builderben. A tömb minden eleme egy objektum, amit a Query Loop használhat.

- **Dataset JSON**: a JSON-tömb szerkesztője.
- **Dynamic Data**: a `{ }` ikon dinamikus tokent, szűrőt és kontextust szúr be.
- **Format JSON**: tagolja a JSON-t olvashatóbbra.
- **Clear**: törli az összes adatot.
- **Insert sample**: mintaadatkészletet szúr be, a típusválasztóval (**Basic items** vagy **Products**).
- **Pagination**: **Items per page** és **Page** (futásidőben dinamikusan felülírható).
- **Diagnostics**: **JSON size** és **Item count**.

Termékmintára példa:

```json
[
  { "id": 1, "title": "A termék", "price": 19.99, "in_stock": true },
  { "id": 2, "title": "B termék", "price": 29.5, "in_stock": false }
]
```

## Aktuális WP-lekérdezés

Az aktuális oldalhoz generált, aktív WordPress-lekérdezést használja, nem hoz létre újat. Archívumokhoz, keresési eredményekhez vagy a jelenlegi bejegyzéshez ideális a Sablonépítő sablonjaiban. Nincsenek konfigurálható argumentumai, mert mindig az aktív frontend-kérést követi. A **Preview** a Sablonépítő aktuális előnézeti környezete alapján tölt be mintaeredményt.

## Példa: a legutóbbi bejegyzések listája

1. Nyisd meg a **Tools → Query Builder** menüpontot, és kattints az **Add new query** gombra.
2. Add meg a **Query name** értékét (például `Legutóbbi bejegyzések`), a **Query type** legyen **Bejegyzések**.
3. A **General** fülön a **Post types** értéke legyen **Bejegyzések**, a **Post status** **Published**.
4. Az **Ordering** szakaszban az **Order by** legyen **Date**, az **Order** **DESC**.
5. A **Pagination** fülön az **Items per page** legyen `6`.
6. Kattints a **Save** gombra.
7. Add hozzá a **Query Loop** elemet az oldalhoz, és a **Data source** mezőben válaszd ki az új lekérdezést.
8. Az **Elements Tree** panelen nyisd le a Query Loopot, és kattints az **Item** elemre: ez a sablon, amely minden találatra megismétlődik.
9. Tegyél bele **Image**, **Heading**, **Text** és **Link** elemeket, és a `{ }` ikonnal a **Dynamic Data** ablakban válaszd ki a megfelelő tokent: **Featured Image ID** (`{{ post:featured_image_id }}`), a bejegyzés címe, kivonata és hivatkozása.
10. Az elemsáv **Preview items** gombja megmutatja az elemeket a valós adatokkal, az **Edit template** visszavisz a sablonszerkesztéshez.

## Teljesítmény

A Query Builder gyorsítótárat és mezőkorlátozást is kínál (**Enable cache**, **Enable cache results**, **Fields**, **Update meta cache**, **Update post term cache**). Ezek csökkentik a felesleges adatbázis-lekérdezéseket.
