# Listing blokkok

> A Listing Field, Listing Image, Listing Link, Listing Terms és Listing Section blokk beállításai.

A Listing blokkok a Listing Builder elemszerkesztőjében (blokkszerkesztő) használhatók. Ezekből építed fel a listing egy elemét, amely a szűrt találatok rácsában ismétlődik. A blokkokat az **Intelligens szűrők → Listing Builder → Item** résznél a **Create new item** gombbal nyitott szerkesztőben adhatod hozzá és szabhatod testre ([A Listing Builder](https://hub.hellowp.io/hu/plugins/jet-smart-filters/listing-felepites/)).

## Listing Field

A blokk szöveget vagy értéket ír ki bejegyzésből, kifejezésből, felhasználóból vagy beállításból (például címet vagy egyéni mezőt).

**General** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **SOURCE** | Az adat forrása: **Post/Term/User/Object Data** (az objektum alapmezői, a mező a **POST OBJECT** listában adható meg), **Meta Data** (egy meta mező, a neve a **META KEY** mezőben), **Option Value** (a `wp_options` táblában tárolt érték, a kulcs az **OPTION NAME** mezőben; globális beállítások vagy bővítmények, sablonok által mentett értékek megjelenítésére jó). |
| **FALLBACK** | A szöveg, ami akkor jelenik meg, ha a mező üres. |

**Settings** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **FIELD TAG** | A HTML elem, amibe a mező kerül: **DIV** (tároló), **H1** és **H6** között (címsor), **P** (bekezdés), **SPAN** (soron belüli elem). |
| **Filter Value Before Output** | Bekapcsolva megjelenik a **FILTER CALLBACK** legördülő lista, amellyel az érték kimenet előtt átalakítható (különböző adattípusok megjelenítése). |
| **Customize Output** | Bekapcsolva megjelenik a **CUSTOMIZE OUTPUT FORMAT** szövegmező: szöveget fűzhetsz az érték elé és mögé. A `%s` a lekért értéket jelöli. |

Ha ugyanazt az értéket többször akarod beszúrni, a `%s` helyett `%1$s`-t írj.

## Listing Image

Dinamikus képet jelenít meg (például kiemelt képet vagy avatart), tartalék képpel és linkbeállítással.

**General** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **SOURCE** | A kép forrása: **Post thumbnail**, **Image From Meta Field** vagy **Image From Options**. Az utóbbi kettőnél a mező nevét a **META KEY** vagy az **OPTION NAME** mezőben add meg. |
| **IMAGE URL PREFIX** | Az **Image From Meta Field** és az **Image From Options** esetén használható előtag. Akkor kell, ha a mező csak a kép címének egy részét tárolja, például egy külső szerveren lévő fájlnevet. |
| **FALLBACK IMAGE** | Az a kép, ami megjelenik, ha a mezőben nincs adat. Feltölthető vagy a médiatárból választható. |

**Settings** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **IMAGE SIZE** | A kép mérete: **Full**, **Thumbnail**, **Medium**, **Large** és a további méretek. |
| **ALT TEXT** | A kép helyettesítő szövege. |

**Image Link** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **Linked Image** | Bekapcsolva a kép kattintható. Ekkor megjelenik a **LINK SOURCE** lista. |
| **LINK SOURCE** | A képre kerülő link: **Permalink**, **Attachment URL**, **URL From Meta Field** vagy **URL From Options**. |

## Listing Link

Dinamikus linket hoz létre (állandó link, meta mezőből vett cím vagy egyéni felirat), akadálymentességi és SEO beállításokkal.

**General** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **SOURCE** | Honnan jöjjön a link: **Permalink**, **Attachment URL**, **URL From Meta Field**, **URL From Options**. |
| **FALLBACK** | Mi jelenjen meg vagy mi legyen a cím, ha a dinamikus forrás üres vagy nem érhető el. |

**Label** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **LABEL TYPE** | A felirat megadása. **Static Text**: a **LABEL TEXT** mezőbe kézzel írod a feliratot. **Generate Dynamically**: a felirat a **LABEL SOURCE** listában választott forrásból jön (**Post/Term/User/Object Data**, **Meta Data**, **Option Value**), a hozzá tartozó **LABEL OBJECT**, **LABEL META KEY** vagy **LABEL OPTION NAME** mezővel. |
| **ARIA LABEL TYPE** | A képernyőolvasóknak szóló címke: örökölheti a fő feliratot, vagy megadhatsz egyéni szöveget. |

**Settings** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **URL PREFIX** | Előtag a linkhez, ha a meta mező csak a cím egy részét (például a fájlnevet) tárolja. |
| **URL ANCHOR** | A címhez fűzött horgony, `#` nélkül. Egy oldalszakaszra görgetéshez hasznos. |
| **Open in a New Window** | Kattintásra új böngészőlapon vagy ablakban nyílik meg. |
| **ADD “REL” ATTRIBUTE** | A linkhez adott `rel` érték (például **Alternate**, **Nofollow**, **Noopener**). SEO és biztonsági szempontból hasznos. |

## Listing Terms

Taxonómiakifejezéseket (kategóriákat, címkéket) jelenít meg rendezéssel, linkeléssel és formázással.

**Terms List** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **FROM TAXONOMY** | Melyik taxonómia kifejezései jelenjenek meg (kategóriák, címkék vagy egyéni taxonómia). |
| **Show All Terms** | Bekapcsolva a kiválasztott taxonómia összes kifejezése megjelenik. Kikapcsolva csak az aktuális bejegyzéshez tartozók. |
| **ORDER BY** | A kifejezések rendezési szempontja, például **Name**, **Slug**, **Term ID**. |
| **ORDER** | A rendezés iránya: **ASC** (növekvő, A→Z) vagy **DESC** (csökkenő, Z→A). |

**Display Settings** fül:

| Beállítás | Mit csinál |
| --- | --- |
| **Linked Terms** | Bekapcsolva minden kifejezés link, általában a kifejezés archívumára. Kikapcsolva sima szöveg. |
| **DELIMITER** | A kifejezéseket elválasztó karakter(ek). |
| **TEXT BEFORE TERMS LIST** | A lista elé kerülő szöveg vagy HTML. |
| **TEXT AFTER TERMS LIST** | A lista után kerülő szöveg vagy HTML. |

## Listing Section

A **Listing Section** az elemen belüli tartalom elrendezését és igazítását szabályozza. Olyan, mint egy tároló vagy csoport blokk, de kifejezetten a JetSmartFilters listingjeihez készült.

| Beállítás | Mit csinál |
| --- | --- |
| **CONTENT DIRECTION** | A tartalom iránya a szekción belül: vízszintes (→) vagy függőleges (↓). |
| **JUSTIFY CONTENT** | A vízszintes igazítás: az elemek az elejére, középre, a végére kerülhetnek, vagy egyenletesen elosztva. |
| **ALIGN ITEMS INSIDE SECTION** | A függőleges igazítás: felülre, középre, alulra, vagy kitöltve. |