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
Szekció neve “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.

Általános beállítások
Szekció neve “Á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). |

Bejegyzések (Posts) lekérdezés
Szekció neve “Bejegyzések (Posts) lekérdezés”Fülek: General, Meta Query, Tax Query, Date Query, Post & Page, Pagination, Author.

General
Szekció neve “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
Szekció neve “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). AzIN,NOT IN,BETWEENésNOT BETWEENtö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
Szekció 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
Szekció neve “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
Szekció neve “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
Szekció neve “Pagination”- Items per page: az oldalankénti bejegyzések száma. A
-1az ö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
Szekció neve “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
Szekció neve “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
0a 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
Szekció neve “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ékaz 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
Szekció neve “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
Szekció neve “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:
[ { "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
Szekció neve “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
Szekció neve “Példa: a legutóbbi bejegyzések listája”- Nyisd meg a Tools → Query Builder menüpontot, és kattints az Add new query gombra.
- Add meg a Query name értékét (például
Legutóbbi bejegyzések), a Query type legyen Bejegyzések. - A General fülön a Post types értéke legyen Bejegyzések, a Post status Published.
- Az Ordering szakaszban az Order by legyen Date, az Order DESC.
- A Pagination fülön az Items per page legyen
6. - Kattints a Save gombra.
- Add hozzá a Query Loop elemet az oldalhoz, és a Data source mezőben válaszd ki az új lekérdezést.
- Az Elements Tree panelen nyisd le a Query Loopot, és kattints az Item elemre: ez a sablon, amely minden találatra megismétlődik.
- 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. - Az elemsáv Preview items gombja megmutatja az elemeket a valós adatokkal, az Edit template visszavisz a sablonszerkesztéshez.
Teljesítmény
Szekció neve “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.
Készült: