Fucking EU cookies

One-file zasraná hláška pro zasranou EU, v jednom scriptu, 1,5 kB, 1 request, TLS (SSL), asynchronní, hostováno na S3, bez závislosti na jQuery, s podporou Tag manageru a navrženo se záměrem nejméně obtěžovat uživatele.

[EN] Sorry, this readme is currently possible only in Czech, because main target users are in CZ.

Instalace

Pro nainstalování tohoto rozšíření stačí do stránky vložit následující kód:

<script src="//s3-eu-west-1.amazonaws.com/fucking-eu-cookies/cz.js" async></script>

Kód můžete vložit kamkoliv do stránky, ale nelépe někam mezi <head> a </head>.

Takto nainstalovaná knihovna má funkce:

zobrazení lišty v horní části stránky,
poučení uživatele o ukládání cookies, jak zasraná EU káže,
po stisknutí tlačítka souhlasu uložení cookie, aby se lišta do dobu 1 roku již nezobrazila,
respektuje některá rozšíření pro automatické odsouhlasení.

Úpravy vzhledu

Vzhled lišty lze snadno upravit nastavením vlastností pro třídu .fucking-eu-cookies, abyste převážili výchozí nastavení, možná bude potřeba odkazovat se na .fucking-eu-cookies.fucking-priority.

Příklad změny na fixní verzi – užitečné v situaci, kdy základní vzhled rozbíjí layout stránky:

.fucking-eu-cookies.fucking-priority {
	position: fixed;
	left: 0;
	bottom: 0;
	width: 100%;
	box-sizing: border-box;
}

Obdobně můžete upravit i následující prvky: .fucking-eu-cookies.fucking-priority span pro text, .fucking-eu-cookies.fucking-priority a pro odkaz na Více informací a .fucking-eu-cookies.fucking-priority button pro tlačítko.

Úpravy funkčnosti

Lištu lze konfigurovat pomocí konfigurační proměnné fucking_eu_config.

Změny textace

Textaci lze konfigurovat parametrem l18n, tedy např. změna popisu tlačítka:

<script>
	var fucking_eu_config = {
		"l18n": {
			"accept": "OK"
		}
	};
</script>

Takto lze přepsat všechny výchozí hodnoty ze souboru source/l18n.cz.json.

Nastavení chování

Chování lze konfigurovat parametrem options, tedy např. zobrazování informací v novém okně:

<script>
	var fucking_eu_config = {
		"options": {
			"popupMore": true
		}
	};
</script>

Takto lze přepsat všechny výchozí hodnoty ze souboru source/options.json.

Umístění lišty v kódu

Ve výchozím nastavení se lišta vykresluje na na začátek stránky (jako první potomek <body>), parametrem insertTo lze upravit toto chování. Pokud hodnotu nastavíte na 'body-begin' nebo 'body-end', vloží se lišta na začátek/konec stránky. Pokud zadáte jinou hodnotu, zkusí se najít takový element podle id a vloží lištu na jeho konec.
Upozornění: Pokud nebude element s daným ID v DOM stránky nalezen, lišta se nezobrazí, ale nezobrazí se žádné varování.

<script>
	var fucking_eu_config = {
		"options": {
			"insertTo": "myPlaceForCookie"
		}
	};
</script>
…
<dic id="myPlaceForCookie"><!-- Panel will be place here --></a>

Callback a propojení s Google Tag Manager

Pomocí parametrů callback a dataLayerName lze sledovat události lišty. Callback se hodí zejména pro sladění složitějšího designu stránky (když, např. zobrazená lišta překrývá stránku), dataLayer pak posílá eventy pro měření uživatelského chování. Obě funkce jsou na sobě nezávislé, lze použít jednu z nich a nebo obě. Nicméně obě dostávají stejná data.

Callback předává dva parametry, action s názvem události (možné hodnoty: 'init','show','no-show','hide' a 'open-more') a label s dalšími informacemi (např.: důvod nezobrazení lišty u akce 'no-show'). Příklad:

