Bejegyzések lekérdezése a Listing Gridben

Ha egy Listing Grid widgetet elhelyezel az oldalon, alapból egy bejegyzéstípus összes elemét mutatja. A Posts Query szakaszban azt szűkítheted, hogy az adott oldalon pontosan mely bejegyzések jelenjenek meg.

A Posts Query, a Terms Query, a Users Query és a Content Types Query régi (legacy) szakasz. Helyettük a Lekérdezéskészítő és a Custom Query fül használata ajánlott. A régi beállításokat a Listing Grid widget fejezet foglalja össze.

Első áttekintés

Megnyitva a Posts Query szakaszt egy üres tételt látsz. Minden lekérdezés külön tétel; az Add Item gombbal annyit vehetsz fel, amennyi kell. A tétel Type (típus) listájának öt értéke van: Posts & Author Parameters, Order & Offset, Tax Query, Meta Query és Date Query.

Két további beállítás is van: a Meta query relation és a Tax query relation. Ha több meta- vagy taxonómia-lekérdezést vettél fel, itt adod meg, hogyan működnek együtt: AND esetén mindegyiknek teljesülnie kell, OR esetén elég az egyiknek.

Posts & Author Parameters

Bejegyzések szűrése azonosító, kapcsolat, állapot vagy szerző szerint.

Beállítás	Mit csinál
Include posts by IDs	A megjelenítendő bejegyzések azonosítói vesszővel elválasztva. A Dynamic Tags gombbal paraméter alapján is megadhatod, például kapcsolódó elemek szerint.
Exclude posts by IDs	A kihagyandó bejegyzések azonosítói.
Get child of	Egy vagy több szülőbejegyzés gyermekeit jeleníti meg; a szülők azonosítóit add meg.
Get posts with status	Csak a kiválasztott állapotú bejegyzések látszanak, például Publish vagy Private.
Posts by author	Csak a kiválasztott szerző bejegyzései.
Search Query	Csak azok az elemek, amelyek címében vagy leírásában szerepel a beírt szó.
Get posts from store	Csak azok az elemek, amelyek egy adott adattárba kerültek.

Order & Offset

Eltolás és sorrend.

• Posts offset: ennyi elemet hagy ki a lista elejéről. Ha 1-et írsz, a rács első eleme a lista második bejegyzése lesz.
• Order: növekvő (ASC) vagy csökkenő (DESC) sorrend.
• Order by: mi szerint rendezzen. Kombinálható az Order mezővel, például dátum szerint csökkenő sorrendben.

Az Order by lista többféle szempontot ad, például a címet (ábécésorrend), a dátumot vagy egy metamezőt (szöveg, szám vagy dátum értékkel), de véletlen sorrendet is. Dátummező szerinti rendezéshez válaszd az Order by listában a Meta value értéket, a Meta key for order mezőbe írd a metamező nevét (például custom-dates), a Meta type listában pedig a Date típust. Az Order & Offset más lekérdezéstípusokkal is kombinálható: az Add new item gombbal új elemet veszel fel, és a beállításait is megadod. Ha az Order értékét ASC-ről DESC-re váltod (vagy fordítva), az eltolás mindig az éppen első elemeket rejti el.

Az „Order by” értékei

(Növekvő sorrendet feltételezve.)

