A Must-Have Cookie dokumentációja

Jelenlegi verzió: 1.0.3
Szövegdomain: mhcookie

A Must-Have Cookie egy adatvédelem-központú hozzájárulás-kezelési platform a WordPresshez. Külső követők nélkül, a hozzájárulás alapján kezeli a sütiket és a harmadik féltől származó erőforrásokat.

Az erőforrásokat közvetlenül a forrásnál blokkolja, amíg nem engedélyezik őket: a Set-Cookie fejléceket, szkripteket, iframe-eket, képeket, betűkészleteket és még az importált CSS-t is felügyeli. A kezelőfelület támogatja a banner- és párbeszédablak-módot, a többnyelvű tartalmakat, a földrajzi hely alapján történő engedélyezést és a Google Consent Mode v2-t.

Hogyan működik

Első lépések

Válaszd ki a megfelelő csomagot

A Must-Have Cookie egy korlátlan hozzájárulás-kezelő bővítmény. 2 csomag érhető el:

Single csomag

A Must-Have Cookie Single csomaggal 1 WordPress-weboldalon használható. Ez lehet a megfelelő választás, ha csak 1 weboldalad van, vagy ha szeretnéd kipróbálni, mire képes a Must-Have Cookie (az előfizetésedet később magasabb csomagra válthatod).

Unlimited csomag

Az Unlimited csomagot szabadúszóknak és ügynökségeknek hoztuk létre. Az Unlimited csomag korlátlan számú weboldalon használható.

Élő szerkesztő

A Live Editor segítségével azonnali vizuális visszajelzés mellett állíthatod be a sávot, a párbeszédablakot és a preferenciák widgetjét. A szövegeket közvetlenül szerkesztheted, módosíthatod a stílusokat, és válthatsz a nyelvek között, miközben pontosan úgy látod az előnézetet, ahogyan az a felhasználóknál megjelenik.

A Must-Have Cookie telepítése

1. Jelentkezz be a musthaveplugins.com weboldalon a Fiókom oldalra
2. A következő képernyőn az összes elérhető bővítményt láthatod. A Must-Have Cookie telepítőjét a Must-Have Cookie mezőben töltheted le
3. Jelentkezz be annak a WordPress weboldalnak az adminisztrációs felületére, amelyre telepíteni szeretnéd a Must-Have Cookie bővítményt
4. Lépj a Plugins > Add new menüpontra, és kattints a bővítmény feltöltésére
5. Válaszd ki a korábban letöltött ZIP-fájlt (must-have-cookie.zip), majd kattints a telepítésre

Általános beállítások

Itt állíthatod be a bővítmény alapvető működését.

Előnézeti mód

Ha ezt bekapcsolod, a bővítmény nem lesz hatással a weboldalad felhasználói felületére. Először tesztelheted a beállításaidat, majd az előnézeti mód kikapcsolásával aktiválhatod a bővítményt a weboldaladon.

Mód

Ez a beállítás határozza meg, hogy a bővítmény mely tartalmakat blokkolja.

Csak értesítés mód esetén a bővítmény nem blokkolja a sütiket vagy a beágyazott, harmadik féltől származó tartalmakat; csak egy értesítést jelenít meg.

Süti-hozzájárulási módban a bővítmény addig blokkolja a nem feltétlenül szükséges sütiket, amíg a felhasználó hozzá nem járul egy adott süti vagy annak kategóriája használatához. Ebben a módban a beágyazott, harmadik féltől származó tartalmak nincsenek blokkolva.

Teljes hozzájárulási módban a bővítmény mind a nem feltétlenül szükséges sütiket, mind a domaineket blokkolja, amíg a felhasználó kifejezetten hozzá nem járul a süti, a domain vagy azok kategóriájának használatához.

Megjelenítési mód

Két megjelenítési mód közül választhatsz: teljes képernyő és sáv.

Teljes képernyő: Ez a mód egy felugró párbeszédablakot tartalmazó átfedést jelenít meg, amelynél a felhasználónak a továbblépés előtt hozzá kell járulnia, vagy be kell zárnia a párbeszédablakot. Ha a felhasználó művelet nélkül zárja be a felugró ablakot, csak a feltétlenül szükséges erőforrások lesznek engedélyezve.

