Funktioner

Alt, hvad du har brug for — og intet ud over det.

SimpleCMP består af fire klart adskilte komponenter: Engine, Recorder, Service-DB-client, CMS-bridge. Du bruger kun det, du har brug for — og erstatter hver del med din egen implementering, når det er nødvendigt.

Engine

UI-fri tilstandsmaskine.

Engine'en kender consent-tilstanden pr. service, event-bussen, lagringen i localStorage / cookie, sprogopløsningen og click-to-enable-logikken. Helt uden antagelser om DOM.

Har du kun brug for tilstandsmaskinen — f.eks. for at rendere dit eget banner i en Vue-, React- eller Svelte-SPA — importerer du direkte fra simplecmp/engine. Bundlet er markant mindre end fuldpakken med Lit-UI.

// 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

Auto-detektion i stedet for manuel katalogisering.

Recorderen overvåger tre kilder samtidig: sætning af cookies via document.cookie, indsættelse af <script>-, <iframe>-, <img>- og <link>-tags (MutationObserver) og udgående forbindelser via PerformanceObserver-API'et.

  1. Aktivér i dev-buildet

    Et enkelt kald til startRecorder() ved init-punktet i din app.

  2. Klik dig gennem sitet som normalt

    Hver ny tracker klassificeres automatisk (lokalt + service-DB-opslag).

  3. Eksportér config

    recorder.exportConfig() leverer en færdig service-konfiguration til produktion.

  4. Sikr CI'en

    assertNoUnknown() får buildet til at fejle, hvis der dukker en ikke-katalogiseret tracker op.

$ 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

Et åbent register — ingen vendor lock-in.

Service-DB'en taler en simpel HTTP/JSON-protokol. Klienten forespørger for hver ukendt identifier (cookie, host, script-URL) og modtager — hvis den er kendt — klassifikationen: servicenavn, purpose-tags, standardtekster på 26 sprog, default-privacy-policy.

Stale-while-revalidate-caching holder UX'en hurtig; et lokalt klassifikator-fallback træder i kraft ved netværksfejl. CMS-plugins (som TYPO3-extensionen) bringer deres egen implementering af protokollen, så klassifikationer kan kurateres uden ekstern afhængighed.

360+ services PHP+SQLite-reference Community-PRs
// 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 langs */ }
  },
  "cache_until": "2026-05-26T00:00:00Z"
}

CMS-Bridge

Opdag production-drift, før det bliver dyrt.

En A/B-test slår Hotjar til. En marketing-pixel lander på landingpagen via tag-manageren. Et gammelt plugin sætter pludselig en ny cookie. CMS-bridgen rapporterer hver eneste af disse drifts.

  • Schema v2: batchade detections, status-felt, bandwidth-controls
  • HMAC-nonce-auth forhindrer replay-angreb
  • Per-identifier dedup med konfigurerbar TTL (default 1 t)
  • Sampling-rate kan indstilles, hvis trafikken er enorm
  • Webhook-receiver som Node-eksempel i repoet
Browser Recorder erkennt unbekannten Tracker POST /webhook HMAC-signed CMS verifies signature deduplicates DB detections table status: unknown Backend-Modul Redakteur reviewt kategorisiert approve → Service-Library

Region-Engine

EU opt-in. Californien opt-out. Én codebase.

GDPR (DSGVO) kræver opt-in. CCPA/CPRA kræver opt-out plus et link til "Do Not Sell or Share My Personal Information". SimpleCMP registrerer den besøgendes region og skifter automatisk mellem de to regimer — ingen custom-kode, ingen geo-IP-API.

  • Region→regime-opløsning via resolveRegime (f.eks. DE → optIn, US-CA → optOut)
  • Opt-out-banner med do-not-sell-trigger i stedet for accept/decline-modal
  • Public API: region, regimeDefault, regimes til custom-UI
  • Konfigurerbar — region-override via config, ingen vendor-geo-lock-in
// Regionen bestemmes automatisk
init({
  region: 'auto', // 'DE' | 'US-CA' | …
  regimes: {
    optIn:  { services: [...] },
    optOut: { services: [...] }
  }
});

// Public API til eget UI:
manager.region;          // 'US-CA'
manager.regimeDefault;   // 'optOut'

// CCPA-banneret vises automatisk:
"Do Not Sell or Share
 My Personal Information"

Audit-Engine

Compliance-check direkte i browseren.

