# Divi 5 modulok: vélemények (Supreme Testimonials)

> A Supreme Testimonials modul és a Testimonial Item gyermek elem: források, elrendezések, könyvtár, véleménygyűjtő űrlap, schema és beállítások.

A **Supreme Testimonials** vélemény-modul a **Divi Supreme** kategóriából. A szülő dönti el, honnan jönnek a vélemények, hogyan rendeződnek a kártyák, látszik-e az átlagos értékelés, a szűrők és a gyűjtőűrlap. Minden **Testimonial Item** gyermek egy véleménykártya. A beállítások feliratai a builderben angolul maradnak.

A vélemények jöhetnek a Visual Builderből, a jóváhagyott könyvtári véleményekből, a WooCommerce termékértékelésekből vagy egy bejegyzés hozzászólásaiból. Google, Facebook, Trustpilot és hasonló külső források jelenleg nem érhetők el a **Content source** listában.

Az induló kártya szerzője Alex Rivera, szerepe Customer, értékelése 5 csillag, szövege egy minta idézet.

Mielőtt használod, ellenőrizd, hogy a **Testimonials** be van kapcsolva a **Divi Supreme Pro → Modulok** fülön. A **Divi Supreme → Testimonials** menü is csak bekapcsolt modulnál látszik.

## Mit tud

- Kártyák építése a Visual Builderben: a gyermek elemekben szerző, szerep, cég, avatar, értékelés, dátum, idézet, opcionális videó és termékkép.
- Véleménykönyvtár: a **Divi Supreme → Testimonials** alatti jóváhagyott vélemények. A szerkesztésük minden használó modulban frissül.
- Gyűjtőűrlap az oldalon: az új beküldések addig várnak, amíg jóvá nem hagyod őket. A szerkesztőben való közzététel nem elég.
- WooCommerce és hozzászólások: jóváhagyott termékértékelések, illetve ennek vagy egy másik bejegyzésnek a hozzászólásai. Ezek nem kerülnek be a könyvtárba.
- Elrendezések: Grid, List, Carousel, Masonry, Marquee.
- Összegző elemek: átlagos pontszám, értékelési hisztogram, szűrők (értékelés, forrás, címke), forráscímke a kártyákon.
- Review schema: opcionális JSON-LD a keresőnek. Csak a saját gyűjtésű véleményekhez használd.

## Mikor ne használd

- Ha Google, Facebook vagy Trustpilot importot várnál: az még nincs. Használj Visual Builder elemeket, könyvtárat, WooCommerce-et vagy hozzászólásokat.
- A hozzászólásokra nincs minimális értékelési szűrő. Ha számít a csillag, a könyvtárat vagy a WooCommerce-et használd.
- Más oldalról átmásolt vélemények mellé ne kapcsolj schema jelölést: a schema csak a saját gyűjtésű véleményekre jó. A LocalBusiness és az Organization elemtípus nem kap jelölést.

## Hogyan add hozzá

1. Nyisd meg az oldalt a Divi 5 Visual Builderben.
2. Add hozzá a **Supreme Testimonials** modult.
3. Hagyd meg az induló kártyát, vagy kattints az **Add Testimonial Item** gombra.
4. A **Content → Source** alatt hagyd a **Visual Builder items** értéket, vagy válts a könyvtárra, a WooCommerce-re vagy a hozzászólásokra.
5. Nyiss meg egy gyermeket, és állítsd be az **Author**, **Quote** és **Rating** mezőt.
6. A **Content → Layout** alatt hagyd a **Grid** elrendezést (alapból 3 / 2 / 1 oszlop), vagy válaszd a **List**, **Carousel**, **Masonry**, **Marquee** értéket.
7. Szükség esetén a **Summary** alatt kapcsold ki vagy be az átlagot, a hisztogramot, a szűrőket és a forráscímkét.
8. Szükség esetén a **Collect reviews** alatt kapcsold be az űrlapot, és a beküldéseket hagyd jóvá a **Divi Supreme → Testimonials** alatt.
9. A **Design** fülön formázd a csillagokat, a kártyát, az idézetet és az űrlapot.
10. Mentsd az oldalt, és nézd meg a közzétett oldalon.

