Hibaelhárítás

A sáv nem jelenik meg

Két, kívülről egyformának látszó oka lehet: vagy még nem kell sáv, vagy van beállított sáv, de valami megakadályozza a megjelenését.

1. Kell-e egyáltalán sáv?

Ha a Complianz csak feltétlenül szükséges sütiket talál, nem jelenik meg sáv, és ez helyes működés. A kategóriák megjelenésének feltételei:

• Preferences akkor jelenik meg, ha teljesül legalább egy: a Wizard → Consent → Services részen be van kapcsolva a „Consent per Service”, a Wizard → Consent → Statistics résznél be van kapcsolva a Google Consent Mode, vagy telepítve és aktív a WP Consent API.
• Statistics akkor, ha a Wizard → Consent → Statistics résznél valamilyen statisztikai beállítás meg van adva.
• Marketing akkor, ha a Wizard → Consent → Services résznél legalább egy szolgáltatás ki van választva, vagy a TCF keretrendszer be van kapcsolva.

Ha ezek egyike sem teljesül, a webhelyed nem állít be hozzájárulást igénylő sütiket. Ha mégis szeretnél sávot, lásd a sáv kényszerítését.

2. A Dashboard ellenőrzése

A sáv csak a varázsló elvégzése után indul el. Ellenőrizd:

• a varázslót legalább egyszer befejezted;
• a Consent Banner → General oldalon a Disable consent banner ki van kapcsolva;
• ha nincs statisztikai eszköz vagy anonim a konfigurációja, a „Do you want to ask consent for statistics?” kérdésre válaszolhatsz igennel;
• ha nem jelöltél harmadik fél szolgáltatást vagy közösségi médiát, a „Do you use plugins that might set marketing cookies?” kérdésre válaszolhatsz igennel.

Ha minden rendben van, a Dashboard oldalon a Your site needs a cookie banner, which has been enabled. üzenet látszik.

3. Gyorsítótár

Ürítsd a gyorsítótár-bővítmény és a CDN gyorsítótárát, majd nézd meg az oldalt privát (inkognitó) ablakban. Mac-en a Cmd + Shift + N, Windowson a Ctrl + Shift + N nyitja.

4. A sávot valami eltakarja

• Magas z-index: a sáv alapértéke 9999. Teszteléshez emeld meg a Consent Banner → Custom CSS oldalon (Use Custom CSS): .cmplz-cookiebanner{z-index:999999;}. Ha így megjelenik, ez volt az ok.
• Elrejtő CSS: ellenőrizd, hogy a téma, egy bővítmény vagy az egyéni CSS nem állít-e display:none vagy visibility:hidden értéket a .cmplz-cookiebanner elemre.
• Szülőelem vágja le: a sáv rögzített (fixed) pozíciójú, ezért egy overflow:hidden vagy transform tulajdonságú szülő levághatja vagy kitolhatja.
• Optimalizáló bővítmények: a CSS-összevonás, a minifikálás és a „nem használt CSS eltávolítása” funkció kiveheti a sáv stíluslapját. Zárd ki az optimalizálásból a Complianz CSS és JavaScript fájljait, ürítsd a gyorsítótárat, és próbáld újra.
• Gyors szűkítés: kapcsolj át ideiglenesen alapértelmezett WordPress-témára, kapcsold ki az egyéni CSS-t és az optimalizáló bővítményt, majd töltsd újra privát ablakban. Ha megjelenik, add vissza egyenként a kikapcsoltakat.

5. Do Not Track vagy Global Privacy Control

Ha a Wizard → General → Security & Consent résznél be van kapcsolva a Respect Do Not Track and Global Privacy Control? beállítás, és a böngésző valamelyik jelzést küldi, a Complianz minden preferenciát elutasítottnak vesz, és nem jelenít meg sávot. Egyes böngészők, például a Firefox, alapból küldik a jelzést. A böngésző konzoljában ilyenkor a „Global Privacy Control or Do Not Track detected: no banner” üzenet látszik. Kapcsold ki a beállítást a Complianzban, vagy a jelzést a böngészőben. Ez a látogatókra is vonatkozik: aki ilyen jelzést küld, nem látja a sávot.

6. Régió (prémium)

