Ver toda la documentación

Stella Cookies: Guía de Usuario Completa

Stella Cookies: Consentimiento de Cookies Premium para WordPress

Bienvenido a la guía oficial de Stella Cookies. Aquí encontrarás todo sobre las funciones y ajustes en las versiones Free y Pro.


1. Instalación y Configuración

Instalación de la versión gratuita (Free)

  1. Inicia sesión en tu panel de administración de WordPress.
  2. Ve a Plugins > Añadir nuevo.
  3. Busca "Stella Cookies".
  4. Haz clic en Instalar ahora y luego en Activar.

Instalación de la versión Pro

Importante: La versión gratuita debe permanecer activa. El plugin Pro funciona como un complemento.

  1. Compra una licencia y descarga el archivo stella-cookies-pro.zip.
  2. Ve a Plugins > Añadir nuevo > Subir plugin.
  3. Selecciona el archivo zip, haz clic en Instalar ahora y Activar.
  4. Ve a Stella Cookies > Licencia para introducir tu clave.

2. Pestaña Ajustes Generales

Esta pestaña contiene los controles de comportamiento básicos para tu banner de cookies.

Ajustes Básicos

  • Activar banner de cookies (Enable Cookie Banner): Activa esta opción para mostrar el banner en tu sitio web.
  • Borrar cookies al rechazar (Clear Cookies on Decline): Cuando está activado, si un usuario hace clic en "Rechazar", el plugin intentará eliminar cualquier cookie no esencial almacenada en su navegador.
  • Activar bloqueo de iframes (Enable Iframe Blocking): Bloquea automáticamente iframes externos (como videos de YouTube o Vimeo) y muestra una solicitud de consentimiento hasta que el usuario acepte las cookies de marketing.
  • Versión de consentimiento (Consent Version): Un valor numérico (ej. 1.0). Si actualizas tu política de privacidad o añades nuevos rastreadores, cambia este número. Obligará a todos los visitantes recurrentes a dar su consentimiento de nuevo.
  • Bloquear scripts (Block Scripts - Keywords): Introduce palabras clave (separadas por comas) que se encuentren en los scripts que deseas bloquear antes del consentimiento (ej. analytics.js, fbevents.js, gtag). Ningún script con estas palabras se cargará hasta que se otorgue el consentimiento.

Declaración de Cookies y Política

  • Contenido de la página de política (Policy Page Content): Añade un texto introductorio que aparecerá encima de tu tabla de cookies cuando uses el shortcode.
  • Lista de cookies (Cookie List): Una tabla de entrada manual donde puedes definir exactamente qué cookies usa tu sitio, su duración, categoría y propósito.
  • Mostrar lista de cookies en la página de política: Alterna si la tabla se renderiza o no cuando se usa el shortcode.

Funciones de Cumplimiento Pro

  • Activar CCPA (No vender) [PRO]: Añade un enlace específico de "No vender mi información personal" (Do Not Sell) al banner para el cumplimiento en California.
  • Mostrar banner solo en UE/EEE [PRO]: Activa la segmentación geográfica. Los visitantes de fuera de Europa no verán el banner.
  • Sincronizar con GTM DataLayer [PRO]: Envía eventos de consentimiento a window.dataLayer para que puedas activar etiquetas en Google Tag Manager según las elecciones del usuario.
  • Detectar Global Privacy Control (GPC) [PRO]: Detecta automáticamente la señal GPC de navegadores como Brave o DuckDuckGo y rechaza automáticamente las cookies de marketing.
  • Activar análisis de consentimiento (Enable Consent Analytics) [PRO]: Activa la pestaña del panel de Análisis.

Gestión de Datos

  • Eliminar datos al desinstalar: Si está marcado, todos los datos del plugin gratuito se borrarán al eliminarlo.
  • Eliminar datos Pro al desinstalar [PRO]: Si está marcado, todos los datos de la versión Pro (incluidos los registros de consentimiento) se borrarán al desinstalar.

3. Pestaña Diseño y Contenido

Esta pestaña controla exactamente cómo se ve y qué dice tu banner. Incluye una Vista Previa en Vivo en tiempo real.

Apariencia y Diseño

  • Tema (Theme): Elige entre los ajustes preestablecidos Claro (Light), Oscuro (Dark), Aurora y Eco.
  • Posicionamiento: Elige dónde se ancla el banner: Inferior (Bottom), Superior (Top) o Integrado (Inline).
  • Ancho máximo del banner (px) [PRO]: Restringe el ancho del banner en pantallas de escritorio grandes.
  • Fuente (Font Family) [PRO]: Elige entre 10 fuentes premium de Google (ej. Inter, Poppins) que se cargan localmente para no afectar el rendimiento.
  • Colores: Controles completos de color hexadecimal para Fondo, Texto, Botón primario, Botón secundario y Enlaces.
  • Activar logotipo del banner [PRO]: Muestra el logotipo de tu marca. Incluye un campo de URL y opciones de posición.
  • CSS personalizado avanzado [PRO]: Inyecta reglas CSS directamente en el banner.

