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.

Funzionalità

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

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:

• Clicca su Configure per visualizzare le impostazioni del plugin.

• Copia il codice della Cookie Solution, disponibile nella tua dashboard iubenda: (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: (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.

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

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

Ulteriori informazioni

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

Risoluzione dei problemi

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.

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.

Leggi anche

• Come integrare la privacy e cookie policy di iubenda con PrestaShop