A gyermek elemet külön nem teheted az oldalra a modulválasztóból, mindig a szülőből add hozzá.

## Tartalomforrások

| Forrás | Mit csinálsz |
|---|---|
| **Visual Builder items** | A modulban hozod létre és szerkeszted a Testimonial Item gyermekeket. |
| **Testimonials library** | A jóváhagyott könyvtári vélemények töltődnek be. A **Tags** mezővel (vesszővel elválasztott slugok) szűkíthetsz. |
| **WooCommerce reviews** | Jóváhagyott termékértékelések (`comment_type` = review). A WooCommerce-nek aktívnak kell lennie. A **Product ID** üresen az összes termék. |
| **WordPress comments** | Jóváhagyott hozzászólások. Üres **Post ID** esetén erre az oldalra vonatkozik, vagy megadhatsz másik bejegyzés azonosítót. Nincs minimális értékelési szűrő. |

Lekérdezéses források (könyvtár, WooCommerce, hozzászólások) beállításai:

| Beállítás | Alapérték | Mit csinál |
|---|---|---|
| **Count** | 10 | Hány véleményt tölt be (1 és 50 között). |
| **Order by** | Date | Date / Rating / Name / Random. Hozzászólásoknál Date / Name / Random (Rating nincs). |
| **Order** | Descending | A csökkenő sorrend a legújabbat vagy legjobbat mutatja elöl. |
| **Minimum rating** | 0 | A kisebb csillagszámú véleményeket elrejti. A 0 mindent mutat. Hozzászólásoknál nem látszik. |

## Véleménykönyvtár

1. Nyisd meg a **WordPress → Divi Supreme → Testimonials** menüt.
2. Vegyél fel egy véleményt, vagy várd meg egy gyűjtőűrlap beküldését.
3. Töltsd ki a **Testimonial details** mezőit: szerző, e-mail (a weboldalon nem látszik), szerep, cég, értékelés, dátum, forrás, forrás URL, videó URL, schemába felvétel.
4. Kattints az **Approve** gombra. A weboldalon a vélemények csak jóváhagyás után látszanak, a szerkesztőben való közzététel nem elég.
5. A Testimonials modulban állítsd a **Content source** értékét **Testimonials library**-re.

A címkék a `dsm_testimonial_tag` taxonómiát használják. A **Testimonials** menü rejtve van, amíg a modul ki van kapcsolva a **Modules** fülön.

## Vélemények gyűjtése

A **Content → Collect reviews** alatt. A **Show collect form** alapból ki van kapcsolva.

Az új vélemények a **Divi Supreme → Testimonials** alatt várnak a jóváhagyásodra. Az alap sikerüzenet: „Thank you. Your review was submitted and is waiting for approval.”

| Beállítás | Alapérték | Mit csinál |
|---|---|---|
| **Name label** | Your name | A névmező felirata. |
| **Email label** | Email | Az e-mail mező felirata. |
| **Rating label** | Rating | A csillagos értékelés felirata. |
| **Review label** | Your review | A véleménymező felirata. |
| **Consent label** | üres | Opcionális jelölőnégyzet (például a közzétételi engedélyhez). Üresen nem látszik. |
| **Success message** | lásd fent | A beküldés utáni üzenet. Üresen nem látszik. |

Az űrlap kötelezően a nevet, az e-mailt és a véleményt küldi, opcionálisan az értékelést, a céget és a hozzájárulást. Az e-mail a könyvtárban tárolódik, a weboldalon nem látszik.

## Elrendezések

| Elrendezés | Megjegyzés |
|---|---|
| **Grid** | Az alap. **Columns** (alapból 3 / 2 / 1), **Gap** (alapból `20px`), opcionális **Equal Height** (alapból ki). |
| **List** | Egymás alatti kártyák. **Gap** és opcionális **Equal Height**. |
| **Carousel** | Csúszka. Látható diák (alapból 3 / 2 / 1), köz, automatikus lejátszás (ki), sebesség 3000 ms, szünet egérrel (be), végtelen (be), nyilak (be), lapozópontok (be), egyenlő magasság (be), középre igazított diák (ki). |
| **Masonry** | Pinterest-stílusú. Oszlopok és köz. |
| **Marquee** | Futó szalag. Irány: Left (alap) vagy Right. **Duration** (alapból `40s`). Egérrel: None / Pause (alap) / Reverse / Speed Up. Szünet, ha nem látszik (be). Szélfakítás (be, alapból `80px`). |

