Tovább a tartalomhoz

Lekérdezéskészítő áttekintése

A Lekérdezéskészítő általános beállításai, a lekérdezéstípusok, a REST API-végpont regisztrálása és az a hely, ahol egy lekérdezést felhasználhatsz.

A Lekérdezéskészítő (Query Builder) segítségével az összes elemből feltételek alapján állítasz össze listát. Lekérdezhetsz bejegyzéseket, kifejezéseket (terms), felhasználókat, hozzászólásokat, SQL-táblák adatait, ismétlő mezőket, WooCommerce-termékeket, REST API-n érkező elemeket, egyéni tartalomtípus (CCT) elemeket és értékeléseket. Olyan adatot is megjeleníthetsz vele, amelyet másképp nem tudnál, például az adatbázis saját tábláinak tartalmát.

A lista a JetEngine → Lekérdezéskészítő oldalon van. Az Új hozzáadása gombbal veszel fel új lekérdezést.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-query
A Lekérdezések listája oldal kereséssel, típus szerinti szűréssel és rendezéssel

A lista felett három eszköz van: a Keresés mező kulcsszóra szűr, a Szűrés típus szerint lista egy lekérdezéstípusra szűkít (egyes típusok csak akkor szerepelnek, ha a hozzájuk tartozó bővítmény aktív), a Rendezés szerint lista cím vagy dátum szerint rendez, növekvő vagy csökkenő sorrendben. A Szűrők törlése gomb visszaállítja az alapnézetet.

Az új lekérdezés oldalán az Általános beállítások blokk közös minden típusnál.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-query&query_action=add
Az új lekérdezés általános beállításai
Beállítás Mit csinál Alapérték
Név A lekérdezés neve; az admin felületen ez látszik. üres
Leírás Rövid leírás, amely a listában is megjelenik, és segít rendszerezni a lekérdezéseket. üres
Lekérdezés típusa A lekérdezett adat forrása (lásd lent). Ettől függ a lap alsó blokkjának tartalma. Bejegyzések lekérdezése
Egyéni lekérdezés-ID Opcionális. A JetSmartFilters szűrőkkel köti össze a lekérdezést: ugyanazt az azonosítót kell megadnod a szűrő Query Variable mezőjében és a listázó widget azonosítójában. üres
Lekérdezés gyorsítótárazása A lekérdezés eredményét gyorsítótárazza. Kapcsold ki, ha hibás eredményt kapsz. bekapcsolva
Gyorsítótár lejárata A gyorsítótár lejárati ideje másodpercben. Csak külső objektum-gyorsítótárnál (Redis, Memcached) van értelme; másképp a gyorsítótár egy kérés idejéig él. üres (0, nincs lejárat)
REST API-végpont regisztrálása Nyilvános REST API-végpontot hoz létre a lekérdezés eredményéhez (lásd lent). kikapcsolva
Eredmények előnézete A lap tetején lévő kapcsoló: a lekérdezés eredményét azonnal mutatja jobb oldalon, mentés nélkül. kikapcsolva

Ha bekapcsolod a REST API-végpont regisztrálása kapcsolót, a lekérdezés adatai távolról is lekérhetők. Ezt használhatod például Make.com-forgatókönyvben, vagy mobilalkalmazás háttereként.

https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-query&query_action=add
A bekapcsolt REST API-végpont beállításai
Beállítás Mit csinál
Végpont névtere A wp-json előtag utáni első URL-szegmens.
Végpont útvonala A második URL-szegmens, a névtér után.
REST API-végpont URL-je A generált cím, a mellette lévő gombbal másolhatod.
Hozzáférés korlátozása Ki érheti el a végpontot: bárki (nyilvános), a kiválasztott képességekkel rendelkező felhasználók, vagy a kiválasztott szerepkörű felhasználók.
Hozzáférés szerepkörök szerint Szerepkör szerinti korlátozásnál itt választod ki a szerepköröket.
Lekérdezési argumentumok A végpont URL-jéhez fűzhető kulcs-érték párok (Lekérdezési argumentum neve, Alapértelmezett érték).

Néhány fontos részlet:

  • Képesség szerinti korlátozásnál vesszővel elválasztva több képességet is megadhatsz (például edit_posts); elég, ha a felhasználónak egy megvan közülük.
  • Ha a képesség vagy a szerepkör mezőt üresen hagyod, a végpont senkinek sem érhető el, kivéve ha a kéréssel együtt hitelesítést küldesz (például Application Passwords). Korlátozott végpontnál mindig kell hitelesítés.
  • A regisztrált argumentumokat a lekérdezés tényleges paramétereihez is hozzá kell rendelned. Használd a Query Variable dinamikus argumentumot, vagy írd a paraméterbe a %query_var|argument_name% kifejezést.
  • Argumentum felvétele után megjelenik az Argumentumokkal kiegészített végpont-URL példa mező, amelyet szintén másolhatsz.

