Plugin de Consentimiento de Cookies Orestbida

El Plugin de Consentimiento de Cookies Orestbida es una extensión para Grav CMS que te permite gestionar las cookies en tu sitio web utilizando la popular biblioteca JavaScript Cookie Consent de Orestbida. Este plugin proporciona un banner de consentimiento de cookies personalizable y compatible con el GDPR, permitiendo a los usuarios aceptar o rechazar las cookies según sus preferencias.

Instalación

La instalación del plugin de Consentimiento de Cookies Orestbida se puede realizar de tres maneras: utilizando el Gestor de Paquetes de Grav (GPM), instalación manual o a través del Plugin de Administración.

Instalación mediante GPM (Preferida)

Para instalar el plugin a través del Gestor de Paquetes de Grav (GPM), navega hasta la raíz de tu instalación de Grav usando tu terminal y ejecuta el siguiente comando:

bin/gpm install orestbida-cookie-consent

Esto instalará el plugin en el directorio /user/plugins de tu instalación de Grav. Los archivos del plugin se ubicarán en:

/your/site/grav/user/plugins/orestbida-cookie-consent

Instalación Manual

Para instalar el plugin manualmente, sigue estos pasos:

1. Descarga la última versión del plugin desde GitHub.
2. Extrae el archivo zip en el directorio /user/plugins de tu instalación de Grav.
3. Renombra la carpeta extraída a orestbida-cookie-consent.

Los archivos del plugin deberían estar ahora en:

/your/site/grav/user/plugins/orestbida-cookie-consent

Instalación mediante el Plugin de Administración

Si estás utilizando el Plugin de Administración de Grav, puedes instalar el plugin de Consentimiento de Cookies Orestbida directamente desde el Panel de Administración:

1. Navega a la sección Plugins en el Panel de Administración.
2. Haz clic en el botón Add.
3. Busca Orestbida Cookie Consent y haz clic en Install.

Configuración

Antes de configurar el plugin, debes copiar el archivo de configuración predeterminado desde:

user/plugins/orestbida-cookie-consent/orestbida-cookie-consent.yaml

a:

user/config/plugins/orestbida-cookie-consent.yaml

Luego, edita el archivo copiado para personalizar los ajustes del plugin. Si estás utilizando el Plugin de Administración, el archivo de configuración se creará automáticamente y se guardará en la carpeta user/config/plugins/ cuando guardes los ajustes.

Configuración Predeterminada

Aquí está la configuración predeterminada con explicaciones para cada opción:

enabled: true                  # Activar o desactivar el plugin.
cdn: true                      # Usar la CDN para cargar la biblioteca de Cookie Consent.
theme: default                 # Elegir un tema para el banner de cookies (opciones: default, light-funky, dark-turquoise, elegant).

# Ajustes del Modal de Consentimiento
consent_layout: block          # Diseño del modal de consentimiento (opciones: box, box_inline, box_wide, cloud, cloud_inline, bar, bar_inline).
consent_position: bottom_right # Posición del modal de consentimiento (opciones: top_center, top_left, top_right, bottom_center, bottom_left, bottom_right, middle_center, middle_left, middle_right).
consent_title: "¡Usamos cookies!" # Título del modal de consentimiento.
consent_description: "Este sitio web utiliza cookies para garantizar que obtengas la mejor experiencia en nuestro sitio web." # Descripción en el modal de consentimiento.
consent_acceptAllBtn: "Aceptar todas" # Texto para el botón "Aceptar todas".
consent_acceptNecessaryBtn: "Rechazar todas" # Texto para el botón "Rechazar todas".
consent_showPreferencesBtn: "Gestionar preferencias" # Texto para el botón "Gestionar Preferencias".
consent_footer: ""             # Texto de pie de página para el modal de consentimiento (soporta Markdown).

# Ajustes del Modal de Preferencias
preferences_layout: box        # Diseño del modal de preferencias (opciones: box, bar, bar_wide).
preferences_position: left     # Posición del modal de preferencias (opciones: left, right).
preferences_title: "Preferencias de Cookies" # Título del modal de preferencias.
preferences_acceptAllBtn: "Aceptar todas" # Texto para el botón "Aceptar todas" en el modal de preferencias.
preferences_acceptNecessaryBtn: "Rechazar todas" # Texto para el botón "Rechazar todas" en el modal de preferencias.
preferences_savePreferencesBtn: "Guardar preferencias" # Texto para el botón "Guardar Preferencias".

# Categorías de Cookies
categories:
  necessary: true              # Activar la categoría "Necesarias" (siempre activa y no se puede desactivar).
  functionality: false         # Activar la categoría "Funcionalidad".
  analytics: false             # Activar la categoría "Analíticas".
  marketing: false             # Activar la categoría "Marketing".

# Contenido de las Secciones
cookies_sections:
  usage:
    title: "Uso"               # Título para la sección "Uso".
    description: "Este sitio web utiliza cookies para garantizar que obtengas la mejor experiencia." # Descripción para la sección "Uso".
  necessary:
    title: "Cookies Necesarias" # Título para la sección "Cookies Necesarias".
    description: "Estas cookies son esenciales para que el sitio web funcione correctamente." # Descripción para la sección "Cookies Necesarias".
  functionality:
    title: "Cookies de Funcionalidad" # Título para la sección "Cookies de Funcionalidad".
    description: "Estas cookies permiten funcionalidades adicionales como recordar preferencias." # Descripción para la sección "Cookies de Funcionalidad".
  analytics:
    title: "Cookies Analíticas" # Título para la sección "Cookies Analíticas".
    description: "Estas cookies nos ayudan a analizar cómo los visitantes usan el sitio web." # Descripción para la sección "Cookies Analíticas".
  marketing:
    title: "Cookies de Marketing" # Título para la sección "Cookies de Marketing".
    description: "Estas cookies se utilizan para ofrecer anuncios personalizados." # Descripción para la sección "Cookies de Marketing".
  more_info:
    title: "Más Información"   # Título para la sección "Más Información".
    description: "Para más detalles sobre nuestra política de cookies, por favor visita nuestra [Política de Privacidad](#)." # Descripción para la sección "Más Información".

Uso

Una vez que el plugin esté instalado y configurado, el banner de consentimiento de cookies aparecerá automáticamente en tu sitio web. Los usuarios pueden interactuar con el banner para aceptar o rechazar las cookies según sus preferencias. El plugin soporta múltiples categorías de cookies, permitiéndote ofrecer un control granular sobre el uso de las cookies.

Personalización del Banner

Puedes personalizar la apariencia y el comportamiento del banner de consentimiento de cookies modificando las opciones de configuración en el archivo orestbida-cookie-consent.yaml. Por ejemplo:

• Cambia el tema para que coincida con el diseño de tu sitio web.
• Ajusta el diseño y la posición del modal de consentimiento.
• Personaliza el texto de los botones, títulos y descripciones.

Añadir CSS Personalizado

Si necesitas una personalización adicional, puedes añadir tus propios estilos CSS sobrescribiendo los estilos predeterminados del plugin. Coloca tu CSS personalizado en un archivo e inclúyelo en tu tema de Grav.