Tilføj ?simplecmp_audit=1 til din URL, og SimpleCMP kører live i compliance-mode: et panel lister hver overtrædelse af §4 i legal-compliance-dokumentationen med severity, selector og fix-hint.

Tjekkene er ikke kun config-statiske — auditDom() læser det renderede banner og rapporterer svage decline-knapper, marketing-nudges, manglende accessible names og targets under 44px. Det er den engine, vi selv tester vores eget banner med — den er en del af bundlet.

$ 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

Flere funktioner

Det med småt, som tæller i praksis.

26 sprogpakker

Inklusive tysk, engelsk, fransk, italiensk, spansk, nederlandsk, polsk, tyrkisk, tjekkisk, svensk og flere. Auto-detektion via <html lang>.

Click-to-enable-embeds

Blokerede YouTube-, Vimeo- eller Maps-embeds får automatisk en themed inline-notice. Granting kører pr. service, uden at hele modalen popper op igen.

Pre-consent-blokering

Universel blokering via data-name- og data-src- markers. Scripts og iframes indlæses slet ikke, før der foreligger consent — ingen risiko for race conditions.

GDPR (DSGVO)-default

"Afvis alle" er ligestillet med "Acceptér alle" — default, ikke opt-in (BGH-afgørelsen Cookie II, DSK 2022). Impressum-link adskilt fra privatlivspolitikken.

Lit-baserede web components

Custom elements (<simplecmp-banner>, <simplecmp-modal>) med shadow DOM. Valgfrit light DOM til dyb CSS-tilpasning.

Browser-consent-signaler

Respekterer Sec-GPC (Global Privacy Control) og DNT-header-signalet. Konfigurerbar adfærd: auto-decline, banner-hide eller eksplicit bekræftelse.

Theme-adaptere

Out-of-the-box-CSS til Bootstrap 5, Tailwind v4, Bulma og Pico. Token-baserede re-maps til de respektive framework-variabler — intet override-rod.

Consent Mode v2 (multi-vendor)

Vendor-bevidste signaler ved init og ved hvert save: gtag('consent', …) til Google (GA4/GTM), fbq('consent', …) til Meta Pixel og uetq.push('consent', …) til Microsoft UET — plus CSP-policy-bidrag. Til Google Tag Manager bærer dataLayer-eventet status pr. tjeneste og pr. formål — præcis én opdatering pr. gemt beslutning.

Stylesheet-blokering

Valgfrit opt-in (universalBlocking.blockStylesheets): tredjeparts-<link rel="stylesheet"> som Google Fonts blokeres med block-and-reinject før consent. Mitigering for LG München I-sagen.

Banner-layout-skabeloner

Token-styret placering: alle fire hjørner, bottom-bar eller centreret modal — én config-værdi er nok. Equal-button-styling er hardcodet i skabelonen (ellers ville compliance-checket blive rødt).

Du/Sie-overlay

Tone-pack pr. sprog: for hver locale kan en informal.json overskrive de formelle strings — DE, FR, IT, ES, NL er startet. Marketing-sites får "Tillad cookies?" uden at skulle forke det medfølgende pack.

WCAG 2.2 AA / BFSG

Region-landmark, aria-live, focus-trap, 44×44 px target-size, synlige tastaturfokusringe. Gennemgået live med screenreader på en Shopify-dev-store. BFSG-relevant for e-commerce fra 06/2025.

Provider-informationsmodal

GDPR-konform (DSGVO) tretrins-layered-disclosure: banner → contextual notice → "Mere information ›" åbner en modal med den dataansvarlige enhed, adresse, privatlivspolitik-URL, opt-out-URL og transfergrundlag — fra service-library'en.

Host-kvalificerede cookie-matchers

Cookies matches ikke kun på navn, men også på den host, de er sat fra. Vigtigt, når det samme cookienavn bruges af forskellige services (se ADR-0010).

Ren tilbagekaldelse

Trækker man en consent tilbage, forsvinder dataene også: cookies slettes på eget domæne og på moderdomænet, og tilhørende localStorage-poster ligeledes.

Origin-matchers med præcis sti

To tjenester kan dele en host — f.eks. Google Maps og reCAPTCHA på www.google.com. Matchers med sti tildeler hver request til den rigtige tjeneste, og wildcards i sameOriginHosts tages i betragtning.

Test det live nu.

Den interaktive demo viser banner, modal og recorder sammen — uden installation.