Sáv: A sáv a beállításodtól függően a képernyő tetején vagy alján rögzítve jelenik meg. A részletes, teljes képernyős párbeszédablak csak akkor nyílik meg, amikor a látogató a "Details." lehetőségre kattint.

Helyalapú hozzájárulás

Ez a beállítás a regionális előírásoknak való megfelelés érdekében csak az Európai Gazdasági Térségből (EGT) és az Egyesült Királyságból érkező látogatóknál alkalmaz előzetes hozzájárulást. A más régiókból érkező látogatókra az utólagos leiratkozás szabályai vonatkoznak.

A bővítmény intelligens észlelés segítségével akkor is meghatározza a látogató állampolgárságát, ha külföldön tartózkodik vagy VPN-t használ, így pontosan a megfelelő hozzájárulási logika (előzetes hozzájárulás vagy utólagos leiratkozás) lesz alkalmazva.

Naplózás

Ha engedélyezed, ez a funkció naplózza a felhasználók összes hozzájárulási műveletét, beleértve az általuk végzett módosításokat is. A napló rögzíti a dátumot, az IP-címet, az eszköz adatait és a részletes hozzájárulási adatokat, így átfogó nyilvántartást biztosít a megfelelőség és az átláthatóság érdekében.

Google Consent Mode

Ha engedélyezed, a bővítmény kezeli a Google Consent Mode 2-es verzióját, egyszerűbbé téve a hozzájárulási előírásoknak való megfelelést.

A Must-Have Cookie automatikusan elküldi a hozzájárulási állapotokat a Google-nak, zökkenőmentes integrációt biztosítva a Tag Managerrel. Így közvetlenül a Tag Managerben kezelheted a címkéid hozzájárulási követelményeit, miközben a bővítmény könnyedén elvégzi a többit.

Emellett a Must-Have Cookie fejlett erőforrás-kezelést is kínál. Ha egy felhasználó nem ad hozzájárulást, a bővítmény megakadályozza az erőforrás betöltését, függetlenül attól, hogyan kezdeményezték azt. Ez magában foglalja a Tag Manageren, szkripteken, iframe-eken, képcímkéken, betűkészleteken vagy importált CSS-fájlokon keresztül betöltött erőforrások tiltását, még akkor is, ha más CSS-fájlokban hivatkoznak rájuk.

Többnyelvű mód

Engedélyezd ezt a beállítást, ha több nyelvet szeretnél támogatni a weboldaladon, így zökkenőmentes felhasználói élményt biztosíthatsz a látogatóknak az általuk előnyben részesített nyelven.

A párbeszédablak nyelve

Ha a Többnyelvű mód engedélyezve van, kiválaszthatod, hogy a sütikhez való hozzájárulás párbeszédablaka a weboldal aktuális nyelvén jelenjen meg, vagy a személyre szabottabb élmény érdekében igazodjon a látogató böngészőjének nyelvéhez.

Engedélyezett nyelvek

Ebben a szakaszban add meg a támogatni kívánt nyelveket. Ha a látogató nyelve nem szerepel a listában, a weboldal az alapértelmezett tartalék nyelvet használja. Minden szöveges tartalom teljes mértékben testreszabható minden engedélyezett nyelvhez.

A hozzájárulás lejárata

Ez a beállítás szabályozza, hogy mennyi ideig marad érvényben a részleges hozzájárulás: ha a látogató nem fogad el mindent, a kiválasztott időszak után ismét megjelenik a párbeszédablak, és arra kéri, hogy tekintse át a választásait. A választható értékek: 1 nap, 1 hét, 1 hónap, 6 hónap és 12 hónap.

A teljes elfogadás mindig 12 hónapig érvényes: az uniós adatvédelmi előírások megkövetelik, hogy a hozzájárulást legalább évente egyszer újból megerősítsék, ezért egyetlen döntést sem tárolunk határozatlan ideig.

Migrációs megjegyzés: a korábbi verziók a teljes elfogadást annak visszavonásáig tárolták, és egy "Never" lejárati lehetőséget is kínáltak. Az 1.0.1-es verziótól kezdve ez már nem érhető el — a "Never" értékkel beállított weboldalak frissítéskor automatikusan 12 hónapra váltanak, a látogatók böngészőjében már meglévő hozzájárulások pedig a megadásuktól számított 12 hónap után lejárnak. Azok a látogatók, akiknek a hozzájárulása ennél már régebbi, a következő látogatásukkor ismét látni fogják a párbeszédablakot.

