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

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 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éseken, é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 Facebookra.
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éseken, é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 Googlera.
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ényre, majd válassz a három Stílus kép közül.
3. Állítsd a Forrás mezőt Facebookra vagy Googlera.
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”.

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.

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á.