Iubenda logo
Genera tus documentos

Documentación

Tabla de contenidos

Cookie Solution: guía de instalación de la extensión de Magento

Este módulo te permite simplificar la configuración de la Cookie Solution, reduciendo drásticamente la necesidad de intervenciones directas en el código del sitio web.

Nuestra Cookie Solution te permite crear un banner de cookies totalmente personalizable, generar una política de cookies en línea con los servicios utilizados por tu web, almacenar pruebas de las preferencias de los usuarios y, obtener y administrar el consentimiento para el uso de cookies, incluido el bloqueo de los widgets más comunes y las cookies de terceros antes de recibir el consentimiento, para cumplir con el RGPD, la Directiva ePrivacy y la CCPA.

  • Nuestras extensiones están disponibles para Magento 1.9.x y 2.x, pero ten en cuenta que Magento 1.x dejó de ser compatible el 30 de junio de 2020. En cuanto a la versión 2.x, nuestra extensión es compatible con Magento Open Source (Magento Community Edition) y Magento Commerce (Magento Enterprise Edition y Magento Enterprise Cloud Edition).
  • Nuestras extensiones funcionan mejor con versiones de PHP 5.5 o posteriores.

Funcionalidad

  • Te permite bloquear, automática o manualmente, los scripts que pueden instalar cookies antes del consentimiento, sin necesidad de intervenir directamente en el código.
  • Te permite detectar geográficamente y limitar el bloqueo previo y las solicitudes de consentimiento de cookies solo a usuarios de la UE (ya que se trata de un requisito legal). En cambio, puedes ejecutar scripts de cookies normalmente en regiones donde tienes permiso legal para hacerlo.
  • Reactiva de forma asincrónica los scripts de cookies una vez que se obtiene el consentimiento.
  • Gestiona la visualización del banner de cookies y de la política de cookies, lo que te permite personalizar completamente el banner para que coincida con el aspecto y los colores de la marca de tu web si es necesario
  • Compatible con la Ley de Privacidad de los Consumidores de California (CCPA).
  • Guarda las preferencias del usuario sobre el uso de cookies y muestra una página limpia (sin el banner) a los usuarios que ya hayan proporcionado su consentimiento.
  • Se integra con el Marco de Transparencia y Consentimiento de IAB (TCF 2.0).
  • Te permite proporcionar a tus usuarios un control de preferencias granular por categoría (por ejemplo, funcionalidades básicas, mejora de la experiencia, segmentación y publicidad).
  • Compatible con las páginas móviles aceleradas (AMP) de Google.
  • Cuenta con una interfaz fácil de usar para añadir scripts personalizados e iframes.
  • Detecta bots/arañas y les proporciona una página limpia para que tus esfuerzos de SEO nunca se vean afectados.
  • 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

Instalación

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

  1. “Compra” nuestra extensión gratuita en el Magento Marketplace. Una vez hecho, aparecerá en tu página de compras.
  2. Conéctate a la consola del servidor mediante SSH.
  3. Instala nuestra extensión con el comando composer require iubenda/module-cookiesolution. Si necesitas una versión diferente a la última, añade el número de versión al comando, por ejemplo iubenda/module-cookiesolution:2.2.0
  4. Cuando se te solicite, usa la clave pública de Magento Marketplace para el inicio de sesión y la clave privada para la contraseña (ten en cuenta que te pedirán que compres la extensión para continuar con la instalación con composer).
  5. Una vez instalada la extensión, verifica el estado con el php bin/magento module:status
    comando.
  6. La extensión debe estar deshabilitada. Habilítala con php bin/magento module:enable Iubenda_CookieSolution y regístrate con php bin/magento setup:upgrade
  7. Si nuestra tienda está en modo de producción, compila la compilación con php bin/magento
    setup:di:compile
  8. Verifica si nuestra extensión está activa nuevamente con php bin/magento module:status. Si es así, limpia la caché con php bin/magento cache:clean

Instrucciones de desinstalación para versiones pre-marketplace

  1. Abre el archivo config.php ubicado en la carpeta “/app/etc/”, busca 'iubenda_cookiesolution' => 1, reemplaza 1 con 0 y guarda.
  2. Elimina la carpeta “/app/code/Iubenda/CookieSolution”.
  3. Si la caché está habilitada, tienes que limpiarla: dirígete a System > Cache Management, selecciona todos
    los tipos de caché y haz clic en Refresh.
  4. Abre el archivo config.php ubicado en la carpeta “/app/etc/”, elimina la línea
    'iubenda_cookiesolution' => 0 y guarda.
  • Inicia sesión en el panel de administración de Magento y dirígete a System > Magento Connect > Magento Connect Manager
  • Vuelve a introducir tus credenciales de administración de Magento
  • Selecciona la casilla Create Backup y selecciona el tipo de copia de seguridad.

Una vez que hayas creado una copia de seguridad, puedes cargar el paquete disponible aquí.

Una vez instalada la extensión, regresa al panel de administración de Magento y configura tu extensión de iubenda.

Configuración

Una vez que la instalación se haya completado con éxito, dirígete a Stores > Configuration > iubenda > iubenda Cookie Solution (aquí es donde puedes configurar nuestra extensión).

Copia y pega el código JavaScript de la Cookie Solution de tu cuenta de iubenda (como se explica en la guía de introducción), guarda y borra la memoria caché de la tienda.

Advertencia

No te olvides de guardar allí el código JavaScript válido para asegurarte de que la extensión funcione correctamente.

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

Nuestras extensiones de Magento bloquean automáticamente los scripts que se generan en el lado del servidor (por lo tanto, PHP los devuelve a Magento). Los scripts que se insertan en la página a través de JavaScript después de cargar la misma 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.

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

En el panel de administración, dirígete a Stores > Configuration > iubenda > iubenda Cookie Solution.

magento iubenda config menu

Desplázate para encontrar los campos Custom scripts y Custom iframes dentro de la sección titulada Custom.

iubenda cookie solution custom scripts fields

Inserta tus fuentes de script o iframe según sea necesario y haz clic en el botón Save Config en la parte superior de la página.

En el panel de administración, dirígete a System > Configuration. A continuación, haz clic en iubenda Cookie Solution a la izquierda en el menú en Servicios. iubenda cookie solution custom scripts interface

A continuación, solo tienes que desplazarte a la sección titulada Custom iubenda cookie solution custom scripts interface

Inserta tus fuentes de script o iframe según sea necesario y haz clic en el botón Save Config en la parte superior 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-->

Instala la extensión de la Cookie Solution

Magento 2.x Community/Enterprise/Cloud Edition

o

Magento 1.9.x

Más información