<script>
	function myCallback( action, label ) {
		console.log(action, label);
		// Example output: 'no-show', 'unsupported browser'
	}
	var fucking_eu_config = {
		"options": {
			"callback": myCallback
		}
	};
</script>

Do Google Tag Manageru pak provolává event nazvaný fucking-eu-cookies se stejnými parametry jako Callback. Příklad:

<script>
	var dataLayer = [];
	var fucking_eu_config = {
		"options": {
			"dataLayerName": 'dataLayer' // Note: input variable name (in 'quotes'), no variable directly
		}
	};
	// Example event values: {event: 'fucking-eu-cookies', action: 'no-show', label: 'unsupported browser'}
</script>

Více o použití proměnné dataLayer v GTM najdete v dokumentaci a nebo v článku Variable Guide.

Tento kód uveďte vždy před volání lišty, tedy např.:

<script>
	var fucking_eu_config = { … };
</script>
<script src="//s3-eu-west-1.amazonaws.com/fucking-eu-cookies/cz.js" async></script>

Obtěžování uživatele

Uvědumuju si, že zasrané nařízení je zcela zbytečné a nesmyslné. Nedává mi proto smysl upozornění dělat obzvlášť výrazné a obtěžující. Z toho důvodu je lišta:

psaná malým písmem,
v nevýrazných barvách (které jsou převzaty z barev systéových lišt),
nemá fixní pozici, aby se dala odrolovat pryč,
respektuje některé nejoblíbenější rozšíření pro blokování reklam a takovýchto EU hlášek (má se za to, že instalací nástroje na jejich blokování již uživatel vyjádřil globálně plošný souhlas a je náležitě informován).

Známé problémy

Text splňuje zasrané požadavky zasrané EU s drobným nedostatkem, že cookies se pravděpodobně do počítače uživatele uloží dříve, než tento vyjádří souhlas, nebo než se s požadovanou informací seznámí. Lišta totiž vytváření cookies neomezuje, pouze zajišťuje informování uživatelů a získání jejich tichého souhlasu. Jednoduchost instalace je vykoupena právě tímto nedostatkem.

Problémy zobrazení:

Na webech s obrázkem na pozadí stránky, které je pozicované vůči prvkům ve stránce, může lišta způsobit rozpad layoutu.
Na webech s nenulovým marginem/paddingem stránky, ve kterém ale design do krajů zasahuje, může lišta způsobit vypadat hodně ošklivě. V obou případech pak doporučuji ve stránce doplnit stylopis, který lištu změni na fixně pozicovanou.

Podpora browserů počítá pouze s moderními browsery. V zastaralých verzích se může lišta zobrazit nesprávně a nebo může zcela chybět. Záleží mi na tom, aby se ani ve starších verzích nic nerozbilo. Pokud se lišta zobrazila opravdu chybně, prosím o na hlášení.

Připojovaný soubor má nastaveno velmi dlouhé cachování, aby tento soubor byl v koncových stanicích ukládán co nejdéle. Výhodou je velmi rychlé načítání. Nevýhodou je poměrně velký rozptyl verzí, které mohou mít v jednom okamžiku uživatelé na počítači. Při modifikacích a ovládání lišty dbejte na doporučení v návodech, které zohledňují zpětnou kompatibilitu.

Zabezpečení

Knihovna je hostována na serverech Amazonu na službě Simple storage service, která vyniká vysokou dostupností a zabezpečením. Protože se jedná o script vkládaný do stránky, byla zvoleno toto řešení právě s ohledem na zabezpečení, které minimalizuje možnosti neautorizovaného přístupu k tomuto souboru.

Changelist

Look here: https://github.com/jakubboucek/fucking-eu-cookies/releases

Poděkování

Davidovi Grudlovi za nakopnutí článkem Jak na souhlas s cookie ve zkurvené EU,
Michalovi Špačkovi za tip na bonznutí lišty do různých AdBlocků (připomínám: záměr je co nejméně obtěžovat uživatele),
Bohumilu Jahodovi za upozornění za nepříjmenou chybu.

gitter-badger / fucking-eu-cookies Goto Github PK