Documentazione

Indice dei contenuti

Cookie Solution – Guida all’installazione del modulo per Magento

  • Sono disponibili due moduli: uno per la versione 1.9.x, l’altro per la 2.x
  • Si consiglia PHP 5.5 o superiore

Funzionalità

  • I moduli aggiungono automaticamente il codice di iubenda nella sezione HEAD di tutte le pagine del sito.
  • Gestiscono la visualizzazione del banner e della cookie policy, nonché il salvataggio delle preferenze di consenso dell’utente sull’installazione dei cookie.
  • Semplificano la gestione della Cookie Solution di iubenda per i siti in più lingue.
  • 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

Installazione

  • Accedi all’admin del tuo store Magento con le credenziali di amministratore e vai in System > Magento Connect > Magento Connect Manager
  • Reinserisci le tue credenziali di accesso di Magento
  • Fai click su Create Backup per effettuare un backup.

Una volta concluso il backup, puoi caricare lo zip disponibile qui in Direct package file upload. Oppure:

  • Ottieni l’estensione iubenda Cookie Solution dal Magento Marketplace facendo click su Add to cart e completando l’ordine con il pulsante Install.
  • Copia l’Access Key dell’estensione, torna su System > Magento Connect > Magento Connect Manager e incolla la chiave nel campo Paste extension key to install:.
  • Fai click su Install, seguito da Proceed per concludere l’installazione.

Una volta che l’estensione è installata, torna al pannello di amministrazione di Magento per configurare la tua estensione iubenda Cookie Solution.

  • Ottieni l’estensione iubenda Cookie Solution dal Magento Marketplace facendo click su Add to cart e completando l’ordine con il pulsante Install.
  • Accedi all’admin del tuo store Magento con le credenziali di amministratore.
  • Nella barra laterale, fai click su System > Web Setup Wizard (sotto “Tools”).
  • Seleziona Extension Manager. Incolla le chiavi di accesso pubblica e privata del tuo account Marketplace. Quindi, fai click su Submit.
  • Per sincronizzare il Component Manager con gli acquisti effettuati sul Marketplace, fai click su Sync (potrebbe servire qualche minuto).
  • Nella sezione Marketplace Purchases (sotto “New Purchases”), fai click su Install.
  • Nell’Extensions Grid, spunta la checkbox dell’estensione che vuoi installare (in questo caso, iubenda Cookie Solution). Quindi fai click su Install alla rispettiva colonna Action.

Ci sei quasi. Segui questi passi per completare la procedura di installazione:

  • Controllo di compatibilità: prima di iniziare l’installazione devi verificare che il tuo store sia compatibile: fai click su Start Readiness Check, seguito da Next quando il controllo è terminato.
  • Creazione del backup: in questa fase il tuo store entrerà in modalità di manutenzione. Fai click su Create Backup per iniziare, quindi Next una volta che la procedura è terminata.
  • Installazione: il tuo store andrà temporaneamente offline. Per iniziare fai click su Install. Una volta terminato, Back to Setup Tool. Ora fai click su Component Manager e da lì, nell’angolo in alto a destra, fai click su Reset per fare il logout.
  • Flush della cache: nella barra laterale dell’admin scegli System > Cache Management (sotto “Tools”). Spunta la checkbox corrispondente alla riga “iubenda Cookie Solution”. Imposta Action su Refresh, e poi fai click su Submit.

Per maggiori dettagli (in inglese) consulta la Magento User Guide.

Configurazione

Al termine dell’installazione, vai su Stores > Configuration > iubenda > iubenda Cookie Solution per configurare il nostro modulo. Lì dovrai incollare il codice della Cookie Solution che trovi nel tuo account iubenda (come spiegato nella guida introduttiva), salva e svuota la cache.

Attenzione

Avrai bisogno di codice JavaScript valido per assicurarti che il plugin funzioni correttamente.

Uso

Una volta completata la configurazione, il plugin inizierà a mostrare il cookie banner agli utenti che visitano il tuo sito per la prima volta. Il plugin riconoscerà e bloccherà automaticamente i cookie indicati nell’elenco delle funzionalità.

Importante

I nostri moduli per Magento bloccano 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.

Nel pannello di amministrazione vai in System > Configuration. Successivamente, fai click su iubenda Cookie Solution nel menu a sinistra, giù in fondo alla voce Services:

iubenda Cookie Solution - Custom scripts

Ora vai alla sezione Custom:

iubenda Cookie Solution - Custom scripts

Inserisci i tuoi script/iframe, e fai click su Save Config in alto a destra.

Nel pannello di amministrazione vai in Stores > Configuration > iubenda > iubenda Cookie Solution:

iubenda Cookie Solution - Modulo per Magento

Vai alla sezione Custom:

iubenda Cookie Solution - Modulo per Magento - Custom scripts

Inserisci i tuoi script/iframe, e fai click sul pulsante Save Config che trovi 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-->

Installa il modulo per Magento

Magento 1.9.x

Leggi il changelog

oppure

Magento 2.x

Leggi il changelog

Leggi anche