Página de ayuda para CookieManager y FormManager

Cookie Manager

¿Cómo incorporo Cookie Manager a mi web?

Es tan sencillo como incluir esta línea a su página:

<script type="text/javascript" src="https://minervasf.es/cm/cm.js"></script>

Cookie Manager aparecerá con una configuración por defecto que puede ser cambiada posteriormente en la página concreta.

 

¿Como configuro Cookie Manager?

Cookie Manager se configura por medio de una variable de configuración, que puede residir en un archivo de Javascript separado o en la misma página web donde se visualiza. A continuación mostramos un ejemplo de configuración:

var cookiemanager_config = {
    "backcolor": "",
    "textcolor": "",
    "linkcolor": "",
    "selector_backcolor": "",
    "selector_textcolor": "",
    "selector_selected_backcolor": "",
    "selector_selected_textcolor": "",
    "button_backcolor": "",
    "button_textcolor": "",
    "button_selected_textcolor": "",
    "button_selected_backcolor": "",
    "config_backcolor": "",

    // bottomleft, bottomright, topleft, topright
    "config_position": "bottomleft",

    // si false, puede llamarse a través de un enlace si se desea
    "config_show": true, 

    "cookies":
        {
        "mandatory": ["ASP.NET_SessionId"],
        "functional": ["__tawkuuid", "TawkConnectionTime", "Tawk_59ee107f4854b82732ff7357"],
        "targeting": ["__utma", "__utmb", "__utmc", "__utmt", "__utmz"],
        "marketing": []
        },
    
    // functional, targeting, marketing
    "cookiemodes": "targeting" 
};

Configuración completa de Cookie Manager:

var cookiemanager_config: {
    // Color del fondo    
    "backcolor": string 
    
    // Color del texto
    "textcolor": string

    // Color de los enlaces
    "linkcolor": string 

    // Color de fondo de los selectores de tipos de cookies
    "selector_backcolor": string 

    // Color de texto de los selectores de tipos de cookies
    "selector_textcolor": string 

    // Color de fondo de los selectores de tipos de cookies (seleccionado)
    "selector_selected_backcolor": string

    // Color de texto de los selectores de tipos de cookies (seleccionado)
    "selector_selected_textcolor": string

    // Color de fondo del botón de aceptar cookies
    "button_backcolor": string

    // Color de texto del botón de aceptar cookies
    "button_textcolor": string

    // Color de fondo del botón de aceptar cookies (seleccionado)
    "button_selected_textcolor": string

    // Color de texto del botón de aceptar cookies (seleccionado)
    "button_selected_backcolor": string

    // Color de fondo del botón de configuración de cookies
    "config_backcolor": string

    // Posición del botón de configuración ("topleft", "topright", "bottomleft", "bottonright")
    "config_position": string

    // true -> visualiza el botón de configuración (por defecto); false -> oculta el botón de configuración (puede agregarse la llamada a un enlace como se describe en la documentación)
    "config_show": boolean 

    // Colecciones de cookies a procesar por Cookie Manager
    "cookies": 
        { 
        "mandatory": string[] // Cookies obligatorias
        "functional": string[] // Cookies funcionales (mapas, chat, etc...)
        "targeting": string[] // Cookies de localización y posicionamiento
        "marketing": string[] // Cookies de publicidad y marketing
        };

    // Modos autorizados para la web ("mandatory", "functional", "targeting", "marketing")
    "cookiemodes": string

    // Permite definir el modo por defecto aplicado si el usuario no indica otra cosa (cualquiera de los modos autorizados)
    "defaultMode": string

    // Texto que aparece en el cuerpo central de Cookie Manager 
    "cookie_text": string

    // Texto de título de Cookie Manager
    "cookie_title": string 

    // Texto del botón de aceptación de cookies
    "button_text": string

    // Enlace a la página de política de cookies de la web
    "cookies_link": string 

    // Texto que aparece en el selector de cookies obligatorias
    "selector_mandatory_label": string

    // Texto que aparece en el selector de cookies funcionales
    "selector_functional_label": string

    // Texto que aparece en el selector de cookies de localización 
    "selector_targeting_label": string 

    // Texto que aparece en el selector de cookies de marketing
    "selector_marketing_label": string 

    // Texto que aparece al pasar el ratón por encima del selector de cookies obligatorias
    "selector_mandatory_alt": string

    // Texto que aparece al pasar el ratón por encima del selector de cookies funcionales
    "selector_functional_alt": string

    // Texto que aparece al pasar el ratón por encima del selector de cookies de localización 
    "selector_targeting_alt": string 

    // Texto que aparece al pasar el ratón por encima del selector de cookies de marketing
    "selector_marketing_alt": string 
};

 

¿Necesito poner toda la configuración para que funcione?

De hecho no, ya que todos los atributos tienen valores por defecto. Puede probar a cargar Cookie Manager sin configuración y luego ir añadiendo parámetros a la configuración hasta ajustarlo a sus necesidades. El diseñador de la web puede ajustar todos los parámetros hasta dejarlo perfectamente ajustado a sus necesidades. Después puede replicar dicha configuración en el resto de la web por medio de archivos de script, ajustando valores como los textos para los distintos idiomas. Por defecto, Cookie Manager despliega sus textos en español.

 

¿Es posible ocultar el botón de cookies?

Sí, configurando el parámetro "config_show" a false.

 

¿Cómo puedo llamar a Cookie Manager desde un enlace?

Con una llamada a Javascript en la dirección del enlace:

