Documentazione

Una volta registrato il tuo sito internet, CookieRulez effettua una scansione della profondità richiesta a partire dalla home page per rilevare gli url da scansionare in seguito per cercare i cookie impostati.

Ciascun url viene quindi scansionato, e CookieRulez raccoglie tutti i cookie settati.

Potrai controllare tutti i cookie trovati, dividerli in categorie ed aggiungere una descrizione (uno scopo).

CookieRulez definisce 4 categorie di cookie:

Necessari sono cookie assolutamente necessari al funzionamento del sito, sono sempre abilitati e non possono essere disabilitati dall'utente
Performance sono cookie che raccolgono informazioni in maniera anonima su come l'utente utilizza il sito web e che consentono di apportare migliorie grazie all'aggregazione di informazioni;
Funzionalità sono cookie che vengono utilizzati per fornire funzionalità, ricordare scelte dell'utente e che permettono di offrire un'esperienza di navigazione più personalizzata;
Marketing sono cookie che vengono utilizzati per proporre contenuti pubblicitari più rilevanti per l'utente;

CookieRulez genera un javascript apposta per il tuo sito che dovrai inserire in ogni pagina. Potrai anche scegliere se utilizzare un tema predefinito (light o dark), ed in questo caso dovrai includere anche un css, oppure stilizzare a tuo piacimento il widget.

<script src="https://cookierulez.sqrt64.it/widget/CODICE"></script>
<link href="https://cookierulez.sqrt64.it/static/widget/css/widget.css" rel="stylesheet" />

CookieRulez controllerà quali cookie sono disabilitati e provvederà ad eliminarli (se possibile, vedi cookie di terze parti più avanti), ricordandosi poi della scelta dell'utente. L'utente potrà successivamente modificare la propria scelta, infatti è possibile mostrare sempre un link che permette di riaprire il layer dei cookies (opzione nella configurazione del sito), oppure utilizzare un metodo apposito per riaprire il layer in javascript.

cookierulez.CookieLayer.open();

E' anche possibile impostare una funzione di callback da chiamare dopo che l'utente hs salvato le proprie impostazioni, utile ad esempio se fosse necessario ricaricare la pagina:

cookierulez.CookieLayer.setSubmitCallback(function () {
  location.reload();
);

Cookie di terze parti

I Cookie di terze parti sono quelli impostati su domini differenti da quello del nostro sito web, e quindi non accessibili via javascript!

Cookie di terze parti possono essere impostati da immagini, link (nell'head del documento), iframe, ed ovviamente script. Anche object ed embed tag possono settare cookie ma in questo momento non li consideriamo.

L'unico modo per fermare la scrittura di questi cookie è disabilitare la loro sorgente, e riabilitarla se l'utente ha acconsentito alla scrittura di cookie di quella categoria. Per fare questo dobbiamo sapere quale è la sorgente dei cookie, e di quale categoria sono. CookieRulez ci aiuta dicendoci quale è il primo url in cui è stato trovato un cookie.

Vediamo come bloccare cookie di terze parti impostate dai vari elementi.

script

Per bloccare uno script, impostare l'attributo type a 'text/plain' e definire a quale categoria di cookie appartiene aggiungendo l'attributo data-cookierulez, ad esempio:

<script type="text/plain" data-cookierulez="performance"></script>

In questo modo CookieRulez potrà attivare solamente gli script che impostano cookie cui l'utente ha dato il consenso.

img

Sostituire l'attributo src con data-src, ed aggiungere la categoria di cookie:

<img data-src="path/img" data-cookierulez="performance" />

iframe

Sostituire l'attributo src con data-src, ed aggiungere la categoria di cookie:

<iframe data-src="path/iframe" data-cookierulez="performance"></iframe>

link

Sostituire l'attributo href con data-href, ed aggiungere la categoria di cookie:

<link data-href="path/font" rel="stylesheet" data-cookierulez="performance" />

Abilitare script dopo il caricamento della pagina

Dopo il caricamento della pagina tutti gli script / immagini etc... sono stati abilitati. Ma è possibile che alcuni contenuti vengano renderizzati solamente dopo, a seguito di chiamate ajax. In questo caso bisogna far nuovamente eseguire il parsing a CookieRulez:

// parsing di tutti gli oggetti
cookierulez.CookieManager.exec();
// parsing dei soli script
cookierulez.CookieManager.parseScripts();