Egyéni CSS

Bár beállíthatod a banner, a párbeszédablak vagy a widget színeit, itt saját CSS-szabályokat is írhatsz, hogy a legapróbb részletekig testreszabd a hozzájárulási párbeszédablakot és a widgetet.

Banner

Ha a banner megjelenítési módot választod, itt testreszabhatod a banner szövegét, színeit és pozícióját. Ha a Többnyelvű mód engedélyezve van, megjelenik egy nyelvválasztó, amellyel minden nyelvhez külön módosíthatod a szöveget.

A szöveges tartalmakat, beleértve az üzenetet és a gombokat is, közvetlenül az élő szerkesztőben módosíthatod. Egyszerűen kattints a módosítani kívánt tartalomra.

Színséma

Válaszd ki a párbeszédablak fő színeit, hogy azok illeszkedjenek a weboldalad megjelenéséhez. A módosításokat azonnal láthatod az élő előnézetben. A részletesebb testreszabáshoz használd az Általános beállítások Egyéni CSS lehetőségét.

A banner pozíciója

Döntsd el, hol jelenjen meg a banner a weboldaladon az optimális láthatóság és felhasználói élmény érdekében. Elhelyezheted a képernyő tetején vagy alján, attól függően, melyik illik jobban a megjelenéshez és az elrendezéshez.

Párbeszédablak

Ha a Többnyelvű mód engedélyezve van, megjelenik egy nyelvválasztó, amellyel minden nyelvhez külön módosíthatod a szöveget.

A szöveges tartalmakat, beleértve a leírást, a címkéket és a gombokat is, közvetlenül az élő szerkesztőben módosíthatod. Egyszerűen kattints a módosítani kívánt tartalomra. A párbeszédablak élő szerkesztőjében a szöveget is formázhatod, valamint hivatkozásokat adhatsz hozzá.

Színséma

Válaszd ki a párbeszédablak fő színeit, hogy azok illeszkedjenek a weboldalad megjelenéséhez. A módosításokat azonnal láthatod az élő előnézetben. A részletesebb testreszabáshoz használd az Általános beállítások Egyéni CSS lehetőségét.

Widget

Engedélyezd a beállítási widgetet a weboldaladon, hogy a felhasználók megnyithassák a hozzájárulási felugró ablakot, és áttekinthessék vagy módosíthassák hozzájárulási beállításaikat.

Widget típusa

Két widgettípus közül választhatsz: szöveges widget vagy ikonwidget. Ha a szöveges widgetet választod, az élő szerkesztővel testreszabhatod a szöveget. Ha a Többnyelvű mód engedélyezve van, minden nyelv szövegét külön is szerkesztheted.

Ikon

Ha az ikonwidgetet választod, kiválaszthatsz egy képet vagy ikont, amely a widgetet jelképezi. Szabd testre úgy, hogy illeszkedjen a weboldalad megjelenéséhez és működéséhez.

Színséma

Válaszd ki a widget színsémáját, hogy az illeszkedjen a weboldalad megjelenéséhez. A módosításokat azonnal megtekintheted az élő szerkesztőben. A részletesebb testreszabáshoz használd az Általános beállítások Egyéni CSS lehetőségét.

A widget pozíciója

Válaszd ki, hol jelenjen meg a widget a weboldalon. A képernyő következő területeinek egyikén helyezheted el: bal alsó, jobb alsó, középen alul, bal oldalon középen vagy jobb oldalon középen.

Sütik

A Sütik lapon kezelheted a weboldaladon használt sütiket. Hozzáadhatsz vagy eltávolíthatsz sütiket, szerkesztheted a sütik nevét, és frissítheted a céljukat.

• Célok szerkesztése: Egy süti céljának módosításához kattints az aktuális célra, majd válassz egy újat a legördülő listából.
• Sütinevek szerkesztése: A sütik nevei szerkeszthetők, és a mintákban a * karaktert helyettesítő karakterként használhatod.
• Sütik eltávolítása: Bármelyik sütit eltávolíthatod a mellette található Remove hivatkozásra kattintva.