Contenido y Textos

  • Descripción del banner: El texto principal que se muestra a los usuarios cuando llegan.
  • URL de la Política de Privacidad: El enlace a la página de privacidad de tu sitio.
  • Textos de los botones: Personaliza las etiquetas para los botones "Aceptar todo", "Rechazar todo" y "Administrar preferencias".

Configuración del Administrador de Preferencias

Controla la ventana emergente secundaria donde los usuarios pueden elegir categorías de cookies de forma granular.

  • Activar administrador de preferencias: Alterna la existencia del botón "Administrar".
  • Activar "Aceptar necesarias": Añade un botón para aceptar solo las cookies esenciales.
  • Categoría Necesarias: Personaliza el título, la etiqueta y la descripción de las cookies esenciales (los usuarios no pueden desactivarlas).
  • Opción de Estadísticas: Alterna la visibilidad y personaliza el título y la descripción para las cookies de análisis.
  • Opción de Marketing: Alterna la visibilidad y personaliza el título y la descripción para las cookies de publicidad/seguimiento.

4. Pestaña Escáner [PRO]

Automatiza el descubrimiento y la categorización de cookies en tu sitio web.

Controles de Escaneo

  • Escaneo manual: Haz clic en este botón para enviar inmediatamente un bot que rastree tu sitio web en busca de cookies ocultas.
  • Escaneo automático programado: Elige ejecutar escaneos automáticamente de forma Diaria o Semanal.
  • Comportamiento del escaneo programado: Elige "Auto-aplicar" (Auto-apply) para publicar instantáneamente nuevas cookies, o "Revisar primero" (Review first) para dejarlas pendientes de aprobación.

Configuración del Escáner

  • Tiempo de espera de solicitud: Establece cuánto tiempo espera el escáner por página (el valor predeterminado suele ser de 10 a 30 segundos).
  • Rutas de inclusión (Include Paths): Obliga al escáner a revisar subdirectorios específicos.
  • Rutas de exclusión (Exclude Paths): Evita que el escáner rastree áreas sensibles (ej. /checkout/).
  • URLs adicionales: Obliga al escáner a revisar URLs externas o específicas.

Notificaciones y Resultados

  • Alerta por correo electrónico para nuevas cookies: Alterna las notificaciones por correo cuando un escaneo automático descubre cookies sin clasificar.
  • Correo de notificación: Especifica a dónde se deben enviar las alertas.
  • Resultados de escaneo en etapa de prueba (Staged): Una tabla que muestra las cookies recién descubiertas que esperan tu aprobación.
  • Historial de escaneo: Un registro de cada vez que se ejecutó el escáner y cuántas cookies se encontraron.

5. Pestaña Análisis [PRO]

Visualiza cómo interactúan los usuarios con tu banner de privacidad.

  • Panel de métricas de consentimiento: Muestra gráficos en tiempo real con tu Tasa de aceptación frente a la Tasa de rechazo.
  • Información granular: Observa exactamente cuántos usuarios aceptaron "Marketing" frente a "Estadísticas".

6. Pestaña Registros de Consentimiento [PRO]

Mantén una prueba criptográfica del consentimiento del usuario para auditorías legales.

  • Retención de registros de consentimiento (días): Define cuántos días deben conservarse los registros antes de eliminarse automáticamente.
  • Tabla de registros: Muestra la Fecha, la Acción del usuario (ej. "Aceptó todo") y una dirección IP anonimizada.
  • Anonimización automática de IP: Las direcciones IP se codifican mediante cifrado HMAC para proteger la privacidad.
  • Exportar a CSV: Descarga instantáneamente todo tu registro de consentimientos para informes legales.

7. Pestaña Licencia [PRO]

Administra tu suscripción a Stella Cookies Pro.

  • Clave de licencia: Pega tu clave de compra aquí.
  • Activar/Desactivar licencia: Valida tu clave para habilitar las funciones Pro y las actualizaciones automáticas.

8. Integraciones y Shortcodes

Shortcode de Política de Privacidad

Pega el siguiente shortcode en tu página de Política de Privacidad o Política de Cookies:

[stella_cookies_policy]

Este shortcode mostrará:

  1. Tu "Contenido de la página de política" personalizado.
  2. Un botón que permite a los usuarios reabrir el Administrador de preferencias para "Revocar o editar consentimiento".
  3. Tu tabla dinámica de declaración de cookies.

9. Solución de problemas

¡Los scripts siguen cargando antes de dar el consentimiento!

  • Ve a Ajustes Generales > Bloquear scripts (Keywords).
  • Asegúrate de que tu palabra clave sea exacta. Si tu script es https://www.googletagmanager.com/gtag/js, usa gtag.
  • Borra la caché de tu sitio. El bloqueo de scripts depende del almacenamiento en búfer de salida; las páginas en caché pueden eludir el bloqueo.

El banner se ve mal en dispositivos móviles.

  • Asegúrate de no haber establecido un "Ancho máximo del banner" masivo ni haber inyectado CSS incorrecto en el campo CSS personalizado avanzado.

El escáner no encuentra ninguna cookie.

  • Asegúrate de que tu servidor no esté bloqueando solicitudes de bucle invertido ("loopback") (a menudo causado por firewalls estrictos o el modo Bot Fight de Cloudflare).
  • Aumenta el Tiempo de espera de solicitud en los ajustes del Escáner.