# Közösségi értékelések: Facebook- és Google-értékelések, jelvények

> Facebook- és Google-értékelések bekötése a Közösségi értékelések widgetbe, a Google API-kulcs és Place ID beszerzése, valamint a jelvény típus.

A **Közösségi értékelések** widget Facebook-oldalak és Google-os üzleti adatlapok értékeléseit is meg tudja jeleníteni, akár értékelőkártyaként, akár **Jelvényként**. A widget minden beállítását az [áttekintő fejezetben](https://hub.hellowp.io/hu/plugins/theplus_elementor_addon/kozosseg-funkciok-velemenyek-attekintes/) találod. A widget a Pro bővítmény része, az Elementor legyen aktív, és a **The Plus Addons → Widgets** oldalon kapcsold be a **Social Reviews** widgetet.

Az értékeléseket a webszervered kéri le az oldal megjelenítésekor, nem a látogató böngészője, és az eredményt a **Frissítési idő** ideig (alapból 1 nap) gyorsítótárazza. Ha a tárhelyed blokkolja a kimenő HTTPS-kéréseket, a forrás egy másik tárhelyen működhet, a tiéden nem.

## Facebook-értékelések

Egy Facebook-sor egy Facebook-oldalt jelent. Hozzá az oldal hozzáférési tokenje és azonosítója kell.

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 **Facebook**ra.
4. Kattints a **Generate Access Token** gombra. Egy böngészőablak nyílik, ahol bejelentkezel a Facebookra, és kiválasztod az oldalt. Ellenőrizd, hogy a felugró ablakok nincsenek letiltva.
5. A token a **Hozzáférési token** mezőbe, az oldal azonosítója az **Oldal/hely ID** mezőbe kerül. Ha már megvan mindkettő, beírhatod őket kézzel is.
6. Az **Eredmények maximális száma** mezőben add meg, hány értékelést adjon ez az elem (alapérték: 6).

### Mit szűrhetsz

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Eredmény típusa** | **Default**: mindent mutat, **Negative**: csak a negatív, **Positive**: csak a pozitív értékeléseket | Default |
| **Eredmények maximális száma** | Hány értékelést ad ez az elem | 6 |
| **Értékelési ikon** | A csillagos értékeléshez használt ikon | csillag |
| **Kategória (szűréshez)** | Az elem címkéje, hogy a kategóriaszűrő kiválaszthassa. Akkor hasznos, ha a Facebookot Google- vagy kézi értékelésekkel keveri. | üres |

### Működés

- A Facebook-sor, amely nem tud csatlakozni, egyetlen rózsaszín kártyát ad a falhoz, a többi sort nem érinti. A kártyán „Something Wrong” felirat, a Facebook-logó és a „Posted On Facebook” szöveg áll.
- Az értékelések szövege alapból rövidített: a **Szövegkorlát** 100 karakternél vág, ezért a hosszabb értékelések végén „Több megjelenítése” hivatkozás látszik.
- A Facebook határozza meg, mit lát a token. A tokennek az oldalhoz kell tartoznia, és megfelelő jogosultságokkal kell rendelkeznie, a widget csak azt jeleníti meg, amit a Facebook visszaad.

### Hibaelhárítás

- **A kártyán „Something Wrong” áll.** A Facebook-hívás nem sikerült. Ez az egy üzenet minden okot lefed, az üresen hagyott **Hozzáférési token** mezőt is: az üres mező és a rossz token ugyanazt a kártyát adja. Nézd meg, hogy a **Hozzáférési token** és az **Oldal/hely ID** ki van-e töltve, és ugyanahhoz az oldalhoz tartozik-e.
- **Nem nyílik meg az ablak.** A böngésződ blokkolja. Engedélyezd a felugró ablakokat a saját oldaladon, és kattints újra a **Generate Access Token** gombra.
- **Az értékelések nem frissülnek.** Az eredmény gyorsítótárban van. Csökkentsd a **Frissítési időt** az **Extra opciók** szakaszban, a legrövidebb érték 1 óra.
- **Helyben működik, az éles szerveren nem.** Egyes tárhelyek letiltják a PHP kimenő HTTPS-kéréseit. A widget a szerveredről hívja a Facebookot, ezért ennek engedélyezettnek kell lennie.

## Google-értékelések

A Google-os üzleti adatlap értékeléséhez két adat kell a Google-tól: egy Places API-kulcs és a hely Place ID-je. Mindkettőt a Google adja, nem a The Plus Addons. A Google Cloud projekten a számlázásnak be kell lennie kapcsolva, még az ingyenes keret használatához is.

### Places API-kulcs készítése

Ezek a Google saját képernyői, és időnként változnak. Ha egy képernyő másképp néz ki, a keresett elemek nevei ugyanazok.

1. Nyisd meg a Google Cloud konzolt, és hozz létre egy projektet, ha még nincs.
2. Az irányítópulton nyisd meg a menüt, és válaszd az **APIs and services → Credentials** pontot.
3. Lépj a **Library** (könyvtár) oldalra.
4. Keress rá a **Places API** szolgáltatásra, nyisd meg, és kattints az **Enable** gombra.
5. Add meg a számlázási adataidat, ha még nem tetted. A Google a projekten a számlázást akkor is megköveteli, ha az ingyenes keretben maradsz.
6. A projekt irányítópultján kapcsold be a **Maps JavaScript API** szolgáltatást is. A könyvtárban rá is kereshetsz.
7. Nyisd meg a **Credentials** oldalt az oldalsávban, és kattints a **+ CREATE CREDENTIALS → API Key** lehetőségre.
8. Másold ki a kulcsot a felugró ablakból, és tárold biztonságos helyen.

### A Place ID megkeresése

1. Nyisd meg a Google Place ID-keresőjét.
2. Keress rá arra a helyre, amelynek az értékeléseit meg akarod jeleníteni.
3. A Place ID a térképen egy buboréksúgóban jelenik meg. Másold ki.

### Bekötés a widgetbe

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 **Google**ra.
4. Másold az API-kulcsot a **Hozzáférési token**, a Place ID-t az **Oldal/hely ID** mezőbe.
5. Ha szeretnéd, állítsd be a **Nyelv**, az **Eredmények maximális száma** (alapérték 6), az **Értékelési ikon** és a **Kategória (szűréshez)** mezőt.

### Az öt értékelés korlátja

A Google Place Details válasza kérésenként legfeljebb öt értékelést tartalmaz, akármekkora számot írsz az **Eredmények maximális száma** mezőbe. A widget **Teljesítmény** szakasza azt hivatott áthidalni, hogy a már lekért értékeléseket eltárolja, így a halmaz idővel, új értékelések érkezésével nőhet.

### Működés és korlátok

- A Google hibaüzenete szövegesen megjelenik a látogatónak is. A Google által elutasított kulcsnál a kártya ezt írja: „The provided API key is invalid.” és „REQUEST_DENIED”. Ez a szöveg a Google-tól jön, nem a bővítménytől.
- A rossz kulcs „Error No : 200” szöveggel is járhat. A 200 egy sikeresen elért, de hibával visszatérő kérés HTTP-állapotkódja, nem hibakód, ezért ne keress rá. A hasznos rész a mellette álló szöveg.
- Az értékelések szövege alapból rövidített (**Szövegkorlát**, 100 karakter), a hosszabbak végén „Több megjelenítése” hivatkozás áll.
- Kérésenként legfeljebb öt értékelés jön vissza.

### Hibaelhárítás

- **„The provided API key is invalid.”** Ez a Google üzenete: a kulcs rossz, nincs bekapcsolva rajta a Places API, nincs számlázás a projekten, vagy a kulcs korlátozva van, és a szerver nem használhatja.
- **Csak öt értékelés látszik.** Ez a Google kérésenkénti korlátja, nem widgetbeállítás. Az **Eredmények maximális számának** növelése nem segít.
- **Az értékelések sosem frissülnek.** Gyorsítótárban vannak. Csökkentsd a **Frissítési időt** az **Extra opciók** szakaszban, a legrövidebb érték 1 óra.

## Jelvény

A **Jelvény** a Google- vagy Facebook-értékelés összegzését mutatja egyetlen blokkban, az értékelések felsorolása helyett. Kevés helyet foglal, mégis társadalmi bizonyítékot ad. Az értékelőfalhoz hasonlóan a Google-jelvényhez is API-kulcs és Place ID kell, a Facebook-jelvényhez token és oldalazonosító.

1. Szerkeszd az oldalt Elementorral, és húzd rá a **Közösségi értékelések** widgetet.
2. A **Tartalom** szakaszban állítsd a **Típust** **Jelvény**re, majd válassz a három **Stílus** kép közül.
3. Állítsd a **Forrás** mezőt **Facebook**ra vagy **Google**ra.
4. Facebooknál kattints a **Generate Access Token** gombra, jelentkezz be, és válaszd ki az oldalt. A token a **Hozzáférési token**, az oldal azonosítója az **Oldal/hely ID** mezőbe kerül. Beírhatod őket kézzel is. Google-nél az API-kulcsot a **Hozzáférési token**, a Place ID-t az **Oldal/hely ID** mezőbe másold.
5. A jelvény címét a **Facebook-értékelés** vagy a **Google-értékelés** mezőben módosíthatod. Alapból „Facebook Reviews”, illetve „Google Reviews”.

![A Jelvény típus panelje: forrás, token és oldalazonosító](./kepek/kozosseg-funkciok-1-jelveny-panel.webp)

*A Jelvény típus panelje: forrás, token és oldalazonosító* (https://minta-bolt.hu/wp-admin/post.php?post=23&action=elementor)

A képen a **Típus** **Jelvény** állapotban látszik: a három jelvénystílus, a **Forrás**, a **Hozzáférési token** és az **Oldal/hely ID**, alattuk a **Jelvénybeállítások**, az **Extra opciók** és a **Teljesítmény** szakasz.

Minden szöveget a **Jelvénybeállítások** szakaszban módosíthatsz:

| 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 táblázat alapértékei az angol szövegek. Magyar felületen a jelvény alapszövegei magyarul jelennek meg (például „Ajánlja”, „Személyek”), és bármelyiket átírhatod.

### Működés

- A jelvény egyetlen blokk, nincs benne elrendezés, oszlop, szűrő és betöltési beállítás: ezek csak **Értékelések** típusnál léteznek, ezért a panel nagy része eltűnik.
- A jelvény saját gyorsítótár-beállítást kap: az **Extra opciók** szakaszában külön **Frissítési idő** van, amely független az értékelések típusénál lévőtől (alapérték 1 day).
- A hibás hívás a jelvényen belül látszik. Google-nél az elutasított kulcsnál a jelvény szövege a „Recommended By REQUEST_DENIED People” lesz, és „The provided API key is invalid.” üzenet jelenik meg: a Google állapotszava a saját szövegedbe kerül. Facebooknál rossz tokennel a jelvény kirajzolja a megszokott keretét (az avatarokat és a „Recommended By People” szöveget), a sarkában egy nyers 400-as számmal, ott pedig, ahol az értékelésnek lenne, „Something Wrong” áll. Ha számot vagy „Something Wrong” szöveget látsz a jelvényen, a hitelesítő adat nem működött.

![A jelvény hibás vagy hiányzó hitelesítő adattal](./kepek/kozosseg-funkciok-1-velemenyek-jelveny.webp)

*A jelvény hibás vagy hiányzó hitelesítő adattal* (https://minta-bolt.hu/tp-velemenyek-jelveny/)

A képen a jelvény érvényes hitelesítő adat nélkül látszik: a sarokban a 400-as szám, alatta az ajánlás sora. A valódi értékelési szám csak működő hitelesítő adatokkal jelenik meg.

### Hibaelhárítás

- **A jelvény szövegében „REQUEST_DENIED” áll.** A Google elutasította az API-kulcsot. Ellenőrizd, hogy a kulcs helyes-e, a Places API be van-e kapcsolva a projekten, a számlázás aktív-e, és a kulcs korlátozása engedi-e a szervered használatát.
- **A jelvényen „Error No : 200” áll.** A 200 egy Google-ig eljutott, de hibával visszatért kérés HTTP-állapotkódja, nem keresendő hibakód. Az olvasnivaló a mellette lévő szöveg.
- **Szám és „Something Wrong” látszik.** A szám a Facebook HTTP-állapotkódja, és azt jelzi, hogy a hitelesítő adat nem működött. Nézd meg a **Hozzáférési token** és az **Oldal/hely ID** mezőt.
- **A panel nagy része eltűnt.** Ez normális: a **Típus** **Jelvény**, ezért az **Értékelési opció**, az **Oszlopok kezelése**, a **Szűrési opció** és a **Továbbiak betöltése / késleltetett betöltés** szakasz el van rejtve.
- **A Frissítési idő átállítása nem hoz változást.** Két **Extra opciók** szakasz van, típusonként egy. Azt módosítsd, amelyik a **Jelvény** típusnál látszik.
- **Hiányzik az Előtag tartalma.** Csak a **Style-1** jelvénystílusnál van meg. Válts vissza arra, ha szükséged van rá.