# Hibaelhárítás

> Ha nem jelenik meg a hozzájárulási sáv, és hogyan ellenőrizheted, hogy a sütik tényleg blokkolva vannak a hozzájárulásig.

## 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](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/sutisav-sav-megjelenese/).

### 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](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/foldrajzi-celzas/), 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](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/hibaelharitas-jogosultsag-es-egyeb/).

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