26 paquetes de idioma
Incluye alemán, inglés, francés, italiano, español,
neerlandés, polaco, turco, checo, sueco y
más. Detección automática mediante <html lang>.
Funciones
SimpleCMP se compone de cuatro componentes claramente separados: engine, recorder, cliente de service-DB y CMS-bridge. Usas solo lo que necesitas y sustituyes cada pieza por tu propia implementación cuando haga falta.
Engine
La engine conoce el estado de consentimiento por servicio, el bus de eventos, el almacenamiento en localStorage / cookie, la resolución de idioma y la lógica click-to-enable. Sin ninguna suposición sobre el DOM.
Si solo necesitas la máquina de estados — por ejemplo, para renderizar tu
propio banner en una SPA de Vue, React o Svelte —, importa directamente
desde simplecmp/engine. El bundle es bastante más pequeño
que el paquete completo con la UI de Lit.
// Vue 3 SFC
import { getManager, addEventListener }
from 'simplecmp/engine';
const manager = getManager({
storageName: 'simplecmp-app',
services: [...]
});
addEventListener('saveConsents',
(consents) => console.log(consents)
);
manager.updateConsent('ga', true);
manager.saveConsents();
Recorder
El recorder vigila tres fuentes a la vez: la creación de
cookies mediante document.cookie, la inserción de
etiquetas <script>, <iframe>,
<img> y <link>
(MutationObserver) y las conexiones salientes a través de la
API PerformanceObserver.
Una única llamada a startRecorder() en el punto de inicialización de tu app.
Cada nuevo tracker se clasifica automáticamente (local + consulta a la service-DB).
recorder.exportConfig() devuelve una configuración de servicios lista para producción.
assertNoUnknown() hace fallar el build si aparece un tracker que no está en el catálogo.
$ pnpm dev
[recorder] watching cookies, scripts, requests…
[recorder] known: _ga (Google Analytics)
[recorder] known: _gid (Google Analytics)
[recorder] UNKNOWN: _fbp .example.com
[recorder] UNKNOWN: req connect.facebook.net
[recorder] classified via service-db: meta-pixel
[recorder] ✓ no unclassified detections
// recorder.exportConfig() →
{
services: [
{ name: 'google-analytics', cookies: [/^_ga/, '_gid'] },
{ name: 'meta-pixel', cookies: ['_fbp'], hosts: ['connect.facebook.net'] }
]
}
Service-DB
La service-DB habla un protocolo HTTP/JSON sencillo. El cliente consulta cada identificador desconocido (cookie, host, URL de script) y recibe, si lo conoce, la clasificación: nombre del servicio, etiquetas de finalidad, textos estándar en 26 idiomas y política de privacidad por defecto.
El caché stale-while-revalidate mantiene la UX rápida; un clasificador local de respaldo entra en juego si hay errores de red. Los plugins de CMS (como la extensión de TYPO3) incluyen su propia implementación del protocolo, de modo que las clasificaciones se pueden curar incluso sin dependencias externas.
// GET https://library.simplecmp.eu/v1/lookup
// ?kind=cookie&identifier=_ga
{
"hit": true,
"service": {
"name": "google-analytics",
"title": "Google Analytics",
"purposes": ["analytics"],
"cookies": ["/^_ga/", "_gid"],
"hosts": [
"www.google-analytics.com",
"analytics.google.com"
],
"privacyPolicy":
"https://policies.google.com/privacy",
"translations": { /* 26 idiomas */ }
},
"cache_until": "2026-05-26T00:00:00Z"
}
CMS-Bridge
Un test A/B activa Hotjar. Un píxel de marketing aterriza en la landing page vía tag manager. Un plugin antiguo empieza de repente a establecer una cookie nueva. La CMS-bridge te avisa de cada uno de estos drifts.
Region-Engine
El RGPD (DSGVO) exige opt-in. La CCPA/CPRA exige opt-out más un enlace «Do Not Sell or Share My Personal Information». SimpleCMP detecta la región del visitante y cambia automáticamente entre ambos regímenes: sin código a medida y sin API de geolocalización por IP.
resolveRegime (p. ej. DE → optIn,
US-CA → optOut)region,
regimeDefault, regimes para UIs propias// La región se determina automáticamente
init({
region: 'auto', // 'DE' | 'US-CA' | …
regimes: {
optIn: { services: [...] },
optOut: { services: [...] }
}
});
// API pública para UI propia:
manager.region; // 'US-CA'
manager.regimeDefault; // 'optOut'
// El banner CCPA muestra automáticamente:
"Do Not Sell or Share
My Personal Information"
Audit-Engine
Añade ?simplecmp_audit=1 a tu URL y SimpleCMP
se ejecuta en vivo en modo cumplimiento: un panel lista cada incumplimiento
del §4 del documento de cumplimiento legal
con su severidad, selector e indicación de cómo corregirlo.
Las comprobaciones no se limitan a la configuración estática:
auditDom() lee el banner renderizado y avisa de
botones de rechazo débiles, mensajes de presión comercial, nombres accesibles
ausentes y objetivos de menos de 44 px. Es la engine con la que probamos
nuestro propio banner, y forma parte del bundle.
$ open https://example.com/?simplecmp_audit=1
[audit] AUDIT-MODE aktiviert
[audit] critical equal-button-styling
Decline-Button hat geringeren Kontrast als Accept
selector: button.cn-decline
[audit] warning weak-decline-copy
"Ablehnen"-Text zu schwach (heuristisch erkannt)
[audit] warning marketing-nudge
Description enthält Werbe-Sprache
[audit] warning accessible-name-missing
Floating-Trigger ohne aria-label
[audit] ok imprint-link-present
[audit] ok reject-all-equal-prominence
[audit] ok target-size-44px
Más funciones
Incluye alemán, inglés, francés, italiano, español,
neerlandés, polaco, turco, checo, sueco y
más. Detección automática mediante <html lang>.
Los embeds bloqueados de YouTube, Vimeo o Maps reciben automáticamente un aviso inline con el tema del sitio. La concesión se hace por servicio, sin que vuelva a aparecer todo el modal.
Bloqueo universal mediante los marcadores data-name y data-src.
Los scripts e iframes ni siquiera se cargan antes de que
haya consentimiento: sin riesgo de race conditions.
«Rechazar todo» tiene el mismo peso que «Aceptar todo»: es el valor por defecto, no un opt-in (sentencia Cookie II del BGH, DSK 2022). El enlace al Impressum va separado de la política de privacidad.
Custom Elements (<simplecmp-banner>,
<simplecmp-modal>) con Shadow DOM. Opcionalmente
Light DOM para ajustes de CSS en profundidad.
Respeta Sec-GPC (Global Privacy Control) y la
señal de cabecera DNT. Comportamiento configurable: rechazo
automático, ocultar el banner o confirmación explícita.
CSS listo para usar con Bootstrap 5, Tailwind v4, Bulma y Pico. Remapeos basados en tokens sobre las variables de cada framework, sin líos de overrides.
Señales conscientes del proveedor al inicializar y en cada guardado:
gtag('consent', …) para Google (GA4/GTM),
fbq('consent', …) para Meta Pixel y
uetq.push('consent', …) para Microsoft UET, además de
su aportación a la política CSP. Para Google Tag Manager, el evento de
dataLayer lleva el estado por servicio y por finalidad:
exactamente una actualización por cada decisión guardada.
Opt-in opcional (universalBlocking.blockStylesheets):
los <link rel="stylesheet"> de terceros como
Google Fonts se bloquean antes del consentimiento con
block-and-reinject. Una mitigación para el caso del LG München I.
Posicionamiento basado en tokens: las cuatro esquinas, barra inferior o modal centrado; basta un valor de configuración. El equal-button-styling viene integrado en la plantilla (si no, la comprobación de cumplimiento se pondría en rojo).
Paquete de tono por idioma: en cada locale, un
informal.json puede sobrescribir las cadenas formales.
Ya disponibles DE, FR, IT, ES y NL. Las webs de marketing consiguen un
«¿Permitir cookies?» sin tener que forkear el paquete incluido.
Landmark de región, aria-live, focus trap, tamaño de objetivo
de 44×44 px y anillos de foco visibles con teclado. Probado en vivo
con lector de pantalla en una tienda de desarrollo de Shopify. Relevante
para el BFSG (ley alemana de accesibilidad) en e-commerce desde 06/2025.
Divulgación por capas en tres pasos conforme al RGPD: banner → aviso contextual → «Más información ›» abre un modal con la entidad legal, la dirección, la URL de privacidad, la URL de opt-out y la base de la transferencia, todo extraído de la service-library.
Las cookies se comparan no solo por nombre, sino también por el host que las establece. Importante cuando varios servicios usan el mismo nombre de cookie (ver ADR-0010).
Quien retira un consentimiento también se lleva por delante los datos: las cookies
se borran en el dominio propio y en el dominio padre,
y las entradas correspondientes de localStorage también.
Dos servicios pueden compartir un mismo host, como Google Maps y
reCAPTCHA en www.google.com. Los matchers con ruta
asignan cada petición al servicio correcto y se tienen en cuenta
los comodines en sameOriginHosts.
La demo interactiva muestra el banner, el modal y el recorder juntos, sin instalar nada.