# Listasablon az értékelésekhez

> Az értékelések megjelenítése listaelemként a JetEngine Listing Grid elemével Elementorban és Bricksben, egyedi lekérdezéssel.

A JetEngine-nel az értékeléseket listaelemként is kiírhatod: a sablonban dinamikus mezőkkel jeleníted meg a szerzőt, a címet, a szöveget, a dátumot, a pontszámot és a kedvelések számát, a **Listing Grid** pedig sorban kirakja az értékeléseket. Alapból az összes értékelés látszik; egy egyedi lekérdezéssel csak az aktuális bejegyzésé.

## Követelmények

- Elementor (az ingyenes változat is elég), a blokkszerkesztő vagy a Bricks téma.
- A JetReviews, legalább egy létező értékeléstípussal és egy beküldött, jóváhagyott értékeléssel.
- A JetEngine.

## Új listaelem

1. Nyisd meg a **JetEngine → Listázások/komponensek** oldalt, és kattints az **Új elem hozzáadása** gombra.
2. A **Listing source** (lista forrása) mezőben válaszd a **JetReviews** értéket.
3. A **Listing Item Name** mezőbe írd be a sablon nevét.
4. A **Listing View** mezőben válaszd ki, mivel szerkeszted a sablont: Elementor, blokkszerkesztő, Bricks vagy Timber/Twig.
5. Kattints a **Create Listing Item** gombra.

![A JetEngine listázási tételeinek oldala az Új elem hozzáadása gombbal](./kepek/listak-es-integraciok-listak-oldal.webp)

*A JetEngine listázási tételeinek oldala az Új elem hozzáadása gombbal* (https://minta-bolt.hu/wp-admin/edit.php?post_type=jet-engine)

A képen az üres lista látszik; innen indul az új elem.

## A sablon tartalma (Elementor)

Az értékelés adatait a JetEngine dinamikus widgetjeivel jeleníted meg, főleg a **Dynamic Field** widgettel.

1. A **Dynamic Field** widget **Source** értékét hagyd **Post/Term/User/Object Data** értéken.
2. Az **Object Field** listában a **JetReviews** csoportból válaszd ki a megjelenítendő mezőt: **Author Name** (szerző neve), **Title** (cím), **Content** (szöveg), **Date** (dátum), **Likes** és **Dislikes**. Minden mezőhöz külön **Dynamic Field** widget kell.
3. A dátumot „2 napja” formában is kiírhatod: kapcsold be a **Filter field output** kapcsolót, a **Callback** listában válaszd a **Human readable time difference** értéket, majd kapcsold be a **Customize field output** kapcsolót, és a `%s` után írd be: „ ezelőtt”.
4. A pontszámot a **Rating** widget mutatja: kattints a **Rating** mező melletti adatbázis ikonra, és válaszd a **Review Property** dinamikus címkét. Kattints a címkére, és a felugró ablakban a **Type** értéke legyen **Rating**.
5. A kedvelések és a nemtetszések számához adj hozzá két **Dynamic Field** widgetet a **Likes** és **Dislikes** objektummezővel, és állítsd be a **Field Icon** ikonokat.
6. Kattints a **Publish** (Közzététel) gombra.

## A sablon tartalma (Bricks)

A Bricksben ugyanezt a **Dynamic Field** elemmel építed fel. A kész oldalt például három oszlopra oszthatod:

1. Az első oszlopba tegyél egy **Dynamic Field** elemet a szerző nevével: a **Source** maradjon **Post/Term/User/Object Data**, az **Object Field** listából válaszd a JetReviews csoport **Author Name** értékét.
2. A második és a harmadik oszlopba újabb **Dynamic Field** elem kerül: a dátumhoz a **Date** mező (ugyanazzal a **Human readable time difference** visszahívással és „ezelőtt” szöveggel, mint fent), a pontszámhoz a **Rating** elem a **Review Property** dinamikus címkével, **Rating** típussal.
3. Adj hozzá egy elemet az értékelés szövegéhez (**Content**), és kettőt a **Likes** és **Dislikes** mezőkhöz, beállított ikonokkal.
4. Mentsd a sablont (**Save**).

## Lekérdezés (Query Builder)

A **Listing Grid** alapból minden értékelést kiír, bármelyik bejegyzéshez tartozik. Hogy csak az aktuális bejegyzés értékelései látsszanak, egyedi lekérdezés kell:

1. Nyisd meg a **JetEngine → Lekérdezéskészítő** oldalt, és kattints az új lekérdezés hozzáadására.
2. Add meg a lekérdezés nevét, a **Lekérdezés típusa** legyen **Jet Reviews Query**.
3. A **Jet Reviews-lekérdezés** részben a **Forrás** értéke legyen **Post**.
4. A **Forrás ID** mező melletti adatbázis ikonnal válaszd a **Current ID** makrót.
5. Szükség esetén állítsd a többi mezőt, majd mentsd a lekérdezést (**Add/Update Query**).

![A Jet Reviews-lekérdezés beállításai a Lekérdezéskészítőben](./kepek/listak-es-integraciok-query-jetreviews.webp)

*A Jet Reviews-lekérdezés beállításai a Lekérdezéskészítőben* (https://minta-bolt.hu/wp-admin/admin.php?page=jet-engine-query&query_action=add)

A képen a lekérdezés típusának kiválasztása után megjelenő **Jet Reviews-lekérdezés** rész látszik. A mezők leírása a [Jet Reviews-lekérdezés](https://hub.hellowp.io/hu/plugins/jet-reviews/listak-es-integraciok-lekerdezes/) fejezetben van.

## A lista elhelyezése az egyedi oldalon

1. Készíts (vagy nyiss meg) egy egyedi bejegyzés oldalsablont. Elementorban ez lehet a JetThemeCore-ral készült sablon, **Crocoblock → Theme Builder**.
2. Tedd a sablonra a **Listing Grid** widgetet, és válaszd ki a létrehozott listasablont. Ilyenkor még az összes értékelés látszik.
3. Nyisd ki a **Custom Query** részt, kapcsold be a **Use Custom Query** kapcsolót, és válaszd ki a létrehozott lekérdezést. Innentől csak az aktuális bejegyzés értékelései jelennek meg.
4. Szükség esetén tegyél a sablonra más elemeket is, például **Dynamic Field** vagy **Dynamic Image** elemet a bejegyzés adataihoz.

Bricksben ugyanígy kell eljárni, de a bejegyzés oldalsablonját csak a Bricks saját sablonszerkesztőjében készítheted el: a JetThemeCore a Bricksszel nem működik.

## Gyakori kérdések

**Szabhatom a listasablon kinézetét?** Igen, a kiválasztott szerkesztő stílus- és elrendezésbeállításaival.

**Mutathatok csak jóváhagyott értékeléseket?** A sablon a JetReviews adatait olvassa, a jóváhagyás a JetReviews-ban történik. Ha hiányzik egy értékelés a listából, először ellenőrizd, hogy jóvá van-e hagyva.

**Használhatom ugyanazt a sablont több bejegyzéshez?** Igen. A **Jet Reviews Query** a **Current ID** makróval mindig az éppen megnyitott bejegyzés értékeléseit adja.