Documentazione

Cookie Solution – Guida all’installazione del modulo per Magento

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

Una volta scaricata, decompressa e copiata l’estensione in /magento/app/, hai 2 modi per installare la nostra Cookie Solution:

Modo 1: Installazione guidata

Nel pannello di amministrazione vai in System > Configuration > Advanced > Advanced:

iubenda Cookie Solution per Magento 1.9.x

Individua e abilita il modulo iubenda_cookiesolution (se hai difficoltà a trovarlo in “Disable Modules Output” svuota la cache su System > Cache Management e riprova):

iubenda Cookie Solution per Magento 1.9.x

Modo 2: Installazione da shell

Questo metodo richiede l’accesso alla shell del server: ti basterà digitare php bin/magento setup:upgrade per lanciare l’installazione o l’aggiornamento.

Una volta scaricata, decompressa e copiata l’estensione in /magento/app/code/, hai 3 modi per installare la nostra Cookie Solution:

Modo 1: Installazione guidata

Nel pannello di amministrazione vai in System > Web Setup Wizard > Module Manager:

Magento wizard

Individua e abilita il modulo iubenda_cookiesolution:

Modulo iubenda Cookie Solution per Magento

Magento ora verificherà che non ci siano problemi con la versione e le estensioni PHP, i permessi dei file, i cron job e di compatibilità in generale. Devi passare tutti i controlli per poter procedere.

Installazione del modulo iubenda Cookie Solution per Magento

Una volta impostate le preferenze sul backup sarai in grado di abilitare il modulo di iubenda.


Modo 2: Installazione manuale

Vai alla cartella /magento/app/etc tramite client ftp o cPanel e apri il file config.php. Aggiungi esattamente questa riga di codice in fondo, subito dopo l’ultima:

'iubenda_cookiesolution' => 1

File config.php per l'installazione manuale del plugin di iubenda su Magento

Salva il file, vai al pannello di amministrazione e svuota la cache (puoi farlo in System > Cache Management). Seleziona tutto l’elenco e l’opzione Refresh, quindi clicca su Submit:

Cache management di Magento

Modo 3: Installazione da shell

Questo metodo richiede l’accesso alla shell del server: ti basterà digitare php bin/magento setup:upgrade per lanciare l’installazione o l’aggiornamento.

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 utilizzando il “wrapping”, metodo che illustriamo qui sotto e (più in dettaglio) in questa guida.

Uso manuale

Ecco come far funzionare manualmente il plugin per un pulsante Facebook (che inserisce gli script nella pagina tramite JavaScript, vedi nota poco sopra).

<!--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.facebook.net/en_US/sdk.js#xfbml=1&version=v2.3&appId=808061959224601";
        fjs.parentNode.insertBefore(js, fjs);
    }(document, 'script', 'facebook-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-->
1.0.4

New: Option to block custom scripts and iframes
Tweak: Update and extend the list of blocked scripts including Google Site Search, Google oAuth, LinkedIn widgets, PayPal widgets, Freshchat, UserVoice, AdRoll, Olark, Segment, Kissmetrics, Mixpanel, Pingdom, Bing and Elevio

1.0.3

Tweak: Update and extend the list of blocked scripts including Pinterest, AddThis, Disqus, Optimizely, Neodata, Criteo, Outbrain, Headway and CodePen

1.0.2

Tweak: Update and unify iubenda parsing engine

1.0.1

Tweak: iubenda faster class regex update

1.0

Initial release

Leggi anche