CookieDK – GDPR Cookie-banner til WordPress

CookieDK er en GDPR-compliant WordPress-plugin, der automatisk detekterer cookies på dit website og præsenterer dem i et brugervenligt dansk cookie-banner.

🍪 Funktioner

• Auto-detektion – Finder og klassificerer cookies automatisk (server-side og client-side)
• Dansk – Alle tekster og cookie-beskrivelser på dansk (i18n-klar)
• GDPR-compliant – Overholder EU's GDPR og den danske cookielovgivning
• Kategorier – Nødvendige, Funktionelle, Analyser og Marketing
• Cookie-banner – Responsivt banner med top/bund/side-position og dark mode
• Indstillingspanel – Toggle-baseret kategoriudvælgelse med cookie-detaljer
• Admin-interface – Dashboard, cookie-management, indstillinger, samtykkelogning og test
• Samtykkelogning – Dokumenterer bruger-samtykker med tidsstempel, IP og user-agent
• Data-export (DSAR) – Integreret med WordPress' privatlivsværktøjer (GDPR data-subject access)
• Retten til at blive glemt – Slet alle samtykker med ét klik
• Auto-anonymisering – IP-adresser anonymiseres automatisk efter 30 dage
• Privacy Policy – Automatisk generering af dansk cookiepolitik til WordPress Privacy Policy-siden
• Tilgængelighed – WCAG 2.1 AA kompatibel (ARIA labels, keyboard navigation)
• WordPress Coding Standards – Fuldt kompatibel med WPCS
• Internationalisering – Fuldt i18n-klar med .pot/.po/.mo oversættelsesfiler

📋 Krav

🚀 Installation

Manuel installation

1. Download den seneste version fra GitHub Releases
2. Log ind i din WordPress-adminpanel
3. Gå til Plugins → Tilføj ny
4. Klik på Upload plugin
5. Vælg den downloadede .zip-fil og klik Installer nu
6. Aktivér pluginen via Plugins → Installerede plugins

Via FTP

1. Download og udpak .zip-filen
2. Upload mappen cookiedk/ til /wp-content/plugins/
3. Aktivér pluginen i WordPress-adminpanelet

Via WP-CLI

wp plugin install cookiedk.zip --activate

⚙️ Konfiguration

Efter aktivering oprettes database-tabellerne automatisk, og du kan konfigurere pluginen:

1. Gå til Indstillinger → CookieDK i adminpanelet
2. Konfigurér via de fem faneblade:
   • Dashboard – Oversigt med statistik over detekterede cookies og samtykker
   • Cookies – Administrér detekterede cookies (rediger, tilføj, slet, eksportér)
   • Indstillinger – Konfigurér banner og GDPR-indstillinger:
     • Banner-position – Top, bund eller side
     • Farvetema – Lyst, mørkt eller automatisk (følger system-præference)
     • Primær farve – Baggrundsfarve for "Accepter alle"-knappen
     • Sekundær farve – Hover-farve for knapper
     • Cookiepolitik-URL – Link til din cookiepolitik-side (vises i banneret)
     • Samtykkefrist – Antal dage samtykket bevares (standard: 365)
     • Aktive kategorier – Aktiver/deaktiver funktionelle, analytiske og marketing-cookies
     • IP-anonymisering – Anonymisér IP-adresser efter 30 dage
     • Logopbevaring – Antal dage samtykkelogen bevares
   • Samtykker – Oversigt over samtykkeloggen med datofilter
   • Test – Test banner-visning og nulstil samtykker

Banner-konfiguration

Banneret vises automatisk for besøgende der ikke har givet samtykke. Det understøtter tre knapper:

• Accepter alle – Aktiverer alle cookie-kategorier
• Indstillinger – Åbner et detaljeret indstillingspanel
• Kun nødvendige – Accepterer kun teknisk nødvendige cookies

Samtykket gemmes i localStorage med det konfigurerede antal dages udløb.

🗂️ Mappestruktur

cookiedk/
├── cookiedk.php                        # Hoved-plugin-fil
├── uninstall.php                       # Rydning ved afinstallation
├── README.md                           # Denne fil
├── CHANGELOG.md                        # Ændringslog
├── TRANSLATION.md                      # Oversættelsesvejledning
├── PROJEKTPLAN.md                      # Projektplan
├── includes/
│   ├── class-cookie-detector.php       # Cookie-detektion
│   ├── class-cookie-storage.php        # Database-lagring & CRUD
│   ├── class-gdpr-compliance.php       # GDPR-overholdelse & AJAX-endpoints
│   ├── class-consent-export.php        # DSAR data-export (Fase 6)
│   ├── class-privacy-policy.php        # Privacy policy-generator (Fase 6)
│   └── class-translations.php          # Oversættelses-hjælpere (Fase 7)
├── admin/
│   ├── class-admin-menu.php            # Admin-menu registrering
│   ├── class-admin-page.php            # Admin-side renderer & AJAX-handlers
│   ├── assets/
│   │   ├── css/admin.css               # Admin CSS
│   │   └── js/admin.js                 # Admin JavaScript
│   └── partials/
│       ├── dashboard.php               # Dashboard-statistik
│       ├── cookies.php                 # Cookie-management
│       ├── settings.php                # Plugin-indstillinger
│       ├── consent-log.php             # Samtykkelogning
│       └── test.php                    # Test-side
├── public/
│   ├── class-frontend.php              # Frontend banner-rendering
│   ├── assets/
│   │   ├── css/banner.css              # Banner CSS (responsivt, dark mode)
│   │   └── js/
│   │       ├── banner.js               # Banner interaktion & ARIA
│   │       └── cookie-consent.js       # Samtykke-logik & localStorage
│   └── templates/
│       ├── banner.php                  # Banner HTML-template
│       └── settings-panel.php          # Indstillingspanel HTML-template
├── languages/
│   ├── cookiedk-da_DK.pot              # Oversættelsesskabelon
│   ├── cookiedk-da_DK.po               # Dansk oversættelse (kildekode)
│   └── cookiedk-da_DK.mo               # Kompileret oversættelsesfil
└── assets/                             # Delte ressourcer

