Dokumentation

Hurtigstart og koncepter.

Denne side indeholder de vigtigste snippets til at integrere SimpleCMP. Den fulde API-reference findes i repositoryet under docs/ — implementeringen er i pre-1.0-fasen og ændrer sig stadig.

Installation

To veje: som npm-pakke til build-pipelines, eller som IIFE-script-tag til statiske sites og drop-in-scenarier.

npm-pakke

# med pnpm
pnpm add simplecmp

# eller med npm
npm install simplecmp

IIFE-drop-in (selvhostet)

Af databeskyttelseshensyn leverer vi ikke SimpleCMP via offentlige CDN'er. Læg bundlen i din egen assets/-mappe — den komplette vejledning findes i Installation på statisk side.

<link rel="stylesheet" href="/assets/vendor/simplecmp/default.css">
<script src="/assets/vendor/simplecmp/simplecmp.global.js"></script>
<script>
  SimpleCMP.init({ /* config */ });
</script>

Hurtigstart

Minimal konfiguration med to services. Links til privatlivspolitik og kolofon er separate — vigtigt for det tyske marked (TMG/MStV).

import { init } from 'simplecmp';

init({
  storageName: 'simplecmp-myapp',
  privacyPolicy: 'https://example.com/datenschutz',
  imprint:       'https://example.com/impressum',
  floatingTrigger: { label: 'Cookie-Einstellungen' },
  services: [
    {
      name: 'analytics',
      title: 'Google Analytics',
      purposes: ['analytics'],
      cookies: [/^_ga/, '_gid'],
      required: false,
      default:  false
    },
    {
      name: 'matomo',
      title: 'Matomo',
      purposes: ['analytics'],
      cookies: ['_pk_id', '_pk_ses'],
      required: false,
      default:  false
    }
  ]
});

Headless-tilstand

Har du kun brug for state-maskinen og ikke et banner? Engine-understien udelader Lit-komponenterne og er betydeligt mindre.

import { getManager, addEventListener } from 'simplecmp/engine';

const manager = getManager({
  storageName: 'simplecmp-spa',
  services: [/* ... */]
});

addEventListener('saveConsents', (consents) => {
  console.log('Consent-State:', consents);
  // opdater dit eget UI her
});

// Fra eget banner:
manager.updateConsent('analytics', true);
manager.saveConsents();

Aktivér recorder

I dev- eller staging-buildet aktiverer du recorder'en før det første init()-kald. Advarsel: brug den ikke i produktion uden sampling- rate.

import { init } from 'simplecmp';
import { startRecorder } from 'simplecmp/recorder';

startRecorder({
  serviceDB: 'https://library.simplecmp.eu',
  onUnknown: (item) => console.warn('Unknown:', item),
  onKnown:   (item, service) => console.log('Found:', service.name)
});

init({ services: [] });

// Efter et par minutters klik:
recorder.exportConfig();
// → { services: [ { name: 'ga', cookies: [...] }, ... ] }

// I CI:
recorder.assertNoUnknown(); // throws on unknown items

Konfigurer CMS-bridge

Til produktionsbrug: SimpleCMP sender et POST til din webhook ved hver ukendt registrering. Sampling-rate forhindrer webhook-floods ved høj trafik.

import { init } from 'simplecmp';

init({
  services: [/* ... */],
  bridge: {
    url:        'https://example.com/api/simplecmp/webhook',
    secret:     window.SCMP_PUBLIC_NONCE,   // nonce, not secret
    sampleRate: 0.05,                       // 5 % af de besøgende
    dedupTTL:   3600                        // sekunder
  }
});

Webhook-skema v2 er dokumenteret i docs/cms-bridge-webhook.md. En Node.js-receiver findes under demos/cms-bridge-receiver.mjs.


Integrér WordPress uden plugin

Den WordPress-plugin er tilgængelig som beta. Hvis du vil arbejde uden plugin, integrerer du SimpleCMP manuelt i hvert WordPress-tema. I functions.php:

function mytheme_enqueue_simplecmp() {
  // Bundle først via `composer require` eller manuelt til
  // wp-content/themes/<theme>/assets/vendor/simplecmp/ kopier.
  wp_enqueue_style(
    'simplecmp',
    get_template_directory_uri() . '/assets/vendor/simplecmp/default.css'
  );
  wp_enqueue_script(
    'simplecmp',
    get_template_directory_uri() . '/assets/vendor/simplecmp/simplecmp.global.js',
    array(), null, false
  );

  $config = array(
    'storageName' => 'simplecmp-' . sanitize_title(get_bloginfo('name')),
    'privacyPolicy' => get_permalink(get_option('wp_page_for_privacy_policy')),
    'imprint' => get_permalink(get_page_by_path('impressum')),
    'services' => apply_filters('simplecmp_services', array())
  );

  wp_add_inline_script(
    'simplecmp',
    'SimpleCMP.init(' . wp_json_encode($config) . ');'
  );
}
add_action('wp_enqueue_scripts', 'mytheme_enqueue_simplecmp');

Browser-consent-signaler

SimpleCMP tager højde for Global Privacy Control-signalet (Sec-GPC: 1) og den legacy DNT-header. Standardadfærden er auto-decline; den kan ændres via konfiguration.

init({
  consentSignals: {
    gpc: 'auto-decline',     // eller 'hide-banner' | 'confirm'
    dnt: 'ignore'            // DNT er de facto forældet
  },
  services: [/* ... */]
});

Mere dokumentation

Den fulde dokumentation og alle ADR'er (Architectural Decision Records) findes i GitHub-repositoryet:

Har du brug for hjælp?

Integrationssupport direkte fra maintainerne.

Hos WapplerSystems bruger vi SimpleCMP hver dag i kundeprojekter. Hvis du har brug for hjælp til implementering, theming eller en skræddersyet udvidelse — hjælper vi gerne.