Documentazione

Indice dei contenuti

Cookie Solution – Guida all’installazione del plugin per Joomla!

Il plugin Joomla! di iubenda ti consente di semplificare la configurazione della Cookie Solution automatizzando il blocco dei cookie prima del consenso, e riducendo così la necessità di interventi diretti sul codice del sito.

Attenzione
  • Il plugin è scaricabile direttamente dalla Joomla! Extension Directory
  • La iubenda Cookie Solution richiede al momento una versione minima di jQuery pari alla 1.4.4
  • Si richiede almeno la versione 2.5 di Joomla! (o una versione più recente)
  • Una versione di PHP pari o più recente rispetto alla 5.3 è consigliata, ma non necessaria
iubenda Cookie Solution - Plugin per Joomla!

Funzionalità

  • Il plugin aggiunge automaticamente il codice di iubenda al tag HEAD di tutte le pagine del sito
  • Gestisce la visualizzazione del banner e della cookie policy, nonché la lettura del consenso ed il salvataggio della preferenza dell’utente all’installazione dei cookie
  • Semplifica la gestione della Cookie Solution di iubenda su siti web multilingua
  • AdRoll
  • AddThis widgets
  • Bing
  • CodePen
  • Criteo
  • Disqus
  • Elevio
  • Facebook Comments
  • Facebook widgets
  • Freshchat
  • Google AdSense
  • Google Analytics
  • Google Maps
  • Google ReCaptcha
  • Google Site Search
  • Google Tag Manager
  • Google oAuth
  • Google+ widgets
  • Headway
  • Instagram widgets
  • Kissmetrics
  • LinkedIn widgets
  • Mixpanel
  • Neodata
  • Olark
  • Optimizely
  • Outbrain
  • PayPal widgets
  • Pingdom
  • Pinterest widgets
  • Segment
  • ShareThis widgets
  • Twitter widgets
  • UserVoice
  • Vimeo
  • YouTube

Istruzioni

Se stai installando il plugin per la prima volta, vai direttamente qui.

Se invece hai già installato una versione precedente del plugin, puoi aggiornarlo seguendo questi passi:

  1. Come prima cosa elimina la vecchia versione. Fai click su Estensioni > Gestione, seleziona il plugin e fai click su Disinstalla.
  2. Visita la Joomla! Extensions Directory e scarica la nuova versione del plugin.
  3. Installalo seguendo la procedura a seguire.

Installazione

  • Accedi al pannello di amministrazione (ad esempio www.example.com/administrator)
  • Clicca su Estensioni > Gestione > Installa
  • Carica il file ZIP del plugin (disponibile gratuitamente qui)

Attivazione

  • Clicca su Estensioni > Gestione > Aggiorna
  • Cerca “iubenda” e attiva il plugin

Come aggiungere il cookie banner e modificare le impostazioni del plugin

  • Fai click su Estensioni > Plugin

  • Cerca “iubenda” e clicca sul nome del plugin. Il pannello (in inglese) si presenta come segue: Cookie Solution - Joomla! plugin

  • Copia il codice generato all’interno del tuo account iubenda: Codice di integrazione della Cookie Solution (Consulta la guida dedicata alla configurazione della iubenda Cookie Solution per ulteriori informazioni su come generare il codice ed accedere alla schermata riportata in alto)

  • Fai click su Settings, incolla il codice di integrazione della Cookie Solution e salva: Cookie Solution - Joomla! plugin (Essendo in PHP nativo, consigliamo la prima e più veloce opzione per il motore di parsing. Se si verificano dei problemi, ti invitiamo a provare con l’opzione alternativa)

Uso

A questo punto il plugin mostrerà sul tuo sito il banner con il link alla cookie policy, senza alcuna ulteriore configurazione richiesta. Il banner comparirà alla prima visita dell’utente. In più, il plugin riconoscerà e bloccherà in automatico i cookie installati da tutti i servizi elencati nella lista di cui sopra.

Importante

Il nostro plugin per Joomla! blocca automaticamente gli script generati lato server (restituiti via PHP). Gli script inclusi tramite JavaScript dopo il caricamento delle pagine non sono e non possono essere bloccati automaticamente.

Questi script possono essere bloccati prima del consenso inserendo il sorgente nel campo Custom scripts della console del plugin oppure ricorrendo al “wrapping”, metodo che illustriamo qui sotto e (più in dettaglio) in questa guida.

Blocco degli script personalizzati dall’interno della console

Il campo Custom scripts permette di bloccare facilmente gli script in pagina direttamente dalla console del plugin. Questo riduce notevolmente la necessità di apportare modifiche al codice del sito.

Ecco come procedere:

  • Vai in Extensions > Plugins dal tuo pannello di amministrazione.
  • Cerca “iubenda”, fai click sul nome del plugin, poi sulla scheda Settings in alto.
  • Scorri fino ai campi Custom scripts e Custom iframes: Joomla! - Campi per custom script/iframe
  • Inserisci i tuoi script/iframe e fai click sul pulsante Save & Close in alto.

Esempi

L’utilizzo di questi campi è piuttosto semplice. Basta inserire lo script o l’iframe che desideri bloccare.

Script

Per bloccare un pulsante social (che inserisce gli script nella pagina tramite JavaScript), è sufficiente inserire il sorgente dello script (ad esempio connect.socialwebsite.net/en_US/track.js) nel campo Scripts.

iframe

Poniamo che tu voglia bloccare gli script inseriti nella pagina tramite questo iframe:

<iframe width="1280" height="720" src="https://www.videowebsite.com/embed/xxFhMChxx" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Quello che devi inserire nel campo iframe è videowebsite.com/embed, essendo questa l’effettiva sorgente dello script. Fai attenzione a non inserire l’id dell’src videowebsite.com/embed/xxFhMChxx, così da essere sicuro che tutti gli script provenienti da videowebsite.com/embed siano bloccati.

Uso manuale (“wrapping”)

Questo metodo richiede la modifica del codice delle pagine del sito. Dovrai “avvolgere” gli script da bloccare tra degli appositi commenti.

Ecco un esempio di come far funzionare manualmente il plugin per un pulsante social (che inserisce gli script nella pagina tramite JavaScript):

<!--IUB-COOKIE-BLOCK-START-->
<script>
    (function(d, s, id) {
        var js, fjs = d.getElementsByTagName(s)[0];
        if (d.getElementById(id)) return;
        js = d.createElement(s);
        js.id = id;
        js.src = "//connect.socialwebsite.net/en_US/sdk.js#xfbml=1&version=v2.3&appId=808061959224601";
        fjs.parentNode.insertBefore(js, fjs);
    }(document, 'script', 'socialwebsite-jssdk'));
</script>
<!--IUB-COOKIE-BLOCK-END-->

In caso di elementi HTML / IMG / IFRAME, bisognerà procedere così:

<!--IUB-COOKIE-BLOCK-START-->
      <iframe src="...
      <img src="...
<!--IUB-COOKIE-BLOCK-END-->

Nota: i tuoi feedback sono i benvenuti, scrivi pure le tue segnalazioni nella discussione dedicata al plugin Joomla! all’interno del nostro forum Uservoice.

Leggi anche