Érték	Hogyan rendez
ID	A bejegyzés azonosítója szerint: az 1-es azonosítójú elöl, utána a 2-es és így tovább.
Author	A szerző azonosítója szerint (az 1-es azonosítójú rendszergazda bejegyzései előbb jönnek).
Title	A cím ábécésorrendjében: Argentína, Belgium, Kanada és így tovább.
Name	A bejegyzés keresőbarát neve (slug) szerint: az „almas-pite” megelőzi a „banankenyer” nevűt.
Type	A bejegyzéstípus szerint, ha a rácsba több típust is bevontál.
Date	A közzététel dátuma szerint: a februárban közzétett előbb jön a márciusinál.
Modified	Az utolsó módosítás dátuma szerint.
Parent	A szülő létrehozási ideje szerint. A szülő az Oldaljellemzők szakaszban állítható be a szerkesztőben, de csak akkor, ha a bejegyzéstípus haladó beállításainál a Hierarchical kapcsoló be van kapcsolva, és a Page Attributes támogatás is aktív.
Random	Minden oldalfrissítéskor véletlen sorrend.
Comment count	A hozzászólások száma szerint.
Relevance	Keresési relevancia szerint: először a pontos mondategyezés, majd az, amelynek címében szerepel minden keresett szó, majd amelyikben legalább egy, végül, amelynek a tartalmában szerepel a teljes mondat. Működéséhez az oldalon keresésnek kell lennie, például a JetSmartFilters keresőszűrőjének.
Menu order	A szerkesztőben megadott Sorrend mező szerint (0, 1, 2, …). A mező csak akkor jelenik meg, ha a bejegyzéstípus haladó beállításainál a Page Attributes támogatás be van jelölve.
Meta value	Egy metamező értéke szerint. Ha a Meta key for order mezőbe a _pricing kulcsot írod, a rács az árak szerint rendez (150, 180, 200).
Meta clause	Meta-záradék szerint. A Meta Query típussal együtt működik: hozd létre a lekérdezést, és másold a Meta Query Clause értékét a rendezés Meta clause to order mezőjébe.
Preserve post ID order given in the “Include posts by IDs” option	Ha a Posts & Author Parameters tételben azonosítókat adtál meg az Include posts by IDs mezőben, a rács megtartja a beírás sorrendjét. A „340, 723, 620” azonosítók így ebben a sorrendben jönnek, nélküle számsorrendben (340, 620, 723).

Tax Query

Taxonómia (kategória, címke) szerinti szűrés.

Beállítás	Mit csinál
Taxonomy	A bejegyzésekre alkalmazott taxonómia. A listában minden elérhető taxonómia szerepel.
Taxonomy from meta field	Ha egy metamezőben adod meg a taxonómia nevét, a mező értéke lesz a lekérdezés taxonómiája.
Operator	Hogyan működjenek együtt a kifejezések. IN: a kiválasztott taxonómia értékeihez tartozó elemek. NOT IN: elrejti a kiválasztott kifejezéshez tartozó elemeket. AND: több feltétel egyszerre. EXIST: egy alkérdésben létező rekordot keres. NOT EXIST: a fordítottját.
Field	Hogyan azonosítod a kifejezéseket: Term ID, Slug vagy Name. Ha a Term ID-t választod, a Terms mezőbe a %current_terms% makrót írva az oldal fő bejegyzésével azonos kifejezésű elemek jelennek meg. További kifejezéseket vesszővel elválasztott azonosítókkal adhatsz hozzá.
Terms	Az előbb választott módon megadott kifejezések (azonosító, slug vagy név).
Terms from meta field	A kifejezéseket egy metamező értékéből veszi, így dinamikusan állítható.

Meta Query

Csak azok a bejegyzések jelennek meg, amelyeknek egy metamezője a megadott értékhez hasonló (vagy attól eltérő, az operátortól függően).

Beállítás	Mit csinál
Key (name/ID)	A metamező neve vagy azonosítója.
Operator	Az összehasonlítás módja, lásd lent.
Value	A mező értékével összevetett érték.
Or get value from query variable	Az értéket az URL egyik lekérdezési változójából veszi.
Type	A meta-záradék típusa.
Meta Query Clause	Egyedi név. Frissítés után a záradék kiválasztható az Order & Offset tételben, így egyéni záradék szerint rendezhetsz.

Az Operator értékei:

• Equal: egyenlő érték. Not Equal: nem egyenlő.
• Greater than, Greater or equal, Less than, Equal or less: nagyobb, nagyobb vagy egyenlő, kisebb, kisebb vagy egyenlő; csak számértékekkel működnek.
• Like: azokat az elemeket mutatja, amelyek tartalmazzák a megadott értéket. Not like: amelyek nem tartalmazzák.
• In: több érték megadásakor azokat, amelyeknek legalább az egyike szerepel. Not in: azokat, amelyekben nincs ott egyik megadott érték sem.
• Between: két érték közötti elemek. Not between: az intervallumon kívüliek.
• Exist: azokat az elemeket mutatja, amelyeknek van ilyen kulcsa (az érték nem kell). Not exist: amelyeknek nincs.

Date Query

Dátum szerinti szűrés.

• Column: melyik dátumot használja: a létrehozásét vagy a módosításét.
• After: csak az e dátum után létrehozott vagy módosított elemek látszanak.
• Before: csak az e dátum előtt létrehozott vagy módosított elemek látszanak.