# Hozzájárulási terület

> Tartalom becsomagolása a hozzájárulási terület shortcode-jával vagy blokkjával: attribútumok, gyorsítótár, szöveg és stílus.

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):

```text
[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”.

![Egy hozzájárulási terület helyőrzője vendégként nézve](./kepek/fejlesztoknek-hozzajarulasi-terulet-helyorzo.webp)

*Egy hozzájárulási terület helyőrzője vendégként nézve* (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](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/integraciok-szkriptkozpont/) és [Integráció fejlesztése](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/fejlesztoknek-integracio-fejlesztes/).