Ha több kiegészítő blokk be van kapcsolva, a sorrendjüket húzással állíthatod: Rating summary, Filters, Testimonials, Collect form.

## Összegzés (Summary)

| Beállítás | Alapérték | Mit csinál |
|---|---|---|
| **Show average rating** | be | A teljes átlagpontszám és a vélemények száma. |
| **Show rating histogram** | be | Az 5 csillagos, 4 csillagos és többi értékelés megoszlása. |
| **Show filters** | ki | Értékelés, forrás vagy címke szerinti szűrés újratöltés nélkül. Hozzászólásoknál nem látszik. |
| **Show source** | ki | Kis címke minden kártyán (Manual / Form / WooCommerce / Comments). |

Ha könyvtári, űrlapos és WooCommerce-es kártyákat keversz, kapcsold be a **Show source** opciót, hogy a látogató lássa, honnan jött az adott vélemény.

## Review schema

| Beállítás | Alapérték | Mit csinál |
|---|---|---|
| **Enable JSON-LD** | ki | Rejtett értékelési adatok, amelyeket a Google csillagokhoz használhat a keresőben. Csak saját gyűjtésű véleményekhez, más oldalról átmásoltakhoz nem. |
| **Item type** | Product | Product, SoftwareApplication, Book, Course, Event, Movie, Game, Recipe. A LocalBusiness és az Organization nem megfelelő, azokhoz nem küld jelölést. |
| **Item name** | | Az értékelt termék vagy elem neve. |

A kártyánkénti **Include in schema** alapból be van kapcsolva (a gyermek elemen és a könyvtári véleménynél). Válassz a Google által elfogadott elemtípust, és csak a saját gyűjtésű véleményeket jelöld.

## Kártya felépítése (Design → Card)

| Beállítás | Alapérték | Mit csinál |
|---|---|---|
| **Card Layout** | Quote above, author below | Vagy a szerző fent, vagy a szerző balra / jobbra. |
| **Author Position** | left | A név, a fotó és a beosztás igazítása. |
| **Avatar Placement** | Beside name | Vagy a név fölött (**Above name**). |
| **Quote Align** | left | A csillagok ehhez igazodnak, ha az idézettel vannak együtt. |
| **Stars Placement** | Below quote | Még: Above quote / Above author / Below author. |
| **Date Placement** | Footer | Még: idézet vagy szerző alatt / fölött. |
| **Source Placement** | Footer | Ugyanazok a helyek, mint a dátumnál. |
| **Product Image Placement** | Top of card | Vagy Bottom of card. |
| **Video Placement** | Top of card | Vagy Bottom of card. |

**Quote Style** (Design → Quote): Bar (alap), Icon vagy None. A kiemelő szín alapból `#2EA3F2`, a méret `4px`.

## Design

| Csoport | Mit formáz |
|---|---|
| Stars | A csillagok mérete, köze és színe (alapból `#f0ad4e`, `16px`, `2px`). |
| Rating Summary | Az összesített csillagok, a pontszám, a darabszám, a hisztogram sávja és kitöltése. |
| Author / Avatar / Role / Company / Date / Source | Betűk, szegély, térköz, méret. |
| Quote | Stílus, kiemelő szín, betű. |
| Card | Az elrendezési helyek, valamint a kártya háttere, szegélye, térköze, árnyéka. |
| Video | Fedőszín (alapból átlátszó), ikonszín (alapból fehér), méret. |
| Form | Az űrlap doboza, a csillagmező, a mezők, a feliratok, a küldés gomb. |
| Carousel arrows / dots | Csak Carousel elrendezésnél látszik. |

A szokásos Divi méret, térköz, szegély, árnyék, szűrő, transzformáció és animáció csoportok is érvényesek.

## Szülő beállításai röviden

| Beállítás | Alapérték | Megjegyzés |
|---|---|---|
| **Content source** | visual | Visual Builder items / Testimonials library / WooCommerce reviews / WordPress comments. |
| **Count** | 10 | Lekérdezéses forrásoknál, 1 és 50 között. |
| **Order by** | date | Date / Rating / Name / Random. |
| **Order** | DESC | Descending / Ascending. |
| **Minimum rating** | 0 | 0 és 5 között, 0,5-ös lépésekkel. |
| **Tags (comma-separated slugs)** | | Csak könyvtárnál. |
| **Product ID (optional)** | | Csak WooCommerce-nél. |
| **Post ID (optional)** | | Csak hozzászólásoknál. |
| **Layout** | grid | Grid / List / Carousel / Masonry / Marquee. |
| **Columns** | 3 / 2 / 1 | Grid és Masonry. |
| **Gap** | 20px | A Carousel nem használja. |
| **Equal Height** | ki | Grid / List / Masonry. |
| **Show collect form** | ki | A gyűjtőűrlap. |

## Testimonial Item: a gyermek elem

Ha a szülő forrása **Visual Builder items**, minden gyermek egy kártya, amit itt szerkesztesz. A könyvtár, a WooCommerce és a hozzászólás forrásnál a kártyák a lekérdezésből jönnek. A gyermek elemet külön nem teheted az oldalra.

| Beállítás | Alapérték | Mit csinál |
|---|---|---|
| **Author** | Alex Rivera | A vélemény írójának neve (dinamikus tartalom használható). |
| **Role** | Customer | Beosztás, például Founder vagy Customer (dinamikus tartalom használható). |
| **Company** | | Cég vagy weboldal neve (dinamikus tartalom használható). |
| **Avatar** | | Az író fotója (dinamikus tartalom használható). |
| **Rating (0 hides stars)** | 5 | 0 és 5 között, 0,5-ös lépésekkel. A 0 elrejti a csillagokat. |
| **Date** | üres | Opcionális dátum a kártyán (csak dátum, idő nélkül). Üresen nem látszik. |
| **Quote** | minta | A vélemény szövege (dinamikus tartalom használható). |
| **Video URL** | | YouTube, Vimeo vagy videófájl. Kattintásra felugró ablakban nyílik. |
| **Video poster** | | A lejátszás előtt látszó kép. Üresen, ha lehet, a videó bélyegképe. |
| **Product image** | | Opcionális termékfotó a kártyán. |
| **Source** | Manual | Manual / Form / WooCommerce / Comments. Csak akkor látszik, ha a szülőn a **Show source** be van kapcsolva. |
| **Source URL** | | Opcionális hivatkozás a forráscímkéhez. |
| **Tags (comma-separated)** | | A szülő szűrői által használt kulcsszavak. |
| **Include in schema** | be | Felveszi a véleményt a keresői jelölésbe, ha a Review schema be van kapcsolva. |

A Google, Facebook és Trustpilot forrásértékek a gyermeken sem elérhetők.

A gyermek **Design** fülén kártyánként felülírhatod a szülő értékeit (az üres érték a szülőtől öröklődik):

| Csoport | Mit formáz |
|---|---|
| Stars | A csillagok mérete, köze és színe ezen a kártyán. |
| Author / Avatar / Role / Company / Date / Source | Betűk, szegély, térköz, méret. |
| Quote | Háttér, szegély, szöveg, térköz. |
| Video | Fedő- és ikonszín, méret. |

## Tippek

- A könyvtári kártyák rejtve maradnak, amíg nem kattintasz az **Approve** gombra, a közzététel nem elég.
- A WooCommerce és a hozzászólások csak olvashatók: nem hoznak létre könyvtári bejegyzést.
- Ha egy kártyán nem kell csillag, állítsd a **Rating** értékét `0`-ra.
- A **Tags** csak akkor számít, ha a szülőn a **Show filters** be van kapcsolva (vagy ha könyvtári lekérdezést szűrsz slug alapján).
- Ha kártyánként dinamikus tartalom kell, a Divi Loopot a **Testimonial Item** gyermekre tedd, lekérdezéses forrásoknál ne a szülőre.
