Iubenda logo
Genera tus documentos

Documentación

Tabla de contenidos

Cookie Solution: Guía para la instalación del plugin de PrestaShop

El plugin de Prestashop de iubenda te permite automatizar la implementación de las normas de la Ley de Cookies, reduciendo drásticamente la necesidad de realizar intervenciones directas en el código del sitio en cuestión.

Advertencia
  • El módulo es actualmente compatible con todas las versiones de Prestashop, empezando por la versión 1.7
  • También debes tener las anulaciones activadas (habilitadas de forma predeterminada)
Cookie Solution de iubenda para PrestaShop

Funcionalidad

  • El plugin añade el código de iubenda automáticamente a todas las páginas de un sitio web (en la sección HEAD);
  • Gestiona la visualización del banner y de la política de cookies, así como el almacenamiento de las preferencias de consentimiento del usuario según la instalación de cookies;
  • Admite la asignación automática de categorías al bloquear los scripts;
  • Simplifica la gestión de la Cookie Solution de iubenda para sitios multilingües.
  • AdRoll
  • Widgets de AddThis
  • 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

Instrucciones

Instalación y activación

  • Inicia sesión y abre la sección de administración para acceder a tu dashboard principal de PrestaShop;
  • Haz clic en Modules > Modules & Services en el menú de la barra lateral;
  • Haz clic en Upload a module en la sección de encabezado;
  • Para instalar el módulo, sube el archivo zip (haz clic aquí para descargarlo). Debes señalar al archivo zip del módulo y no a su carpeta ni a ninguno de sus archivos descomprimidos.

Si la instalación ha salido bien, recibirás este mensaje:

Plugin de PrestaShop de iubenda

El módulo aparecerá en tu lista de módulos en “Modules & Services”.

Ahora es el momento de configurar los ajustes del módulo.

Cómo añadir el banner de cookies y modificar los ajustes

Ahora que el módulo está listo, necesitamos “alimentarlo” con la información necesaria de tu cuenta de iubenda.

  • Si no has hecho clic en el botón Configure dentro del mensaje de instalación del módulo, dirígete a la página de Modules & Services y encuentra el módulo de iubenda: Plugin de PrestaShop de iubenda
  • Haz clic en Configure para ir a los ajustes del módulo.
  • Añade el código de tu cuenta de iubenda a la extensión (así es como se ve el código de integración en tu dashboard de iubenda): Integra la Cookie Solution (Si todavía no has generado tu banner de cookies y tu código, puedes hacerlo aquí, o para obtener información más detallada, puedes consultar la guía de introducción a la Cookie Solution de iubenda.)
  • Pega el código en el formulario del plugin y haz clic en guardar: Plugin de PrestaShop de iubenda (Al ser PHP nativo, recomendamos la opción principal y más rápida para el motor de análisis. Si tienes problemas, prueba la alternativa basada en una clase DOM HTML personalizada)

Uso

Una vez configurado, el plugin comenzará a mostrar el banner con el enlace a tu política de cookies a los usuarios que visiten tu sitio web por primera vez, sin necesidad de realizar ninguna configuración adicional. El plugin también reconocerá, detectará y bloqueará automáticamente las cookies indicadas en la lista de bloqueo anterior que estén presentes en tu web.

Importante

Nuestra extensión de PrestaShop bloquea automáticamente los scripts que se generan en el lado del servidor (por lo tanto, los devuelve PHP por PrestaShop). Los scripts que se insertan en la página a través de JavaScript tras el proceso de carga de esa página no se bloquean ni se pueden bloquear automáticamente.

Estos scripts se pueden bloquear ingresando la fuente en el campo Custom Script en la consola del plugin o usando el método manual wrapping ilustrado en el siguiente ejemplo y (con más detalle) en esta guía de ayuda

Bloquear los scripts personalizados desde la consola

El campo Custom Scripts hace que sea más fácil bloquear los scripts insertados en la página directamente desde la consola del plugin. Esto reduce significativamente la necesidad de editar directamente el código del sitio web.