<a href="javascript:cmShowWindow()">Enlace</a>

O desde otros elementos usando el evento onClick:

<button onclick="cmShowWindow()">Botón</button>
<img src="[ruta a imagen]" onclick="cmShowWindow()" />

 

¿Cookie Manager almacena cookies en el navegador del usuario?

No, su funcionamiento es totalmente transparente. No se usan cookies ni se envían ni reciben datos desde máquinas remotas.

 

¿Cómo controlo la ejecución de plugins externos?

Los complementos de terceros que insertamos en las webs generan cookies, lo que genera un problema de cara a la protección de datos. Los complementos a veces generan las cookies en su propio dominio y otras veces en el dominio del usuario. En la práctica, desde un script es imposible controla la creación de cookies por parte de otros complementos, sobre todo si dichas cookies son "Http Only", que son generadas para que no se puedan borrar por parte de terceros (suele ser así con las cookies de sesión, pero también se puede aplicar a otras, como hace Google en algunos casos). Así pues, debemos poder controlar la carga de complementos para evitar que dichos complementos puedan generar cookies no consentidas por los usuarios. Recordemos que los usuarios verán esas cookies al visitar nuestro sitio, por lo que si no las controlamos podemos estar incurriendo en problemas de protección de datos, y muchas veces no somos conscientes de que los complementos de terceros generan efectivamente dichas cookies.

Para controlar la ejecución de plugins y complementos externos, podemos hacerlo siguiendo las indicaciones que aportamos a continuación, permitiendo a Cookie Manager gestionar como y cuando se muestran los complementos y por tanto, se generan las cookies.

Scripts: Para controlar los scripts de la página que puedan provenir de agentes externos (como Google), podemos realizar las siguientes modificaciones para que Cookie Manager gestione su ejecución:

<script type="text/plain" data-cookie="marketing">
... Código del script ...
</script>

En este fragmento, hemos sustituido el atributo "type" del habitual "text/javascript" por "text/plain", para que no se ejecute inicialmente cuando se carga la página, y después hemos añadido el atributo categoría de consentimiento (en este caso "marketing"), para que el bloque de código sólo se cargue y ejecute cuando el nivel de consentimiento del usuario sea igual o inferior al indicado. Es decir, en este caso, el bloque de código sólo se ejecutará si el usuario permite las cookies de marketing.

Igualmente, si hacemos una llamada a un script externo, podemos usar las mismas modificaciones:

<script type="text/plain" data-cookie="functional" src="https://script.com/script.js"></script>

En este caso, el script se ejecutará sólo si el nivel de permiso es al menos "funcional" o superior.

Iframes, embed y object: se puede controlar la carga de iframes y complementos incrustados modificando algunos atributos de la etiqueta, como en el siguiente ejemplo:

<iframe data-src="pagina.html" data-cookie="targeting">...</iframe>

Si el nivel de consentimiento del usuario es "targeting" o superior, se podrá visualizar el iframe. El resto de atributos permanecen intactos.

<object data-src="[llamada a plugin flash]" data-cookie="marketing">...</object>

Igualmente, si queremos controla la carga de los plugins Flash, podemos hacerlo usando los mismos atributos.

Links: podemos así mismo controlar la llamada a elementos externos como hojas de estilos (que pueden ser ejecutados como llamadas a scripts y por tanto generar cookies sin nosotros saberlo) manipulando los atributos de la etiqueta <link>:

<link data-href="https://.../estilos.css" data-cookie="functional" ... />

Imágenes: por último, podemos controlar la carga de imágenes externas que pueden estar generándose por medio de scripts y por lo tanto crear cookies en los navegadores:

<img data-src="https://.../imagen.jpg" data-cookie="marketing" ... />

 

¿Es necesario tener que controlar los elementos externos?

Si se desea que el sitio funcione acorde a la legalidad vigente, sí. Los complementos externos generan cookies que pueden molestar a los usuarios. Precisamente uno de los objetivos de Cookie Manager es permitir a los usuarios de forma muy sencilla controlar lo que quieren ver y las cookies que generan los complementos de terceros. Controlar dichos complementos es esencial para que la gestión y el consentimiento de cookies sea realmente útil y efectivo.

 

¿Como controlo la carga de ejecución de la configuración si tengo una web con distintas secciones / idiomas?

Es más sencillo de lo que pueda parecer. Podemos insertar la configuración en archivos de scripting diferentes y cargarlos dinámicamente de forma condicional según necesidad. Por ejemplo, si cargamos la configuración para distintos idiomas, podemos generar archivos de scripts con la configuración de forma separada:

lang-es.js
lang-en.js
lang-fr.js
...

De esta manera, para distintos contextos de la web como los idiomas, podemos cargar un script diferente en cada caso, y personalizar la ejecución de Cookie Manager de forma sencilla.

 

Si subo Cookie Manager a la web me sale un error en pantalla...

Cookie Manager funciona bajo un sistema de licencia por reconocimiento del nombre de dominio. Si no ha contratado Cookie Manager bajo alguna de sus licencias aparecerá ese error. Puede probar libremente Cookie Manager bajo dominios "localhost" en ordenadores de prueba, para ver su funcionamiento y configurar la web a su gusto.

facebook Minerva Software Factory twitter Minerva Software Factory google plus Minerva Software Factory linkedin Minerva Software Factory blog Minerva Software Factory
Copyright (C) 2005- - C.E.O. Minerva, S.L.U. Todos los derechos reservados - Aviso Legal - Política de Privacidad