Ha a Settings → General oldalon a GEO IP be van kapcsolva, és a webhelyet például csak az USA-ra (CCPA) állítottad be, Európából nem látod a sávot. Teszteléshez használj VPN-t, a régióparamétereket, vagy kapcsold ki ideiglenesen a GEO IP-t és a többi régiót (Wizard → General → Visitors). A böngésző konzoljában a Complianz három állapot egyikét jelzi: opt-in (EU, UK, esetenként Kanada), opt-out (USA, esetenként Kanada), vagy „egyéb régió, nincs süti-figyelmeztetés” (például Mexikó), utóbbinál nincs sáv.

7. Az uploads mappa írásvédett

Ha a böngésző konzolja ilyen hibákat mutat, a sáv stíluslapja nem jött létre:

Failed to load resource: the server responded with a status of 404 (Not Found)
Refused to apply style from 'domain.com/wp-content/uploads/complianz/css/banner-1-optin.css' because its MIME type ('text/html') is not a supported stylesheet MIME type

Általában az uploads mappa írásvédett. Állítsd be a mappa jogosultságait, lásd a mappajogosultságról szóló fejezetet.

8. Hibák a konzolban

Jobb gombbal Inspect, majd Console. Gyakori hibák:

• REST API hibák: a Complianz a REST API-t használja, ha te vagy egy biztonsági bővítmény letiltotta, a sáv nem jelenik meg.
• reCaptcha / greCaptcha hibák: a reCaptcha-integráció kikapcsolása rendszerint megoldja.
• 404 hiba: telepítési hibára utalhat, érdemes újratelepíteni a Complianzot.
• Semmi nem történik: ha a cmplz_event_functional esemény nem jelenik meg, a Complianz nem aktív, vagy a JavaScript blokkolva van.

9. GeoIP és IP-maszkolás

Helyi fejlesztői környezetben vagy szigorú adatvédelmi beállítású szerveren az IP-címek maszkolva vannak, minden látogató a 127.0.0.1 címen látszik. A Complianz nem tudja meghatározni a régiót, ezért nem kapcsol be sávot (a konzolban naplóüzenet jelzi). Helyi környezetben kapcsolj be alapértelmezett sávot az „egyéb régiók” számára a varázsló első szakaszában. Éles webhelyen a valódi IP-címek átadására van szükség.

A sütik a hozzájárulás előtt betöltenek

Így ellenőrizheted, milyen sütiket állít be a webhelyed:

1. Nyisd meg a webhelyet privát ablakban, töröld előtte a sütiket, és ne légy bejelentkezve adminisztrátorként (a bejelentkezéskor a WordPress funkcionális sütiket állít be, amelyek mindig engedélyezettek, és torzítják az eredményt).
2. Nyisd meg a fejlesztői eszközöket (Inspect), a Application (Chrome, Edge) vagy Storage (Firefox) fület, majd a Cookies listát.
3. Még ne kattints az Accept gombra. Ha marketing-, statisztikai vagy harmadik féltől származó sütit (Google, Facebook, YouTube) látsz, valami túl korán tölt be.
4. Kattints az Accept all gombra, frissítsd az oldalt, és hasonlítsd össze a listát: ekkor jelenhetnek meg a további sütik.
5. A Network fülön figyeld a kéréseket: a google-analytics.com, googletagmanager.com, facebook.com, youtube.com, doubleclick.net kérések a hozzájárulás előtt túl korai betöltést jeleznek.

A Complianz beépített süti-vizsgálata (Wizard → Consent → Website Scan) a sütiket, a harmadik féltől származó szolgáltatásokat és a sütit állító szkripteket sorolja fel. A vizsgálat azt mutatja, mi létezik, de nem bizonyítja, hogy a hozzájárulás előtt blokkolva van. Kézi ellenőrzés mindig kell.

Gyakori okok, ha a sütik túl korán betöltenek:

• a témába beégetett szkriptek;
• a header.php-ba illesztett szkriptek;
• olyan bővítmények, amelyek közvetlenül töltenek be szkriptet;
• gyorsítótár- vagy optimalizáló bővítmények;
• szerveroldali követés.

Szkriptet mindig a Complianz integrációin vagy a támogatott bővítményeken át add hozzá. Teszteld másik eszközről és hálózatról is, mert a gyorsítótár vagy a bejelentkezett munkamenet torzíthat.

Szkriptütközések, hibakeresés

Ha egy integráció ütközést okoz, a Complianz → Tools → Debugging oldalon bekapcsolhatod a biztonságos módot (Enable safe mode), amely ideiglenesen kikapcsolja az integrációkat. Az esetleges szkriptütközések megtekintéséhez állítsd be a SCRIPT_DEBUG konstanst a wp-config.php fájlban.