Así es como puedes hacerlo:

  • En el menú izquierdo de tu panel de administración, ve a la sección Improve y haz clic en Extensions > Plugins.
  • A continuación, busca “iubenda” y, cuando aparezca el plugin, haz clic en el botón Configure.
  • Desplázate hacia abajo para encontrar los campos Custom scripts y Custom iframes en la parte inferior de la página.Campos Custom scripts y Custom iframes de PrestaShop
  • Introduce las fuentes de tu script o iframe según lo que necesites y haz clic en el botón Save en la parte inferior derecha de la página.

Ejemplos

Usar estos campos es bastante sencillo. Simplemente, introduce el atributo src del script o iframe que te gustaría bloquear.

Script

Si quieres bloquear un botón social (que inserta scripts en la página a través de JavaScript), simplemente tienes que introducir la fuente del script, por ejemplo connect.socialwebsite.net/en_US/track.js, en el campo de scripts.

iframe

Digamos que quieres bloquear los scripts insertados en la página a través del iframe a continuación

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

Lo que tendrás que introducir en el campo iframe seríavideowebsite.com/embed/ya que esta es la fuente real de los scripts. Ten cuidado de NO ingresar el ID del componente (videowebsite.com/embed/xxFhMChxx) para asegurarte de que todos los scripts que provienen de la fuente real estén bloqueados.

Uso manual (método wrapping)

Este método requiere que modifiques directamente el código de tu web. Tendrás que ir a la sección correspondiente del código de tu web y añadir los scripts que se bloquearán, tal y como se explica a continuación.

Aquí tienes un ejemplo de cómo hacer que el plugin funcione manualmente para un botón social (que inserta scripts en la página a través de 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-->

Si hay elementos HTML / IMG / IFRAME, tendrás que hacerlo de esta manera:

<!--IUB-COOKIE-BLOCK-START-->
      <iframe src="...
      <img src="...
<!--IUB-COOKIE-BLOCK-END-->

Si has activado la función consentimiento por categoría tendrás que asignar un propósito. Volviendo al ejemplo del botón social, siendo parte del propósito “Mejora de la experiencia” (id 3):

<!--IUB-COOKIE-BLOCK-START-PURPOSE-3-->
<script>
    ...
</script>
<!--IUB-COOKIE-BLOCK-END-PURPOSE-3-->

Para detener el análisis/reemplazo automático de iframe/scripts que contienen un src definido:

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

Más información

Para llamadas de API y xmlrpc, sugerimos el parámetro ?iub_no_parse=1.

Error “Forbidden” de PrestaShop
Advertencia

Recuerda hacer una copia de seguridad de tu sitio web antes de intentar realizar cualquier tipo de arreglo.

En algunos casos excepcionales, puede que el sistema muestre un error “forbidden” cuando introduzcas el script de la Cookie Solution, o cualquier otro script, en el módulo de la Cookie Solution y pulses en “Save”.

Error forbidden de PrestaShop

Es probable que esto esté relacionado con una propiedad ModSecurity de Apache activada en el backend de PrestaShop. Para resolver este problema, tendrás que desactivar el módulo mod_security. Puedes hacerlo a través de este procedimiento:

Haz clic en Shop Parameters -> Haz clic en Traffic&Seo -> Encuentra el botón “Disable Apache ModSecurity Module” y establece el valor “Yes”.

Si por alguna razón esto no funciona, puede que tengas que ponerte en contacto con tu proveedor de alojamiento web con respecto a las restricciones de tu web en particular.

1.1.17

Integración con PageCache ultimate

1.1.16

Fix: Avoid overriding the purposes attribute if it was set

1.1.15

Fix: Purpose evaluation for iframes blocking
Fix: Block the custom scripts while parsing

1.1.14

Fix: Follow code standard to avoid conflict on overriding
Fix: Add per-purpose on inline script tags
Tweak: Add GA to per-purpose blocking support

1.1.13

Fix: Move FB connect to experience enhancement

1.1.12

Tweak: Add Google GPT to per-purpose blocking support
Fix: admin.js ready method deprecation

1.1.11

Fix: limit url sanitize to http protocols
Fix: AddThis per-purpose category

1.1.10

New: Per-purpose script blocking support
New: “Reject” button support

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

Más información