Documentazione

Indice dei contenuti

Cookie Solution – Guida all’installazione del plugin per PrestaShop

Il plugin PrestaShop di iubenda ti permette di semplificare la configurazione della Cookie Solution e la messa a norma del sito rispetto a quanto richiesto dalla Cookie Law, riducendo drasticamente la necessità di interventi diretti sul codice del sito.

Attenzione
  • Il plugin è compatibile con PrestaShop 1.7.x e versioni successive
  • Per utilizzare il plugin, è necessario abilitare gli override (attivi di default)
iubenda Cookie Solution per PrestaShop

Funzionalità

  • Il plugin aggiunge automaticamente il codice di iubenda nella sezione HEAD di tutte le pagine del sito.
  • Gestisce la visualizzazione del banner e della cookie policy, nonché la raccolta del consenso ed il salvataggio delle preferenze dell’utente rispetto all’installazione dei cookie.
  • Semplifica la configurazione della iubenda Cookie Solution sui siti 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

Installazione e attivazione

Per installare il plugin:

  • accedi al tuo sito PrestaShop ed apri il pannello di amministrazione;
  • clicca su Modules > Modules & Services nel menu laterale;
  • clicca sul pulsante Upload a module che troverai in testata;
  • carica il file iubenda_cookie_prestashop_plugin.zip per installare il modulo. Importante: è necessario caricare su PrestaShop l’intero archivio ZIP del plugin, non le sue cartelle o i suoi file decompressi.

Se l’installazione è andata a buon fine, il plugin verrà aggiunto alla lista Modules & Services e visualizzerai questo messaggio di conferma:

Plugin PrestaShop di iubenda

Completata l’installazione, non resta altro che configurare le impostazioni del modulo.

Come aggiungere il cookie banner e modificarne le impostazioni

Adesso che il modulo è pronto per l’utilizzo, è necessario aggiungere il codice che trovi all’interno della tua dashboard iubenda.

  • Se non hai cliccato sul pulsante Configure poco sotto il messaggio di avvenuta installazione, vai alla pagina Modules & Services e trova il plugin di iubenda: Plugin PrestaShop di iubenda

  • Clicca su Configure per visualizzare le impostazioni del plugin.

  • Copia il codice della Cookie Solution, disponibile nella tua dashboard iubenda: Codice di integrazione della Cookie Solution (Se non hai ancora generato il codice per il tuo cookie banner, puoi farlo qui. Consulta la guida dedicata alla iubenda Cookie Solution per maggiori informazioni)

  • Incolla il codice nel form del plugin: Plugin PrestaShop di iubenda (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 PrestaShop 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:

  • Accedi al pannello di amministrazione e vai alla sezione Improve. Da lì fai click su Extensions > Plugins.
  • Cerca “iubenda” e, una volta apparso il plugin, fai click su Configure.
  • Scorri fino ai campi Custom scripts e Custom iframes: PrestaShop - Campi per custom script/iframe
  • Inserisci i tuoi script/iframe e fai click sul pulsante Save in basso 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-->

Ulteriori informazioni

Per call API e xmlrpc ti suggeriamo di aggiungere il parametro ?iub_no_parse=1.

Errore “Forbidden” di PrestaShop
Attenzione

Fai un backup del tuo sito prima di tentare qualsiasi intervento.

Per quanto raro, il sistema potrebbe restituire un errore “forbidden” quando si inserisce lo script della Cookie Solution (o qualsiasi altro script) nel modulo Cookie Solution e si fa click su Salva.

Errore Forbidden di PrestaShop

Il problema è dovuto probabilmente alla proprietà ModSecurity di Apache attiva nel backend di PrestaShop. Ecco come disabilitare il modulo mod_security:

Shop Parameters > Traffic & Seo > Disable Apache ModSecurity Module > Yes

Se il problema dovesse persistere, ti invitiamo a chiedere al tuo fornitore di hosting di modificare le restrizioni del tuo sito web.

1.0.9

Tweak: Simple HTML Dom PHP class update to 1.9
Tweak: Code handled with official code validator

1.0.8

New: Introducing a way to skip specific script parsing
Fix: Improved handling of iubenda script HTML
Tweak: Support links update

1.0.7

Tweak: Adjust the iubenda PHP class handling
Tweak: Update iubenda logo

1.0.6

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

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

1.0.4

Fix: Invalid iubenda parser implementation

1.0.3

Tweak: Update and unify iubenda parsing engine

1.0.2

Fix: Eage output empty if script blocking disabled

1.0.1

Tweak: iubenda faster class regex update

1.0

Initial release

Leggi anche