Sema Cookie Consent for Joomla

Joomla rozšíření (package = plugin + komponenta) pro GDPR cookie consent banner s admin dashboardem a podporou Google Consent Mode v2.

2. Instalace

Získání instalačního balíčku

Stáhněte ZIP soubor pkg_semacookieconsent-X.Y.Z.zip ze SemaHub (Semakin.cz).

Postup instalace

1. Přihlaste se do administrace Joomla.
2. Přejděte do System > Install > Extensions.
3. Nahrajte ZIP soubor pkg_semacookieconsent-X.Y.Z.zip.
4. Joomla nainstaluje oba díly najednou:
   • Plugin: plg_system_semacookieconsent (System – Sema Cookie Consent)
   • Komponenta: com_semacookieconsent (Sema Cookie Consent – admin dashboard a log)
5. Plugin se automaticky povolí po instalaci (díky pkg_script.php).

Upgrade: Stejný postup jako instalace. Joomla použije method="upgrade" a zachová data v tabulce #__semacookieconsent_consents.

Migrace: Pokud na webu existuje stará tabulka #__cookie_consents (z předchozí implementace), instalační skript automaticky přenese data do nové tabulky.

4. Základní nastavení

Otevřete nastavení pluginu: System > Plugins > klik na název pluginu.

Nastavení je rozděleno do 6 karet (tabu):

Karta Obecné

6. Barvy

Karta Barvy umožňuje přizpůsobit vzhled banneru barvám webu. Barvy se aplikují přes CSS custom properties.

Pokud používáte vlastní CSS šablonu, můžete barvy přepsat přímo v CSS pomocí proměnných --scc-bg, --scc-text atd.

8. Google Consent Mode v2

Karta Google Consent Mode umožňuje integraci s Google Consent Mode v2 (GCM).

Jak GCM funguje

1. Skript consent-mode.js se vloží synchronně do <head> (bez defer/async).
2. Musí se načíst PŘED jakýmkoli gtag.js nebo Google Tag Managerem.
3. Při načítání stránky přečte existující souhlas z localStorage a nastaví gtag('consent', 'default', ...).
4. Když návštěvník změní souhlas v banneru, JavaScript zavolá gtag('consent', 'update', ...).

GCM consent typy

Důležité: Pokud na webu nepoužíváte Google Analytics, Google Ads ani Google Tag Manager, nemusíte GCM zapínat. GCM je relevantní pouze pro weby s Google tracking službami.

10. Administrace – Dashboard

Po instalaci se v administraci objeví nová položka v bočním menu: Components > Sema Cookie Consent.

Dashboard

Zobrazení Dashboard ukazuje přehled souhlasu za posledních 30 dní:

12. CSV export

1. V zobrazení Log souhlasu klikněte na tlačítko „Export CSV“ v panelu nástrojů.
2. Stáhne se CSV soubor se všemi záznamy (respektuje aktuální filtry akce a data).
3. Kódování: UTF-8 s BOM (pro správné zobrazení v Excelu).
4. Oddělovač: středník (;).
5. Název souboru: cookie-consents-RRRR-MM-DD.csv.

CSV obsahuje sloupce: ID, Consent ID, IP Address, User Agent, User ID, Necessary, Analytics, Marketing, Action, Created At.

14. Vícejazyčný banner

Plugin automaticky zobrazuje banner ve správném jazyce podle nastavení Joomla webu. Texty banneru se načítají z jazykových souborů, takže na vícejazyčném webu každý jazyk zobrazí banner ve svém jazyce.

Podporované jazyky

Jak to funguje

• Všechna textová pole v kartě Texty jsou ve výchozím stavu prázdná.
• Pokud je pole prázdné, plugin automaticky použije překlad z jazykového souboru pro aktuální jazyk webu.
• Pokud vyplníte vlastní text, zobrazí se na všech jazykových verzích webu (přepíše automatický překlad).
• Placeholder v poli ukazuje výchozí text pro referenci.

Vícejazyčná URL cookie policy

URL cookie policy (policy_url) také podporuje hodnoty pro každý jazyk zvlášť. Pole URL zásad cookies v kartě Obecné funguje stejně jako textová pole:

• Prázdné (výchozí) = automatická URL z jazykového souboru pro aktuální jazyk webu.
• Vlastní URL = stejná URL pro všechny jazyky (přepíše automatický překlad).

Výchozí URL dle jazyka:

Na vícejazyčném webu, kde každý jazyk má jinou URL cookie policy (např. /cs/o-nas/pouziti-cookies vs /en/about-us/cookie-policy), použijte Joomla Language Overrides k nastavení klíče PLG_SYSTEM_SEMACOOKIECONSENT_DEFAULT_POLICY_URL pro každý jazyk se správnou cestou.

