ES 
EN
Diseño y desarrollo Joomla!
© 2026
CO
Eventos y API
Visitas: 24
Integre otras funciones con el estado del consentimiento
Alamarte Cookie Consent Pro dispone de eventos JavaScript y una API pública que permiten a desarrolladores, extensiones y scripts consultar el consentimiento actual, reaccionar cuando cambia y abrir o restablecer las preferencias desde código personalizado.
Esta sección está destinada principalmente a integraciones técnicas.
No necesita utilizar la API ni los eventos para el funcionamiento normal de Alamarte Cookie Consent Pro. Estas funciones son útiles cuando otro script o extensión necesita conocer o reaccionar al estado del consentimiento.
Eventos JavaScript
Alamarte Cookie Consent Pro emite el evento:
alamarteCookieConsentEl evento se emite sobre document y puede escucharse mediante JavaScript estándar.
API pública
La API está disponible mediante el objeto global:
window.AlamarteCookieConsentDesde este objeto puede consultar el consentimiento, comprobar una categoría, abrir las preferencias o restablecer la decisión guardada.
Escuchar los eventos de consentimiento
Utilice document.addEventListener() para recibir los eventos emitidos por Alamarte Cookie Consent Pro:
document.addEventListener('alamarteCookieConsent', function (event) {
console.log(event.detail);
});La información del evento se encuentra en event.detail.
Información disponible en event.detail
Cada evento proporciona una estructura con la siguiente información:
{
type,
consent,
previousConsent,
changes,
source
}type: indica qué tipo de evento se ha producido.consent: contiene el estado actual del consentimiento.previousConsent: contiene el estado anterior cuando corresponde.changes: informa sobre las categorías concedidas o revocadas.source: identifica el origen del cambio.
Tipos de evento disponibles
El valor de event.detail.type puede ser uno de los siguientes:
ready
loaded
accepted
rejected
custom
resetEstos valores permiten identificar en qué momento se encuentra el sistema o qué acción ha realizado el visitante.
ready y loaded
Estos eventos permiten detectar la inicialización y carga del sistema de consentimiento.
En estos eventos, las listas de categorías concedidas y revocadas dentro de changes están vacías.
accepted
Se utiliza cuando se registra una aceptación del consentimiento.
Una integración externa puede consultar el nuevo estado y actuar únicamente sobre las categorías que necesite.
rejected
Permite detectar una acción de rechazo y consultar el estado resultante del consentimiento.
custom
Se utiliza cuando el visitante guarda una selección personalizada de categorías.
Esto permite conocer qué permisos han cambiado sin asumir que todas las categorías tienen el mismo estado.
reset
Permite detectar que el consentimiento guardado ha sido restablecido.
Las integraciones que dependan del consentimiento pueden utilizar este evento para volver a comprobar su estado antes de realizar nuevas acciones.
Categorías concedidas y revocadas
En los eventos relacionados con una elección o con el restablecimiento del consentimiento, changes permite consultar qué categorías han cambiado:
event.detail.changes.granted
event.detail.changes.revokedEsto resulta útil cuando una integración necesita reaccionar solamente a los permisos que realmente han cambiado.
API pública disponible
Alamarte Cookie Consent Pro expone los siguientes métodos:
window.AlamarteCookieConsent.getConsent()
window.AlamarteCookieConsent.hasConsent('analytics')
window.AlamarteCookieConsent.openPreferences()
window.AlamarteCookieConsent.resetConsent()getConsent()
Permite obtener el estado actual del consentimiento desde JavaScript.
const consent =
window.AlamarteCookieConsent.getConsent();hasConsent()
Permite comprobar si una categoría determinada dispone de consentimiento.
Por ejemplo, para consultar la categoría Analíticas:
window.AlamarteCookieConsent.hasConsent('analytics')openPreferences()
Permite abrir desde JavaScript la interfaz de preferencias del consentimiento.
window.AlamarteCookieConsent.openPreferences();Puede utilizarse, por ejemplo, desde un control personalizado creado por el sitio.
resetConsent()
Permite restablecer mediante JavaScript el consentimiento gestionado por Alamarte Cookie Consent Pro.
window.AlamarteCookieConsent.resetConsent();Ejemplo: comprobar una categoría después de un cambio
Una integración puede escuchar el evento y comprobar después si dispone del consentimiento necesario:
document.addEventListener('alamarteCookieConsent', function (event) {
if (
window.AlamarteCookieConsent.hasConsent('analytics')
) {
console.log('Analíticas autorizadas');
} else {
console.log('Analíticas no autorizadas');
}
});Sustituya las acciones de ejemplo por la lógica concreta de la integración que esté desarrollando.
Importante: una integración externa que requiera consentimiento debe permanecer inactiva hasta que la categoría necesaria haya sido concedida. La cookie, la API y los eventos proporcionan información técnica sobre el estado del consentimiento, pero por sí solos no constituyen una prueba legal del consentimiento.
© 2026 Alamarte Ingeniería
Diseño y desarrollo Joomla!
CO