A teljes példa a REST API-végpont beállítása egyéni lekérdezéshez fejezetben van.

A Lekérdezés típusa lista a helyi felületen ezeket kínálja:

Típus Mire jó
Bejegyzések lekérdezése Bejegyzések, oldalak, egyéni bejegyzéstípusok kategória, dátum vagy egyéni mező szerint.
Kifejezések lekérdezése Kategóriák, címkék, egyéni taxonómiák: címtárakhoz, navigációhoz.
Felhasználók lekérdezése Felhasználói adatok, például tagok listája szerepkör vagy meta szerint.
Hozzászólás-lekérdezés Hozzászólások vagy értékelések bejegyzés, szerző, állapot szerint.
SQL/AI lekérdezés Adatok közvetlenül az adatbázis tábláiból, SQL utasítással. A Generate with AI (varázspálca) gomb AI-val készít SQL-t; ez csak ennél a típusnál van.
Ismétlő lekérdezés JetEngine vagy ACF ismétlő mező alelemei.
Aktuális WP-lekérdezés Az aktuális oldal natív WordPress-lekérdezése módosítás nélkül; archív oldalakon hasznos.
Egyesített lekérdezés Két vagy több lekérdezés eredményét egy listává fűzi.
File Query JSON-, CSV- vagy XLSX-fájlból olvas adatot; szűrés, rendezés, lapozás és munkalap-választás is van.
Relations Query Előre megadott JetEngine kapcsolatok (relations) alapján kapcsolt bejegyzések, felhasználók, kifejezések.
Egyéni tartalomtípus-lekérdezés CCT elemek. Csak bekapcsolt Egyéni tartalomtípusok modulnál jelenik meg.
REST API lekérdezés Külső végpontok és harmadik fél API-jainak adatai. Csak bekapcsolt REST API-listázások modulnál jelenik meg.
Data Store Query Az Adattárolók modul által mentett elemek (kívánságlista, kedvencek, könyvjelzők).

Más bővítmények további típusokat adnak a listához: a Jet Appointment Booking Query (időpontfoglalás-lekérdezés), a JetBooking Query (foglalások állapot, dátum, felhasználó szerint), a WC Product Query (WooCommerce-termékek ár, készlet, értékelés, tulajdonság szerint), a JetFormBuilder Records (mentett űrlapbeküldések) és a Jet Reviews Query (értékelések). Ezek csak akkor látszanak, ha a hozzájuk tartozó bővítmény telepítve és aktív.

Az Egyesített lekérdezésnek van egy korlátja: nem tud egységes rendezést adni az összefűzött eredményre, mert a forráslekérdezések külön futnak le. Emiatt nem biztos, hogy működik lapozással és a JetSmartFilters Indexerével.

A típus kiválasztása után az alsó blokk a típushoz tartozó beállításokat mutatja.

Hely Hova kell beállítani
Listing Grid (Elementor, blokkszerkesztő, Bricks) Custom Query fül → Use Custom Query kapcsoló, majd a lekérdezés kiválasztása. A régi Posts Query, Terms Query, Users Query és Content Types Query fülek elavultak, helyettük ezt használd.
Map Listing Ugyanaz a Custom Query fül mindhárom szerkesztőben. Például csak a „Szabad” állapotú elemek jelennek meg a térképen.
Dynamic Chart A JetEngine → Charts Builder oldalon az Adatlekérdezés (Data Query) mezőben. Leggyakrabban bejegyzés-lekérdezést használnak.
Dynamic Table A JetEngine → Tables Builder oldalon az Adatlekérdezés mezőben; a szerkesztőben a Rewrite table query kapcsolóval és a New Query mezővel másik, még nem használt lekérdezést is megadhatsz.
Smart Posts List és Smart Posts Tiles (JetBlog) Query & Controls fül → Use Custom Query; saját lekérdezés generátorral vagy kész Lekérdezéskészítő-lekérdezéssel.
Text Ticker (JetBlog) General fül → Use Custom Query, majd a Select query from JetEngine Query Builder mező.
Advanced Carousel (JetElements) Slides fül → Use JetEngine query, majd Select Query; a kép, cím és leírás mezőkhöz a Dynamic Tags gombbal rendelsz egyéni mezőket.
Advanced Map (JetElements) Pins szakasz → Use JetEngine query, majd Select Query; a Pin Address és Pin Description mezőkhöz dinamikus címkével kötsz mezőt.
Query Loop (Bricks) A Query mezőben a típus „JetEngine Query Builder”, majd a JetEngine Queries mezőben a lekérdezés.

Az egyes felhasználási módok részletes lépései a többi Query Builder fejezetben és a Listázás csoportban találhatók.

Készült:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások