# Közösségi értékelések widget: áttekintés, beállítások és kézi értékelések

> A Közösségi értékelések widget minden szakasza, a források, és hogyan veszel fel értékeléseket kézzel, fiók nélkül.

A **Közösségi értékelések** widget vásárlói véleményeket tesz az Elementor-oldalra. Az értékeléseket egy Facebook-oldalról vagy egy Google-os üzleti adatlapról húzza be, de kézzel is beírhatod őket. Megjeleníthető értékelőkártyák falaként, vagy kompakt **Jelvényként**, amely az értékelés összegzését mutatja. A widget a Pro bővítmény része, az ingyenes bővítményben nincs meg.

## Bekapcsolás és előfeltételek

1. Az Elementor (az ingyenes bővítmény) legyen telepítve és aktív.
2. Nyisd meg: **The Plus Addons → Widgets**.
3. Keress rá a **Social Reviews** névre, és kapcsold be a kapcsolóját.
4. A szerkesztőben a widget **Közösségi értékelések** néven van a panelen.

A **Kézi kifizetés** (angolul **Manual**) forrásnak nem kell token, kulcs vagy bejelentkezés, ezzel azonnal elkezdhetsz dolgozni. A Facebook és a Google forrást a webszervered hívja meg az oldal megjelenítésekor, nem a látogató böngészője, ezért a szervernek tudnia kell kifelé HTTPS-kéréseket küldeni.

> **Megjegyzés**
>
> A widget panelján a **Manual** forrás felirata a magyar fordításban **Kézi kifizetés**. Ez a felirat így áll a felületen, de értelme „kézi bevitel”.

## Tartalom szakasz

![A Közösségi értékelések panelje: típus, stílus, elrendezés és a források](./kepek/kozosseg-funkciok-1-velemenyek-panel.webp)

