# Shortcode-ok és Gutenberg-blokkok

> Miért shortcode-okkal épülnek fel a jogi dokumentumok, melyek a Complianz shortcode-jai, és hogyan jelenítheted meg a sütilistát.

## Miért shortcode-okat használ a Complianz?

A Complianz a jogi dokumentumokban (sütiszabályzat, adatvédelmi nyilatkozat) shortcode-okat használ két fő okból.

- **Egyszerű frissítés.** Az adatvédelmi jogszabályok, főleg a még tervezet állapotúak, változhatnak. Ha a bővítmény új szöveget vagy módosított cikket kap, a shortcode automatikusan frissíti a dokumentumot. Ugyanez igaz, ha új bővítményt, sütit vagy szkriptet adsz az oldalhoz, amit a szabályzatban említeni kell: a shortcode ezt is lekezeli.
- **Fordítás.** A bővítmény hat nyelven szállítja a szövegeket. A sütisáv a shortcode-on keresztül kapcsolódik a dokumentumhoz, így például a német sütisáv a német szabályzatra mutat. A frissítések és a fordítás együtt azt eredményezik, hogy a jogi dokumentumok a te beavatkozásod nélkül is naprakészek maradnak.

A shortcode-ok mellett Gutenberg-blokkok is vannak, mindegyiket a saját kényelmed szerint használhatod.

## A Complianz shortcode-jai

A bővítmény a következő shortcode-okat regisztrálja (a szögletes zárójelekkel együtt írd be őket):

| Shortcode | Mire jó |
|---|---|
| `[cmplz-document]` | Jogi dokumentum (például sütiszabályzat) megjelenítése |
| `[cmplz-cookies]` | A sütik listája, ahogy a generált sütiszabályzatokban is szerepel |
| `[cmplz-consent-area]` | Tartalom becsomagolása, amely csak hozzájárulás után jelenik meg |
| `[cmplz-manage-consent]` | A hozzájárulás kezelése |
| `[cmplz-revoke-link]` | Link a hozzájárulás visszavonásához |
| `[cmplz-accept-link]` | Link a hozzájárulás megadásához |
| `[cmplz-data-request]` | Adatkérési űrlap |
| `[cmplz-dnsmpi-request]` | Az adatok eladásának és megosztásának letiltására szolgáló kérés űrlapja |
| `[cmplz-tcf-vendors]`, `[cmplz-tcf-us-vendors]`, `[cmplz-tcf-interface]` | A TCF-hez tartozó szolgáltatólista és felület |

Ha a `cmplz-document` shortcode olyan régióra hivatkozik, amelyet nem kapcsoltál be, a helyén egy ilyen szöveg látszik: „Region EU not activated for cookie-policy.” Ez a Gutenberg-blokkok egyik oka is: a shortcode-ból nem látszik, hogyan fog kinézni az oldalon, a blokkból igen.

## A sütilista shortcode-ja

A `[cmplz-cookies]` shortcode kiírja a sütik listáját, ugyanabban a formában, ahogy a Complianz által generált sütiszabályzatokban szerepel. A lista szolgáltatásonként csoportosít: minden szolgáltatásnál látszik a hozzájárulási kategória, a használat leírása, az adatmegosztás ténye, valamint a sütik táblázata (név, lejárat, funkció).

- A lista frissítését és fordítását továbbra is a Cookiedatabase.org végzi.
- A megjelenést saját CSS-sel alakíthatod. Az osztályok és azonosítók a **Beállítások → Dokumentum CSS** területen találhatók, a sütitáblázat CSS-ét pedig külön is felhasználhatod.

## Gutenberg-blokkok

A Complianz saját Gutenberg-blokkokat tartalmaz, és szerepel a WordPress.org blokkokat használó bővítményeinek listáján. A régi szerkesztőben a funkciókat shortcode-okkal kellett bevinni, ami azzal a hátránnyal járt, hogy a szerkesztőnek ismernie kellett a shortcode-okat és azok attribútumait. A blokk szerkesztés közben a végleges megjelenést mutatja (WYSIWYG).