Ezen a lapon teljes rugalmassággal kezelheted weboldalad sütijeit, biztosítva a megfelelőséget és a megfelelő kategorizálást.

Sütik céljai

A GDPR-nak való megfelelés érdekében minden sütit a célja szerint kell kategorizálni. Az alábbi kategóriák állnak rendelkezésre:

• Alapvető: Ezeket a sütiket felhasználói hozzájárulás nélkül használjuk. Csak a weboldal alapvető működéséhez nélkülözhetetlen sütiket szabad alapvetőként besorolni. Nem tárolhatnak személyes adatokat, és nem használhatók profilalkotásra. Ilyenek például a bejelentkezési állapot fenntartásához szükséges munkamenet-sütik.
• Szükséges: Ezek a sütik szükségesek a weboldal használatához, de a GDPR értelmében felhasználói hozzájárulást igényelnek. Ilyenek például a captcha-megoldásokhoz vagy a tranzakciók végrehajtásához nélkülözhetetlen fizetési átjárókhoz kapcsolódó sütik.
• Analitika: Ezek a sütik információkat gyűjtenek arról, hogy a felhasználók hogyan használják a weboldalt, például mely oldalakat keresték fel, mennyi időt töltöttek az oldalakon, és mekkora a visszafordulási arány. Az összegyűjtött adatokat a weboldal működésének és felhasználói élményének javítására használjuk. Az analitikai sütik nem gyűjthetnek személyazonosításra alkalmas adatokat, kivéve, ha a felhasználó ehhez kifejezetten hozzájárul.
• Marketing: Marketingcélokra használt sütik, például személyre szabott hirdetések megjelenítésére vagy a felhasználók weboldalak közötti követésére célzott hirdetések érdekében. Ezekhez a sütikhez a GDPR értelmében kifejezett felhasználói hozzájárulás szükséges.
• Média: Ezeket a sütiket beágyazott médiatartalmak, például videók vagy hanglejátszók megjelenítésére használjuk. Biztosítják a harmadik féltől származó médiatartalmak megfelelő működését és lejátszását, és gyakran felhasználói hozzájárulást igényelnek.
• Egyéb szolgáltatások: Minden olyan süti, amely nem illik a fenti kategóriákba. Ide tartozhatnak olyan külső szolgáltatások sütijei, amelyek az analitikától, a médiától vagy a marketingtől független további funkciókat biztosítanak.

A megfelelő kategorizálás átláthatóságot és GDPR-megfelelőséget biztosít, így a felhasználók megalapozott döntéseket hozhatnak a sütibeállításaikról.

Domainek

A Domainek lapon kezelheted a weboldaladhoz kapcsolódó, harmadik felekhez tartozó domaineket. Hozzáadhatsz vagy eltávolíthatsz domaineket, szerkesztheted a nevüket, és meghatározott célokhoz rendelheted őket.

• Célok szerkesztése: Rendelj célt az egyes domainekhez az aktuális céljukra kattintva, majd válassz egy újat a legördülő listából.
• Domainnevek szerkesztése: A domainneveket a saját beállításaidhoz igazíthatod. Aldomainekhez vagy mintákhoz használd a * helyettesítő karaktert.
• Beágyazott leírások: Adj közérthető leírást minden domainhez vagy erőforráshoz. Ezek a megjegyzések a párbeszédablakban és a shortcode-okban jelennek meg, így a végfelhasználók a hozzájárulás megadása előtt megtudhatják, miért van szükség az adott gazdagépre vagy erőforrásra.
• Domainek eltávolítása: Bármely domaint eltávolíthatod a mellette található Eltávolítás hivatkozásra kattintva.

Ezen a lapon szabályozhatod a harmadik felekhez tartozó domainek működését, biztosítva a GDPR-megfelelőséget és a megfelelő kategorizálást.

Domainek céljai

A GDPR-nak való megfelelés érdekében minden domaint a célja szerint kell kategorizálni. Az alábbi kategóriák állnak rendelkezésre:

