Hozzájárulási terület

A Complianz sok népszerű szolgáltatáshoz és bővítményhez kész integrációt ad, amely automatikusan kezeli a hozzájárulást és szükség esetén helyőrzőt tesz a tartalom helyére. Előfordul, hogy ez nem elég, és shortcode-dal kell becsomagolnod a tartalmat. Erre való a hozzájárulási terület (cmplz-consent-area).

Amit érdemes tudnod

• Gyorsítótár mellett add hozzá a cache_redirect=true attribútumot.
• Ha egy oldalon több hozzájárulási terület van, mindegyiknek egyedi azonosítót adj, például id="blokk1", id="blokk2".
• A shortcode alapértelmezett helyőrző szöveget ad. A helyőrző kinézetét CSS-sel alakíthatod.
• A csomagolást kézzel kell beírnod a HTML-be.
• A tartalom megjelenítéséhez az oldalnak újra kell töltődnie vagy át kell irányítania.

A shortcode

A shortcode nyitó és záró tagből áll, a kettő közé kerül a hozzájárulásra váró tartalom (például egy iframe vagy szkript):

[cmplz-consent-area category="marketing" id="blokk1"]
  ... ide jön a tartalom ...
[/cmplz-consent-area]

Ha a záró tag hiányzik, vagy a tartalom üres, a shortcode nem ad vissza semmit.

Attribútum	Mit csinál	Alapérték
id	A terület egyedi azonosítója (több területnél kötelezően eltérő)	default
category	Melyik kategória elfogadásához kötött a tartalom	nincs megadva
service	Melyik szolgáltatás elfogadásához kötött	general
text	A helyőrző szövege	„Click to accept the cookies for this service”, magyar felületen a lefordított változat
cache_redirect	Gyorsítótárhoz: a hozzájárulás után a ?cmplz_consent=1 paraméteres címre irányít	false
clientside	A tartalmat a böngésző jeleníti meg, mint a Gutenberg-blokkban	false
scroll_into_view	A hozzájárulás után a területhez görget	true

Gyorsítótár mellett

Alapesetben az oldal újratöltődik a hozzájáruláskor, hogy a PHP lefusson. Gyorsítótárnál add meg a cache_redirect=true attribútumot: ekkor a bővítmény egy ?cmplz_consent=1 végű címre irányít, így a gyorsítótár a hozzájárulás utáni oldalt külön tárolhatja. A teljesítmény miatt érdemes először a clientside=true attribútumot kipróbálni; ha nem működik, vedd el.

Kategória kiválasztása

A category attribútummal megadhatod, melyik kategória elfogadása kell a tartalomhoz, például category="marketing".

A helyőrző szövegének cseréje

A text attribútummal átírhatod a helyőrző szövegét. Gyakori példa: „Fogadd el a marketing sütiket a tartalom megtekintéséhez”.

https://minta-bolt.hu/hozzajarulasi-terulet-proba/

A képen az oldal egy hozzájárulás nélküli látogató szemével látszik: a nyitó bekezdés megjelenik, a becsomagolt iframe helyén pedig a megadott szövegű helyőrző áll.

Stílus és saját szkript

A helyőrző kinézetét a bővítmény CSS-ével alakíthatod (például a süti ikonját cserélheted le). A hozzájárulás utáni újratöltést egy kis JavaScript végzi: a cmplz_enable_category eseményre figyel, és ha a general szolgáltatás vagy a no-category kategória hozzájárulása megvan, a címhez hozzáfűzi a cmplz_consent=1#cmplz_consent_area_anchor részt, majd újratölt. Ha a cím már tartalmazza ezt a paramétert, de a terület nem látszik, a szkript eltávolítja a paramétert és újratölt.

Gutenberg: hozzájárulási terület blokk

A hozzájárulási terület blokk a második Complianz-blokk a jogi dokumentum blokk után. Ide iframe-et, beágyazott szkriptet és hasonló tartalmat tehetsz.

1. Szerkesztés közben írj be egy / jelet, majd keresd meg a Consent Area Block blokkot (vagy keress rá a blokkbeszúrónál).
2. Szúrd be, és írd be a tartalmat. Alapból egy egyéni HTML blokk van benne.

A blokk a szerkesztőben a végleges megjelenést mutatja, a tartalmát a böngésző jeleníti meg a hozzájárulás után.

Ha integrációt szeretnél egy szolgáltatáshoz

Ha egy szolgáltatáshoz vagy bővítményhez integrációra van szükséged, a kézi csomagolás helyett érdemesebb a szkriptközpontban megadni a blokkolandó URL-t. Lásd: Integrációk és a szkriptközpont és Integráció fejlesztése.