Listázási sablon a blokkszerkesztőben

Ha egyéni bejegyzéstípus vagy egyéni taxonómia elemeit Listing Grid blokkal akarod megjeleníteni, előbb listázási sablont kell készítened hozzájuk. A sablon azt írja le, melyik elem hol és hogyan látszik egy rácselemben; a rács ezt a sablont ismétli meg minden elemre.

A lista forrásának kiválasztása

A JetEngine → Listázások/komponensek oldalon kattints az Új elem hozzáadása gombra, és válaszd ki a Lista forrását. Megjeleníthető forrás: bejegyzések, kifejezések, felhasználók, ismétlő mezők, REST API-végpontok és egyéni tartalomtípusok.

Forrás	Teendő
Bejegyzések	A Bejegyzéstípusból listában válaszd ki a típust. Nem csak a JetEngine bejegyzéstípusai, hanem az alap bejegyzések, oldalak, média és a WooCommerce-termékek is listázhatók.
Lekérdezéskészítő	Előbb állítsd össze a lekérdezést, és válaszd ki forrásnak. A lekérdezés eredménye a sablonnal jeleníthető meg.
Kifejezések	A Taxonómiából listában add meg a taxonómiát. Egyéni taxonómiához és alap kategóriákhoz, WooCommerce-termékkategóriákhoz is használható.
Felhasználók	Az alap felhasználói mezők mellett az egyéni metaboxok is megjeleníthetők. Az alap mezők: azonosító, bejelentkezési név, becenév, e-mail, weboldal, regisztráció dátuma (automatikus, nem módosítható) és a nyilvánosan megjelenített név.
Ismétlő mező	Válaszd ki a bejegyzéstípust, az Ismétlő forrását (JetEngine vagy ACF; a JetEngine opciók oldalai külön vannak, mert azok egyetlen, az egész webhelyen használható mezőt tartalmaznak), majd írd be az ismétlő nevét vagy válaszd ki az opciót.
REST API végpont	A From API endpoint listából válaszd ki a végpontot; így más webhelyen lévő egyéni tartalomtípus elemei is megjeleníthetők.
Egyéni tartalomtípus	A From content type listából válaszd ki a tartalomtípust. A menet ugyanaz, mint a bejegyzéseknél.

A sablon létrehozása

Add meg a sablon nevét, a Listázási nézet legyen Blokkok (Gutenberg), majd kattints a Listázási elem létrehozása gombra. Megnyílik a blokkszerkesztő.

Melyik blokkokat használhatod?

Bármelyiket, de két fajta van:

• Szokásos blokk: statikus elem. Ha például egy Image blokkban a webhely logója van, a rács minden eleménél ugyanaz a logó jelenik meg.
• Dinamikus blokk: a JetEngine blokkjai (Dynamic Field, Dynamic Image, Dynamic Meta, Dynamic Repeater, Dynamic Terms, Dynamic Link) az elem metamezőinek értékét jelenítik meg, ezért elemenként más és más a tartalom.

A sablon felépítése

A blokkokat a szokásos módon adod hozzá. Ügyelj a sablon szerkezetére: a rácsban jóval kisebb lesz, mint a szerkesztőben.

A példában három blokk szerepel:

1. Dynamic Field: a Source legyen Meta Data, a Meta Key mezőbe írd az elem címét tartalmazó metamező nevét.
2. Dynamic Image: a Source listából válaszd a képet tartalmazó metamezőt, és add meg a Image Size értékét.
3. Egy sima Image blokk, hogy lásd a különbséget a statikus és a dinamikus blokk között.

Kattints a Közzététel gombra.

Megjelenítés a Listing Grid blokkal

1. Az Oldalak → Minden oldal menüben nyisd meg az oldalt, amelyen a rácsot el akarod helyezni.
2. Add hozzá a Listing Grid blokkot.
3. A General szakasz Listing listájában válaszd ki az elkészült sablont.

A rács minden eleme ugyanazt az elrendezést és stílust kapja. A Dynamic Image elemenként más képet húz be, az Image blokk pedig mindenhol ugyanazt mutatja.

A rács beállításait a Listing Grid widget fejezet tartalmazza, a többi szerkesztő sablonjait a Listázási sablon áttekintése.