Két blokk van:

1. **Jogi dokumentum blokk**: a jogi dokumentumokat illeszti az oldalba.
2. **Hozzájárulási terület blokk**: iframe-ek, beágyazott szkriptek és más tartalom csomagolására szolgál. A részleteit a [Hozzájárulási terület](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/fejlesztoknek-hozzajarulasi-terulet/) fejezet írja le.

A blokkok a szerkesztőben a `/` beírásával, majd a név megkeresésével is beszúrhatók.

A jogi dokumentum blokkal a szabályzatokat az oldalra szúrhatod és szerkesztheted. A Gutenberg-integráció további ötletekkel bővíthető, ezekre a Complianz nyitott: javaslatot a bővítmény támogatásán át küldhetsz.

## Adatkérési űrlap shortcode-dal

Az adatkérési űrlap lehetővé teszi, hogy az érintettek a rólad kezelt adataikkal kapcsolatos kérést nyújtsanak be. Az űrlap automatikusan bekerül az adatvédelmi nyilatkozatba, de a `[cmplz-data-request]` shortcode-dal a webhely bármelyik másik oldalára is beillesztheted. A beküldött kérések az **Eszközök → Data Requests** oldalon (lásd az [Adatkérelmek](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/adatkerelmek-statisztika-adatkerelmek/) fejezetet) jelennek meg, ahol központilag kezelheted őket.

1. Kapcsold be az adatkérések funkciót a varázslóban: **Complianz → Wizard → General → Security & Consent**.
2. Szúrd be a `[cmplz-data-request]` shortcode-ot arra az oldalra, ahol az űrlapot szeretnéd.

A shortcode támogatja a `region` paramétert is, amellyel megadhatod, melyik régióhoz tartozzanak az űrlapon beküldött kérések. Például a `[cmplz-data-request region="eu"]` shortcode-dal beküldött kérések az Európai Unióhoz kerülnek.

Az űrlapok alapból a témád CSS-ét használják. A megjelenést saját CSS-sel módosíthatod, az adatkérési űrlapok CSS-példái a [Jogi dokumentumok és Általános szerződési feltételek stílusa](https://hub.hellowp.io/hu/plugins/complianz-gdpr-premium/stilus-css-dokumentumok/) fejezetben vannak.

## Elfogadási hivatkozás: tartalom hozzájárulás után

A `[cmplz-accept-link]` shortcode olyan hivatkozást ír ki, amellyel a látogató elfogadja a sütiket. A `text` paraméterrel megadod a hivatkozás szövegét:

```text
[cmplz-accept-link text="Az űrlap használatához fogadd el a sütiket."]
[cmplz-accept-link text="Ennek a tartalomnak a megjelenítéséhez fogadd el a sütiket."]
```

![Az oldalon a shortcode helyén egy aláhúzott hivatkozás látszik a megadott szöveggel](./kepek/fejlesztoknek-elfogadas-link.webp)

*Az oldalon a shortcode helyén egy aláhúzott hivatkozás látszik a megadott szöveggel* (https://minta-bolt.hu/kapcsolat-sutik/)

A képen a shortcode hivatkozásként jelenik meg a saját szövegével.

Hasznos mindenhol, ahol a tartalom csak teljes hozzájárulás után jeleníthető meg. Tipikus példa a reCAPTCHA-s űrlap: a reCAPTCHA a legtöbb célra blokkolva van, a mézesköcsög-védelem pedig sok űrlapnál nem elérhető vagy túl bonyolult. Ha mégis reCAPTCHA-t használnál, a V3-at ajánljuk, mert az szépen integrálódik a Complianzzal (a V2 is támogatott). Az űrlap így felel meg a GDPR-nak:

1. Az elküldés gomb feltételhez kötött: csak akkor látszik, ha a látogató rákattintott a shortcode hivatkozására.
2. A sütik elfogadása után a reCAPTCHA betöltődik, és védi az űrlapot a spamtől.
3. A látogató ekkor már látja az elküldés gombot.
4. Az űrlap kitölthető és elküldhető.