Iubenda logo
Inizia la generazione

Documentazione

Indice dei contenuti

Cookie Solution – Guida all’installazione del modulo per Magento

Questo modulo ti permette di semplificare la configurazione della Cookie Solution, riducendo drasticamente la necessità di interventi diretti sul codice del sito.

La nostra Cookie Solution ti permette di creare un cookie banner completamente personalizzabile, generare una cookie policy in linea con i servizi usati dal tuo sito, e ottenere e gestire il consenso all’uso dei cookie – compreso il blocco preventivo automatico degli script più comuni – al fine di rispettare i requisiti del GDPR e della Direttiva ePrivacy.

  • Sono disponibili due moduli: uno per la versione 1.9.x, l’altro per la 2.x. Tieni però presente che Adobe ha cessato il supporto a Magento 1.x il 30 giugno 2020. Per quanto riguarda la versione 2.x, il nostro modulo supporta Magento Open Source (Magento Community Edition) e Magento Commerce (Magento Enterprise Edition e Magento Enterprise Cloud Edition).
  • Si consiglia PHP 5.5 o superiore

Funzionalità

  • Il modulo aggiunge automaticamente il codice di iubenda nella sezione HEAD di tutte le pagine del sito.
  • Permette di bloccare automaticamente o manualmente gli script che necessitano del consenso preventivo, senza dover intervenire manualmente sul codice.
  • Una volta che il consenso è stato prestato, riattiva gli script in modo asincrono.
  • Gestisce la visualizzazione del cookie banner e della cookie policy, permettendoti di personalizzare l’avviso a piacimento.
  • Evita di mostrare il cookie banner a chi ha già espresso le proprie preferenze di consenso.
  • Supporta il Transparency and Consent Framework v2.0 di IAB.
  • È munito di un’intuitiva interfaccia per specificare script e iframe.
  • Rileva bot e spider, e non interferisce con le tue attività SEO.
  • Supporta l’auto-assegnazione delle categorie quando si bloccano gli script.
  • 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

Magento 2.x (Community/Enterprise/Cloud Edition)

  1. Collegati via SSH al tuo server.
  2. Installa il nostro modulo con il comando composer require iubenda/module-cookiesolution. Se vuoi usare una release diversa dall’ultima rilasciata, indica anche il numero della versione, ad esempio iubenda/module-cookiesolution:2.2.0
  3. Quando richieste, usa la Public key per il login e la Private key per la password (ti verrà chiesto di “acquistare” l’estensione per procedere).
  4. Installato il modulo, verifica lo status con php bin/magento module:status
  5. Il modulo dovrebbe essere disabilitato. Abilitalo con php bin/magento module:enable Iubenda_CookieSolution e php bin/magento setup:upgrade
  6. Se il tuo store è in produzione, compila la build con php bin/magento setup:di:compile
  7. Verifica che il tuo modulo sia ancora attivo con php bin/magento module:status. In caso, pulisci la cache con php bin/magento cache:clean

Disinstallazione delle release pre-marketplace

  1. Apri il file config.php che trovi nella cartella “/app/etc/”, cerca 'iubenda_cookiesolution' => 1, sostituisci 1 con 0 e salva.
  2. Elimina la cartella “/app/code/Iubenda/CookieSolution”.
  3. Se la cache è attiva, devi ripulirla: vai su System > Cache Management, spunta tutto e fai click su Refresh.
  4. Apri nuovamente il file config.php (cartella “/app/etc/”), elimina la riga
    'iubenda_cookiesolution' => 0 e salva.
  • 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.

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

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.

Magento 2.x (Community/Enterprise/Cloud Edition)

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.

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.

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-->

Se hai abilitato il consenso per categoria dovrai assegnare la categoria. Riprendendo l’esempio del pulsante social, essendo parte della categoria “Esperienza migliorata” (id 3):

<!--IUB-COOKIE-BLOCK-START-PURPOSE-3-->
      <script type="text/javascript">
      ...
      </script>
      <script type="text/javascript" src="..."></script>
      <noscript>
      ...
      </noscript>
<!--IUB-COOKIE-BLOCK-END-PURPOSE-3-->

Per fermare il parsing automatico degli iframe/script che contengono un src:

<!--IUB-COOKIE-BLOCK-SKIP-START-->
      <script type="text/javascript">...</script>
<!--IUB-COOKIE-BLOCK-SKIP-END-->

Installa il modulo per Magento

Magento 2.x Community/Enterprise/Cloud Edition

oppure

Magento 1.9.x

Leggi anche