🗄️ Database

Pluginen opretter to tabeller ved aktivering:

wp_cookiedk_cookies

Gemmer detekterede og konfigurerede cookies.

wp_cookiedk_consent_log

Logger bruger-samtykker.

🔐 Sikkerhed

• Nonce-verificering på alle AJAX-kald og formularer
• Sanitering af alt bruger-input med WordPress-funktioner
• Escaping af alt output
• Capability-checks med current_user_can()
• Ingen hardcodede hemmeligheder
• IP-anonymisering efter 30 dage (konfigurerbar)
• SHA-256 fingerprinting – ingen PII i fingerprints
• Fingerprint-validering – regex-tjek forhindrer injektion

🛡️ GDPR-integration (Fase 6)

AJAX-endpoints

WordPress Privacy Hooks

// GDPR Data-export (DSAR)
add_filter( 'wp_privacy_personal_data_exporters', ... );

// GDPR Data-sletning (RTBF)
add_filter( 'wp_privacy_personal_data_erasers', ... );

// Bruger-registrering
add_action( 'user_register', ... );

// Bruger-sletning (sletter samtykkedata automatisk)
add_action( 'delete_user', ... );

Privacy Policy Integration

CookieDK tilføjer automatisk en dansk cookiepolitik-tekst til WordPress' Privacy Policy-side (via wp_add_privacy_policy_content). Teksten inkluderer:

• Liste over detekterede cookies pr. kategori
• GDPR-retsgrundlag for hver kategori
• Rettigheder (indsigt, sletning, tilbagekald)
• Link til Datatilsynet

🌍 Internationalisering (Fase 7)

CookieDK er fuldt internationaliseret med tekstdomænet cookiedk.

Oversættelsesfiler

Se TRANSLATION.md for vejledning til at tilføje nye sprog.

📖 WordPress Hooks

Actions

// Tilføj egne cookies til auto-detektion.
add_filter( 'cookiedk_known_cookies', function( $cookies ) {
    $cookies['my_custom_cookie'] = array(
        'category'       => 'functional',
        'description_da' => 'Min tilpassede cookie.',
        'duration'       => '1 år',
        'provider'       => 'Mit website',
        'necessary'      => false,
    );
    return $cookies;
} );

🇩🇰 Dansk Cookielovgivning

Pluginen følger:

• GDPR (EU 2016/679)
• ePrivacy-direktivet (Cookie-direktivet)
• Datatilsynets retningslinjer (datatilsynet.dk)

GDPR-krav der overholdes:

• ✅ Eksplicit samtykke før ikke-nødvendige cookies
• ✅ Klar og forståelig information (dansk)
• ✅ Nem tilbagekaldelse af samtykke
• ✅ Dokumentation af samtykker (logning)
• ✅ Retten til at blive glemt (data-sletning)
• ✅ Data-minimerering (anonymisering af IP)

🖼️ Screenshots (plan)

• Cookie-banner (desktop + mobil)
• Cookie-indstillinger modal
• Admin dashboard og samtykke-log

Assets til WordPress.org:

• Banner: 1200x400
• Icon: 256x256

❓ FAQ

Hvordan kører jeg tests?
Se tests/README.md.

Hvordan kører jeg security checks?
Kør composer phpstan, composer phpcs og composer lint.

Hvor finder jeg fejlfinding?
Se docs/TROUBLESHOOTING.md.

🛠️ Troubleshooting

• Banner vises ikke: ryd cache og tjek JS-fejl i browseren.
• AJAX fejl (403/429): tjek nonce og rate limiting.
• Manglende eksport: verificér at brugeren er logget ind.

Flere detaljer i docs/TROUBLESHOOTING.md.

🌍 English quick summary

CookieDK is a GDPR-focused WordPress cookie consent plugin with:

• Consent banner and category controls
• Consent logging and privacy export/erase workflows
• Security protections (nonce checks, sanitization, escaping, rate limiting)
• PHPUnit tests and GitHub Actions CI workflows

See English/Danish docs in the docs/ folder.

🤝 Bidrag

Bidrag er velkomne! Se CONTRIBUTING.md og PROJEKTPLAN.md.

1. Fork repositoriet
2. Opret en feature-branch (git checkout -b feature/min-funktion)
3. Commit dine ændringer (git commit -m 'Tilføj min funktion')
4. Push til branchen (git push origin feature/min-funktion)
5. Åbn en Pull Request

📄 Licens

GPL v2 eller nyere – Se https://www.gnu.org/licenses/gpl-2.0.html

👨‍💻 Forfatter

WebJax
https://webjax.dk

📞 Support

• GitHub Issues: github.com/WebJax/CookieDK/issues