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.