• Alapvető: A weboldal alapvető működéséhez nélkülözhetetlen domainek, például tartalomelosztó hálózatok (CDN-ek), illetve kritikus erőforrásokat (például szkripteket vagy stíluslapokat) kiszolgáló domainek. Ezek a domainek szükségesek a weboldal megfelelő működéséhez.
• Szükséges: Bizonyos funkciókhoz, például captcha-megoldásokhoz vagy fizetési átjárókhoz szükséges domainek, amelyek nélkülözhetetlenek az alapvető szolgáltatások biztosításához. Ezek a GDPR értelmében felhasználói hozzájárulást igényelnek.
• Analitika: Analitikai célokra használt domainek, például a weboldal forgalmával, a felhasználói viselkedéssel és az interakciókkal kapcsolatos adatok gyűjtésére. Ezek a domainek elősegítik a teljesítmény javítását és a felhasználói élmény optimalizálását, aktiválásukhoz azonban felhasználói hozzájárulás szükséges.
• Marketing: Marketingcélokra használt domainek, például célzott hirdetések megjelenítésére vagy a felhasználói tevékenység hirdetési stratégiák céljából történő követésére. Ezekhez a GDPR értelmében kifejezett felhasználói hozzájárulás szükséges.
• Média: Médiatartalmak, például videók, képek vagy hanganyagok beágyazására vagy megjelenítésére használt domainek. Ezek a domainek biztosítják a harmadik féltől származó médiatartalmak megfelelő működését, és felhasználói hozzájárulást igényelhetnek.
• Egyéb szolgáltatások: Minden olyan domain, amely nem illik a fenti kategóriákba. Ide tartozhatnak olyan külső szolgáltatások, amelyek az analitikától, a médiától vagy a marketingtől független további funkciókat biztosítanak.

A megfelelő kategorizálás átláthatóságot és GDPR-megfelelőséget biztosít, így a felhasználók megalapozott döntéseket hozhatnak a harmadik felekhez tartozó domainekkel való interakcióikról.

Naplók

A Naplók lap részletes hozzájárulási adatokat jelenít meg, többek között:

• Eszközazonosító: A felhasználó eszközének egyedi azonosítója, amely megjeleníti az idő során hozzá társított összes hozzájárulást.
• Hozzájárulás: Részletes nyilvántartás arról, hogy a felhasználó mihez járult hozzá, beleértve az egyes sütikategóriákat vagy szolgáltatásokat.
• IP-cím: A felhasználó IP-címe a hozzájárulási művelet időpontjában.
• Eszköz: Információ a felhasználó eszközének típusáról.
• Időbélyeg: A hozzájárulási művelet pontos dátuma és időpontja.

Rendszer

A Rendszer lap alapvető eszközöket biztosít a licenced kezeléséhez és a karbantartási műveletek elvégzéséhez.

• Licenc: Megjeleníti, hogy a licenced aktív-e. Ha a licenc már csatlakoztatva van, itt leválaszthatod, hogy egy másikra cseréld.
• Vizsgálat: A Must-Have Cookie automatizált, valós idejű vizsgálati funkciója észleli a weboldaladon megjelenő új sütiket és domaineket. Erről a lapról manuális weboldal-vizsgálatot is indíthatsz.

Párbeszédpanel-aktiválók

A hozzájárulási felület hash linkekkel, CSS-aktiválókkal, programozott eseményekkel, egyéni DOM-eseményekkel és egy postMessage API-val vezérelhető. Ezekkel egyéni JS írása nélkül integrálhatsz gombokat és linkeket.

document.dispatchEvent(new Event('mhcookie/do/show_dialog'));
document.dispatchEvent(new Event('mhcookie/do/hide_dialog'));
document.dispatchEvent(new Event('mhcookie/do/store_consent'));

parent.postMessage({type:'mhcookie/allowHost', host:'www.youtube.com'}, '*');
parent.postMessage({type:'mhcookie/allowMedia'}, '*');
parent.postMessage({type:'mhcookie/allowAll'}, '*');
parent.postMessage({type:'mhcookie/forceReload'}, '*');

Shortcode-ok

A shortcode-okkal a bővítmény funkcióit bárhol integrálhatod a weboldaladon.

Hozzájárulási előzmények

A [mhcookie_consent_history] shortcode használatával megjelenítheted a felhasználó hozzájárulási előzményeit az oldaladon. Ha a felhasználó még nem adott hozzájárulást, ez a szakasz üres marad.