*A Közösségi értékelések panelje: típus, stílus, elrendezés és a források* (https://minta-bolt.hu/wp-admin/post.php?post=24&action=elementor)

A képen a **Tartalom** szakasz látszik: a **Típus**, a három **Stílus** kép, az **Elrendezés** és a **Közösségi értékelések** lista, benne egy kézi forrású elemmel. Alatta a további szakaszok állnak.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Típus** | **Értékelések**: egyedi értékelőkártyák. **Jelvény**: egyetlen, kompakt összegző blokk. A panel többi része ettől függ. | **Értékelések** |
| **Stílus** | Három képes választás. **Style-1**: elöl a név és a csillagok, majd az értékelés, a forrás logója és a dátum. **Style-2**: az értékelés szövegével kezd, a név alatta van. **Style-3**: a csillagokkal kezd, forráslogó nélkül. | **Style-1** |
| **Elrendezési stílus** (**Style layout**) | Csak **Style-2**-nél látszik, két változat: **layout-1** és **layout-2**. | **layout-1** |
| **Elrendezés** | **Rács**, **Masonry** vagy **Körhinta**. Körhintánál három szakasz eltűnik, lásd lent. | **Rács** |
| **Közösségi értékelések** | Az ismétlődő lista: forrásonként egy elem, bármennyit felvehetsz. | egy elem |

### A lista elemei

Egy elem kinyitásakor először a **Forrás** mezőt választod, az alatta lévő mezők ehhez igazodnak.

![Egy kézi forrású elem kinyitva](./kepek/kozosseg-funkciok-1-velemenyek-elem.webp)

*Egy kézi forrású elem kinyitva* (https://minta-bolt.hu/wp-admin/post.php?post=24&action=elementor)

A képen az elem a **Kézi kifizetés** forrással nyitva, alatta a **Felhasználói profilkép** mezővel.

| Mező | Mikor látszik | Mit csinál |
|---|---|---|
| **Forrás** | mindig | **Facebook**, **Google** vagy **Kézi kifizetés** |
| **Hozzáférési token** | nem kézi forrásnál | A Facebook-token vagy a Google Places API-kulcs. A Facebook-soroknál van **Generate Access Token** gomb is. |
| **Oldal/hely ID** | Facebooknál és Google-nél | A Facebook-oldal azonosítója, illetve a hely Google Place ID-je |
| **Eredmény típusa** | Facebooknál | **Default**, **Negative** vagy **Positive** |
| **Nyelv** | Google-nél | Milyen nyelven kéri az értékeléseket a Google-től (alapérték: en) |
| **Felhasználói profilkép**, **Felhasználónév**, **Értékelési üzenet**, **Dátum**, **Értékelés értéke** | kézi forrásnál | Maga az értékelés, kézzel beírva |
| **Platform** | kézi forrásnál | Melyik logót és szöveget kapja a kártya: Facebook, Google vagy **Kézi kifizetés**. Utóbbinál megjelenik a **Platform neve** és a **Platformlogó**, hogy saját forrást adj meg. |
| **Értékelési ikon** | mindig | Az értékeléshez használt ikon, alapból csillag |
| **Kategória (szűréshez)** | mindig | Az elem címkéje, a kategóriaszűrő ezt használja (például Kategória1, Kategória2) |
| **Eredmények maximális száma** | **Értékelések** típusnál | Hány értékelést ad ez az elem. Alapérték: 6. |

## Értékelési opció

Csak **Értékelések** típusnál látszik.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Negatív értékelés csillagküszöbe** | Az egycsillagos Facebook-értékelést 1, 2, 3 vagy 4 csillagosra értékeli át | 1 |
| **ID megjelenítése és kizárás** | A szerkesztőben kiírja minden értékelés azonosítóját, hogy kimásolhasd. A nyilvános oldalon semmi nem jelenik meg. | ki |
| **Bejegyzés-ID-k kizárása** | A kihagyandó azonosítók vesszővel elválasztva. Csak a fenti kapcsoló bekapcsolt állapotában látszik. | üres |

## Jelvénybeállítások

Csak **Jelvény** típusnál látszik. A jelvény egyetlen blokk, amely a listázás helyett az értékelést összegzi.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Utótag tartalma** | A szám utáni szöveg | Recommended By |
| **Előtag tartalma** | A szám előtti szöveg, csak **Style-1**-nél | People |
| **Ajánlás megjelenítése** | Az ajánlás sort mutatja | be |
| **Előtag szövege** | A gombok fölötti kérdés | Would You Recommend |
| **(egyetlen \| több) gomb** | Az ajánlás gombokat mutatja | be |
| **Első gomb** / **Második gomb** | A gombok feliratai | YES / NO |
| **Ikon megjelenítése** | A forrás ikonját mutatja a jelvényen | be |

A jelvény saját **Extra opciók** szakaszt is kap, saját **Frissítési idővel**.

## Oszlopok kezelése

Hány kártya áll egymás mellett. **Körhinta** elrendezésben nem látszik, a körhintának saját oszlopbeállításai vannak.

| Beállítás | Alapérték |
|---|---|
| **Oszlop asztali nézetben** | Column 4: négy kártya egymás mellett |
| **Oszlop táblagépen** | Column 3: három egymás mellett |
| **Oszlop mobilon** | Column 2: kettő egymás mellett |
| **Oszlopok közötti térköz** | 15 px minden oldalon (px, % vagy em) |

A legördülők feliratai nem egyeznek a mögöttük tárolt számmal. Mindig a látható feliratot kövesd: a **Column 4** valóban négy oszlopot ad.

## Szűrési opció

A **Kategória (szűréshez)** mezőkbe írt értékekből szűrőgombsort csinál az értékelések fölé. **Körhinta** elrendezésben nem látszik.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Kategória szerinti szűrés** | Bekapcsolja a szűrősort | ki |
| **Az összes szűrőkategória szövege** | Az „összes” gomb felirata | All |
| **Kategóriaszűrő stílusa** | A gombok kész kinézete | style-1 |
| **Szűrőstílus rámutatáskor** | A rámutatás kész hatása | style-1 |
| **Szűrés illesztése** | Balra, középre vagy jobbra | középre |

## Továbbiak betöltése / késleltetett betöltés

Eleinte csak a fal egy részét mutatja. Mielőtt használod, olvasd el az alábbi korlátot.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **További bejegyzések betöltése** | A **Select Options** (ki), a **Load More** vagy a **Lazy Load** közül választasz | Select Options |
| **Megjelenített bejegyzések maximális száma** | Hány kártya látszik a gomb előtt (1 és 200 között) | 8 |
| **További bejegyzések kattintásra vagy görgetésre** | Egy kattintás hány kártyát tölt be (1 és 30 között) | 4 |
| **Gomb szövege** | A gomb felirata | Load More |
| **Betöltési szöveg** | Betöltés közben ez látszik | Loading… |
| **Az összes bejegyzés betöltése után megjelenő szöveg** | Ha nincs több | All done! |

## Extra opciók

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Frissítési idő** | Meddig tárolja a lekért eredményt: 1 hour, 2 hour, 6 hour, 1 day, 1 Week | 1 day |
| **Szövegkorlát** | Megvágja a hosszú értékeléseket | be |
| **Korlátozás alapja** | Karakter (**Character**) vagy szó (**Word**) | Character |
| **Korlátozás értéke** | A vágás helye (1 és 2000 között) | 100 |
| **Több szöveg** / **Kevesebb szöveg** | A kibontó és összecsukó link szövege | Show More / Show Less |
| **Pontok megjelenítése** | Három pontot tesz a vágás helyére | be |
| **Tartalom görgetősávja** | Rögzített magasságot és saját görgetősávot ad a kártyának a vágás helyett | ki |

A **Szövegkorlát** alapból be van kapcsolva, 100 karakterrel, ezért a hosszabb értékelések „Több megjelenítése” hivatkozással végződnek. Ha a teljes szöveget akarod, kapcsold ki.

## Teljesítmény és Stílus fül

A **Teljesítmény** (alapból ki) eltárolja a lekért értékeléseket, hogy az oldal ne hívja meg minden látogatáskor a Facebookot vagy a Google-t. Az **Adatok mentése** (**Enable** vagy **Disable**, alapból **Disable**) azt szabályozza, hogy ez a tár megmaradjon-e az adatbázisban. Törölni is lehet a tárat.

A **Stílus** fül az általános, a Facebook-, a Google- és a kézi forrásonkénti kinézetet, a szövegek, a görgetősáv, a betöltő gomb, a kategóriaszűrő, a fő és az alsó terület megjelenését állítja. A **Carousel** szakasz csak körhinta elrendezésben látszik.

## Kézi értékelés felvétele

A kézi forrás az egyetlen, amelyhez nem kell fiók, ezért ezzel a legkönnyebb kipróbálni a widgetet.

1. Szerkeszd az oldalt Elementorral, és húzd rá a **Közösségi értékelések** widgetet.
2. A **Tartalom** szakaszban hagyd a **Típust** **Értékelések**en, és válassz **Stílust** és **Elrendezést**.
3. Nyisd ki az első elemet a **Közösségi értékelések** listában, és állítsd a **Forrás** mezőt **Kézi kifizetés** értékre. A panel a token mezők helyett az értékelés mezőit mutatja.
4. Töltsd ki az értékelést, majd kattints az **Elem hozzáadása** gombra, és ismételd a következővel.

![Egy kézi értékelés a nyilvános oldalon](./kepek/kozosseg-funkciok-1-velemenyek-kezi.webp)

*Egy kézi értékelés a nyilvános oldalon* (https://minta-bolt.hu/tp-velemenyek-kezi/)

A képen egyetlen kézi értékelés látszik névvel, szöveggel, platformmal és dátummal.

| Mező | Megjegyzés |
|---|---|
| **Felhasználói profilkép** | Ha üres, szürke helyőrző kép jelenik meg |
| **Felhasználónév** | A kártyán megjelenő név |
| **Értékelési üzenet** | Maga az értékelés |
| **Platform** | Alapérték Facebook. A Facebook és a Google a saját logóját adja, a **Kézi kifizetés** saját neved és logód használja. |
| **Platform neve**, **Platformlogó** | Csak a **Kézi kifizetés** platformnál látszanak |
| **Dátum** | Szabad szöveg, semmit nem értelmez, úgy jelenik meg, ahogy beírtad |
| **Értékelés értéke** | Hány ikon legyen kitöltve. Nincs ellenőrzés, magadnak kell 1 és 5 között tartani. |

A kártya forrássora a **Platform** beállítást követi, nem a **Forrást**. Ha a kézi értékelés **Platformja** Google, a Google logója és a „Közzétéve: Google” szöveg jelenik meg. A kézi sorok keverhetők a Facebook- és Google-sorokkal ugyanabban a widgetben.

## Működés, korlátok és hibaelhárítás

- A **Rács** és a **Masonry** ugyanaz a felépítés, csak a kártyák elrendezése más.
- A körhinta egyszerre több kártyát mutat, és alapból maga lapoz.
- Minden lista elem külön kéri le az adatot. Ha egy forrás hibás, a többit nem érinti, csak ő ad egy hibakártyát a falra.
- Telefon méretű nézetben (390 px) a kártyák egymás alá kerülnek.
- A **Load More** és a **Lazy Load** jelenleg nem tölt be semmit: a gomb **Loading…** feliratra vált, és így is marad, a kártyák száma nem nő, és JavaScript-hiba keletkezik. Amíg ez nem javul, a megjeleníteni kívánt értékeléseket mind mutasd meg, és hagyd a **További bejegyzések betöltése** mezőt **Select Options**on.
- A **Szövegkorlát** alapból be van kapcsolva 100 karakterrel. Növeld a **Korlátozás értékét**, vagy kapcsold ki az **Extra opciók** szakaszban.
- Körhinta elrendezésben az **Oszlopok kezelése**, a **Szűrési opció** és a **Továbbiak betöltése / késleltetett betöltés** szakasz nem látszik.
- Körhintánál alapból nincsenek nyilak, csak pontok. A nyilakat a **Stílus** fül **Carousel** szakaszában kapcsolhatod be (**Nyilak megjelenítése**).
- Körhintánál (Style-1) a forráslogók nagyon nagyra nőnek, és a platformlogó nélküli kézi sor nagy szürke helyőrzőt kap. Rácsban a logók kicsik.
- Két **Extra opciók** szakasz van, egy az **Értékelések**, egy a **Jelvény** típushoz. Mindkettőnek saját **Frissítési ideje** van.
- A **Carousel** szakaszban két **Arrows Style** mező van: az egyik a nyíl kinézetét, a másik a helyzetét adja.
- A kártyán a hibaüzenet minden meghibásodásnál ugyanaz („Something Wrong” rózsaszín kártyán): nem derül ki belőle, rossz tokent adtál meg, vagy egyáltalán nem adtál meg semmit. A Google hibaüzenete szövegesen jelenik meg (például REQUEST_DENIED), az előtte álló „Error No : 200” az átvitel állapotkódja, nem hibakód.

### A widget nincs ott az Elementor panelen

Ellenőrizd, hogy a Pro bővítmény aktív-e, és hogy a widget be van-e kapcsolva a **The Plus Addons → Widgets** oldalon.

### Rózsaszín „Something Wrong” kártya jelenik meg

Az az elem nem érte el a forrását. Nézd át a **Hozzáférési token** és az **Oldal/hely ID** mezőt azon az elemen.

### Az értékeléseim mondat közben megszakadnak

A **Szövegkorlát** alapból 100 karakter. Növeld a **Korlátozás értékét**, vagy kapcsold ki.

### A **Szűrési opció** szakasz eltűnt

**Körhinta** elrendezésben vagy. Ott a szűrők, az oszlopok és a betöltés szakasz nem érhető el.

### A **Load More** nem csinál semmit

Ez ismert hiba, nem a beállításod miatt van. Állítsd vissza a **További bejegyzések betöltése** mezőt **Select Options**ra.

### Szürke négyzet van a profilkép helyén

Az adott elemen nincs **Felhasználói profilkép**. Adj meg egyet, vagy fogadd el a helyőrzőt.

### Facebook-logó látszik, pedig az értékelés nem onnan való

A **Platform** alapértéke Facebook. Állítsd **Kézi kifizetés**re, és töltsd ki a **Platform neve** és a **Platformlogó** mezőt.

### Csak néhány értékelés jelenik meg

Nézd meg az elem **Eredmények maximális száma** mezőjét, és hogy be van-e állítva a **Továbbiak betöltése / késleltetett betöltés** szakasz.