Přidání nového jazyka

Možnost 1: Jazykový soubor (doporučeno)

1. Vytvořte soubor /plugins/system/semacookieconsent/language/{TAG}/plg_system_semacookieconsent.ini (např. pl-PL pro polštinu).
2. Zkopírujte obsah z en-GB/plg_system_semacookieconsent.ini.
3. Přeložte všechny klíče začínající na PLG_SYSTEM_SEMACOOKIECONSENT_DEFAULT_ (19 klíčů).
4. Admin labels (položky bez _DEFAULT_) můžete nechat anglické – ovlivňují jen admin rozhraní.

Možnost 2: Joomla Language Overrides

1. V administraci Joomla přejděte do System > Language Overrides.
2. Vyberte cílový jazyk a klikněte na New.
3. Přepište klíče PLG_SYSTEM_SEMACOOKIECONSENT_DEFAULT_* svým překladem.

Fallback

Pokud jazyk webu nemá odpovídající jazykový soubor, Joomla automaticky použije angličtinu (en-GB).

Důležité: Po upgradu z verze 1.0.4 na 1.0.5 instalační skript automaticky vyčistí uložené výchozí texty z databáze, čímž aktivuje dynamický překlad. Pokud jste měli vlastní texty, zůstanou zachovány.

16. Řešení problémů

Banner se nezobrazuje

1. Ověřte, že plugin je povolený (Status = Enabled).
2. Zkontrolujte, zda aktuální stránka není v seznamu Vyloučených menu položek.
3. Ověřte, že návštěvník ještě neudělil souhlas (smažte scc_cookie_consent v localStorage prohlížeče a cookieconsent_status v cookies).
4. Zkontrolujte konzoli prohlížeče (F12) na JavaScript chyby.
5. Ověřte, že na stránce není jiný plugin, který blokuje onAfterRender.

Banner se zobrazuje, ale chybí CSS (nevypadá správně)

1. Ověřte, že soubor existuje: {root}/media/plg_system_semacookieconsent/css/semacookieconsent.css.
2. Pokud soubor chybí, plugin není správně nainstalován – přeinstalujte.
3. Zkontrolujte, zda jiný plugin neodstraňuje CSS z <head>.

Google Consent Mode nefunguje

1. Ověřte, že Povolit Google Consent Mode v2 je zapnuto v nastavení pluginu.
2. Zkontrolujte zdrojový kód stránky (Ctrl+U) – consent-mode.js musí být v <head> PŘED jakýmkoli gtag.js nebo GTM skriptem.
3. Zkontrolujte konzoli prohlížeče – dataLayer musí obsahovat consent událost s default hodnotami.

Log souhlasu je prázdný

1. Ověřte, že Povolit logování souhlasu je zapnuto.
2. Zkontrolujte, zda návštěvník skutečně klikl na tlačítko v banneru (obnovení stránky bez interakce nezaloguje nic).
3. Zkontrolujte konzoli prohlížeče na chyby AJAX požadavku na com_ajax.
4. Ověřte, že tabulka #__semacookieconsent_consents existuje v databázi.

Po upgradu se banner chová divně

• Návštěvník musí provést hard refresh (Ctrl+Shift+R) pro načtení nových JS/CSS souborů.
• Starší souhlas v localStorage může mít jinou strukturu – smazání scc_cookie_consent v localStorage a obnovení stránky problém vyřeší.

Dashboard ukazuje nulové hodnoty

• Dashboard zobrazuje data za posledních 30 dní. Pokud v tomto období nebyly žádné interakce, je to očekávané.
• Ověřte, že logování souhlasu je zapnuté.

Banner se zobrazuje na stránce, kde neměl

• Přidejte Joomla menu item ID do pole Vyloučené menu položky v nastavení pluginu.
• ID menu položky naleznete v Menus > [název menu] – sloupec ID.

Kontrolní seznam pro spuštění

• Plugin nainstalován a povolen
• URL zásad cookies nastavena a stránka existuje
• Barvy přizpůsobeny designu webu
• Kategorie nastavené podle používaných služeb (GA4, Google Ads, Facebook atd.)
• Cookies k mazání odpovídají skutečně použitým cookies na webu
• Google Consent Mode zapnut (pokud používáte Google služby)
• Logování souhlasu zapnuto
• Anonymizace IP zapnutá (doporučeno pro GDPR)
• Stránka se zásadami cookies (/pouziti-cookies) je kompletní a aktuální
• Stránka ochrany osobních údajů odkazuje na stránku cookies
• Testovací souhlas udělen a záznam se objeví v Logu souhlasu
• Dashboard ukazuje správná data

Jak to vypadá v administraci