Használat:

[mhcookie_consent_history]

Sütik

A [mhcookie_cookies] shortcode használatával felsorolhatod a weboldaladon használt összes sütit cél szerint csoportosítva, az egyes célok leírásával együtt.

Használat:

[mhcookie_cookies]

Részletek

A [mhcookie_details] shortcode használatával megjeleníthetsz egy linket vagy gombot, amely megnyitja a hozzájárulási párbeszédpanelt.

Attribútumok:

• style lehetséges értékei: btn vagy empty. Ha btn értékre állítod, a Must-Have Cookie elsődleges gombstílusát használja, ellenkező esetben formázatlan <a> címke lesz.
• text a link vagy gomb tetszőleges szövege. Ha nincs beállítva, a Details gomb alapértelmezett szövegét használja.

[mhcookie_details style="btn" text="Show details"]

Domainek

A [mhcookie_domains] shortcode használatával felsorolhatod a weboldaladon használt összes domaint cél szerint csoportosítva, az egyes célok leírásával együtt.

Használat:

[mhcookie_domains]

Entitások

A [mhcookie_entities] shortcode segítségével felsorolhatod a weboldaladon használt összes sütit & domaint céljuk szerint csoportosítva, az egyes célok leírásával együtt.

Használat:

[mhcookie_entities]

Csoport leírása

A [mhcookie_group_description] shortcode segítségével megjelenítheted egy célcsoport leírását.

Attribútumok:

• group lehetséges értékei: essential, functional, analytics, marketing, media, other.

[mhcookie_group_description group="analytics"]

Hozzájárulás

A [mhcookie_optin] shortcode segítségével megjeleníthetsz egy hivatkozást vagy gombot, amelyre kattintva a felhasználó elfogadja az általad beállított kategóriákat.

Attribútumok:

• type lehetséges értékei: accept-all, accept-required
• style lehetséges értékei: btn vagy empty. Ha btn értékre állítod, a Must-Have Cookie elsődleges gombstílusát használja, ellenkező esetben formázatlan <a> címke lesz.
• text a hivatkozás vagy gomb tetszőleges szövege. Ha nincs beállítva, az Accept All / Accept Required gomb alapértelmezett szövegét használja.

[mhcookie_optin type="accept-all" style="btn" text="Accept all cookies & services"]

Hozzájárulás visszavonása

A [mhcookie_optout] shortcode segítségével megjeleníthetsz egy hivatkozást vagy gombot, amelyre kattintva a felhasználó visszavonja az összes korábbi hozzájárulását.

Attribútumok:

• style: Lehetséges értékei: btn vagy empty. Ha btn értékre állítod, a Must-Have Cookie elsődleges gombstílusát használja. Ellenkező esetben formázatlan <a> címkeként jelenik meg.
• text: A hivatkozáson vagy gombon megjelenítendő tetszőleges szöveg. Ha nincs beállítva, az alapértelmezett "Withdraw Consent" szöveg jelenik meg.

[mhcookie_optout style="btn" text="Revoke consent"]

Helyőrző

Ha a weboldaladon van egy beágyazott szkript, amely iframe-et vagy valamilyen tartalmat hoz létre, a blokkolása alatt semmi sem jelenik meg. Ilyen esetekben hozzáadhatsz egy data-mhcookie-placeholder attribútumot a <script> címkéhez, vagy beillesztheted a [mhcookie_placeholder] shortcode-ot arra a területre, ahol a szkript létrehozza a tartalmat. Attribútumok:

• src: A szkript URL-címe

[mhcookie_placeholder src="https://example.com/embed.js"]

Elérhető szűrők

add_filter('mhcookie_option_consent-expiry', function($value){
    // Value is in seconds — keep partial consents for at most 30 days
    return min((int)$value, 30 * DAY_IN_SECONDS);
});

add_filter('mhcookie/max_consent_expiry', function($seconds){
    // Re-ask every visitor at least every 6 months
    return 6 * MONTH_IN_SECONDS;
});

Elérhető műveletek

Kompatibilitási funkciók

JavaScript API

if (!window.mhCookieIsBlocked('https://www.youtube.com/embed/xyz')) {
  // safe to load
}

REST API

Változásnapló