Open Data Wizard 🧙

Ein WordPress-Plugin zur einfachen Veröffentlichung offener Daten nach DCAT-AP 3.0

Open Data Wizard ermöglicht es Organisationen und Einzelpersonen, Datensätze direkt in WordPress zu beschreiben und als maschinenlesbare, standardkonforme Metadaten bereitzustellen — ohne technische Vorkenntnisse, ohne externe Plattformabhängigkeit.

Das Problem

Offene Daten zu veröffentlichen ist schwieriger als es sein müsste. Wer Daten auf einer Open-Data-Plattform einstellen will, landet schnell vor komplexen Formularen, unbekannten Fachbegriffen oder muss sich auf eine externe Infrastruktur verlassen, über die keine Kontrolle besteht.

Dabei besitzen viele Organisationen bereits eine WordPress-Website und damit eine Infrastruktur, die sie kennen und die sie kontrollieren.

Hier kann der Open Data Wizard helfen.

Die Idee

Das Plugin bringt einen geführten Metadaten-Wizard ins WordPress-Backend. Organisationen beschreiben ihre Datensätze dort, wo sie ohnehin arbeiten. Das Plugin generiert daraus eine maschinenlesbare Beschreibung nach dem internationalen Standard DCAT-AP 3.0 und stellt sie unter einer persistenten URL bereit.

Open-Data-Plattformen können diese URL als Harvest-Quelle einbinden und die Metadaten automatisch einsammeln. Die Daten bleiben bei der Organisation. Die Plattform kommt zu ihr.

Was ist DCAT-AP?

DCAT-AP (Data Catalog Vocabulary — Application Profile) ist ein europäischer Standard zur Beschreibung von Datensätzen und Datenkatalogen. Er definiert, welche Angaben ein Datensatz braucht, damit er von Plattformen, Suchmaschinen und Anwendungen einheitlich gelesen und verarbeitet werden kann — Titel, Beschreibung, Lizenz, Format, Herausgeber und mehr.

Open Data Wizard implementiert DCAT-AP 3.0 und erzeugt valide JSON-LD-Ausgaben.

Für wen ist das Plugin?

Vereine, NGOs und gemeinnützige Organisationen, die Daten transparent zugänglich machen möchten
Forschungseinrichtungen und Bildungsträger, die Daten unter offener Lizenz veröffentlichen wollen
Kommunen und öffentliche Einrichtungen mit WordPress-Infrastruktur
Alle, die offene Daten standardkonform veröffentlichen wollen — ohne Programmierkenntnisse

Funktionsübersicht

🗂 Datensätze verwalten

Eigener Bereich im WordPress-Backend mit Übersicht, Filterung und Statusverwaltung (Entwurf / Veröffentlicht).

😊 Benutzerfreundliche Formularsprache

Das Wizard-Formular wurde vollständig überarbeitet, um es auch ohne DCAT-AP-Kenntnisse intuitiv zu machen:

Klare Fragen statt technischer Begriffe: Statt „Herausgebende Organisation (dct:publisher)" fragt das Plugin: „Wer gibt diese Daten heraus?"
Hilfreiche Beispiele: Jedes Feld hat konkrete, praxisnahe Beispiele
Ursprüngliche Labels in Hilfetexten: DCAT-AP Bezeichnungen und technische Details bleiben in den Hilfetexten sichtbar
Validierungsmeldungen in Klartext: Fehler zeigen verständliche Feldnamen statt technischer Ausdrücke

🧭 Geführter Wizard

Fünf-Tab-Assistent mit Pflichtfeldprüfung und praktischen Beispielen:

Grundlegende Informationen — „Wer gibt diese Daten heraus?", „Worum geht es in diesem Datensatz?", „In welche Kategorie gehört dieser Datensatz?"
Inhaltliche Angaben — „In welcher Sprache sind die Daten?", „Mit welchen Stichworten finde ich diese Daten?", Zeitangaben, CESSDA-Themenklassifikation
Datenbereitstellung — Distributionen (wiederholbar): Zugriffs-URL, Format, Dateigröße, Lizenz (Pflichtfeld pro Distribution), Zuschreibungstext
Erweiterte Angaben — Projektseite, Aktualisierungsfrequenz, geografische und zeitliche Abdeckung, Kontaktinformationen
Vorschau — generiertes JSON-LD live einsehen

🏷 Lizenz-Auswahl

Vordefinierte Auswahlliste mit gängigen offenen Lizenzen (CC0, CC-BY, ODbL u.v.m.) aus config/licenses.txt
Option „Sonstige" öffnet ein Freitextfeld mit Auto-Suggest aus der Lizenzdatei
Lizenz ist Pflichtfeld pro Distribution (nicht am Datensatz selbst)

🎓 CESSDA-Themenklassifikation

Auto-Suggest-Feld aus der CESSDA Topic Classification 4.2.3 (95 deutsche Konzepte, SKOS/RDF, 24h Cache).

📎 Download-Datei (nativer wp.media Upload)

Sidebar-Meta-Box — vollständig unabhängig von Carbon Fields:

„Datei auswählen / hochladen"-Button öffnet den nativen WordPress Media Library Frame
Beim Speichern werden _odw_file_size (Bytes) und _odw_file_format (z.B. „CSV") automatisch berechnet
Sicherheit: wp_verify_nonce + current_user_can('edit_post')

⚙️ Einstellungsseite

Untermenü unter Datensätze → Einstellungen mit vier Bereichen:

Katalog — Titel und Herausgebende Organisation
Standardwerte — Standard-Sprache (wird bei neuen Datensätzen vorausgefüllt)
REST API — Cache-Laufzeit (60–86400 Sekunden)
Deinstallation — Opt-in Checkbox für vollständige Datenlöschung

📊 Qualitätsindikatoren

Automatische Metadaten-Vollständigkeitsprüfung nach DCAT-AP 3.0 (0–100 Punkte, 4 Stufen):

Stufe	Punkte	Bedeutung
Perfekt	100	Alle Felder ausgefüllt
Gut	56–99	Über Mindestanforderung
Ausreichend	55	Genau alle Pflichtfelder
Verbesserungsbedarf	< 55	Pflichtfelder unvollständig

Berechnung nach jedem Speichern; Ergebnis in der Admin-Listenansicht und als Meta-Box sichtbar.

📥 Download-Card Shortcode

[odw_dataset id="123"]

Rendert eine strukturierte Download-Card im Frontend: Titel, Thema-Badge, Lizenz, Schlagwörter als Tag-Pillen, Download-Button sowie einen Metadaten-Download-Button (JSON-LD). CSS (assets/css/frontend.css) wird nur auf Seiten geladen, die den Shortcode enthalten.

🔗 REST API Endpoints

GET https://deine-website.de/wp-json/datenatlas/v1/catalog
GET https://deine-website.de/wp-json/datenatlas/v1/datasets/<id>
GET https://deine-website.de/wp-json/datenatlas/v1/delta?since=<ISO8601>

Diese URLs können bei einer Open-Data-Plattform als Harvest-Quelle eingetragen werden — einmalig, ohne weiteren Aufwand.

Catalog-Parameter: page, per_page, theme, license, format (jsonld oder json)

Delta-Parameter: since (erforderlich, ISO 8601), page, per_page, format — liefert nur Datensätze, die nach dem angegebenen Zeitstempel geändert wurden, plus Tombstones für gelöschte Datensätze

✅ DCAT-AP 3.0 Konformität

Alle Ausgaben sind DCAT-AP 3.0 konform und in JSON-LD serialisiert.

Installation

Für Anwender:innen

ZIP-Datei aus den Releases herunterladen
Im WordPress-Backend: Plugins → Installieren → Plugin hochladen
Plugin aktivieren

Keine weiteren Abhängigkeiten. Keine Programmierkenntnisse erforderlich.

Für Entwickler:innen

git clone https://github.com/daimpad/OpenDataWizard.git
cd OpenDataWizard
composer install   # inkl. PHPStan, WPCS, PHPUnit

Den Plugin-Ordner in eine lokale WordPress-Instanz einbinden (z.B. via LocalWP).

Systemvoraussetzungen:

WordPress ≥ 6.4
PHP ≥ 8.1
Composer (nur für Entwicklung)

Dev-Tools:

composer phpcs      # WordPress Coding Standards prüfen
composer phpcbf     # Automatisch korrigieren
composer phpstan    # Statische Analyse (Level 6)
composer test       # PHPUnit-Tests ausführen

CI läuft via GitHub Actions (.github/workflows/ci.yml) auf PHP 8.1, 8.2 und 8.3.

Für Entwickler: Siehe CLAUDE.md für Architektur-Übersicht, Patterns, Debugging-Tipps und Workflows.

Technische Dokumentation

Architektur

Präsentation    →   WP-Admin-Masken, Wizard (Tabs, Validierung)
Domäne          →   Metadatenmodell, DCAT-AP Mapping, Validierungslogik
Infrastruktur   →   REST API, JSON-LD Serialisierung, Custom Post Type

Dateistruktur

open-data-wizard/
├── open-data-wizard.php              # Plugin-Header & Bootstrap
├── uninstall.php                     # Opt-in Datenlöschung
├── composer.json
├── config/
│   ├── licenses.txt                  # Lizenzdatei (URI | Label)
│   ├── dct-format-list.php           # Dateiformate (MIME + EU-URI)
│   ├── dcat-ap-fields.php            # Felddefinitionen (Qualität + Validierung)
│   ├── TopicClassification-4.2.3_de-4.2.3.rdf  # CESSDA SKOS/RDF (95 Konzepte)
│   ├── phpcs.xml                     # PHPCS Konfiguration
│   ├── phpstan.neon                  # PHPStan Level 6
│   └── phpunit.xml                   # PHPUnit 9 Konfiguration
├── vendor/                           # Carbon Fields + Dev-Dependencies
├── includes/
│   ├── class-post-types.php          # CPT-Registrierung: odw_dataset
│   ├── class-fields.php              # Carbon Fields (5 Tabs), JSON-LD Builder
│   ├── class-rest-api.php            # REST Endpoints + Transient-Cache
│   ├── class-validation.php          # Pflichtfeldprüfung vor Veröffentlichung
│   ├── class-quality.php             # Qualitätsindikatoren (0–100, 4 Stufen)
│   ├── class-admin.php               # Listenansicht, wp.media Meta-Box, Help Tabs
│   ├── class-shortcode.php           # [odw_dataset]-Shortcode, Download-Card
│   ├── class-setup.php               # Demo-Datensatz bei Aktivierung
│   ├── class-settings.php            # Einstellungsseite
│   └── class-cli.php                 # WP-CLI Befehle
├── assets/
│   ├── js/
│   │   ├── wizard-tabs.js            # Tab-Navigation (Vanilla JS)
│   │   ├── odw-file-upload.js        # wp.media Upload-Widget (jQuery)
│   │   └── odw-admin-fields.js       # License/CESSDA Auto-Suggest, Dateigröße-Widget
│   ├── css/
│   │   ├── admin.css                 # Admin-Styles
│   │   └── frontend.css              # Shortcode Download-Card
│   └── sample/
│       └── beispiel-datensatz.csv    # Demo-Datensatz CSV
├── tests/
│   ├── bootstrap.php
│   ├── test-fields.php
│   ├── test-fields-extended.php
│   ├── test-quality.php
│   ├── test-settings.php
│   ├── test-shortcode.php
│   ├── test-rest-delta.php
│   └── test-cli.php
└── .github/workflows/ci.yml          # CI: PHPCS + PHPStan + PHPUnit (PHP 8.1–8.3)

Feldmapping DCAT-AP 3.0

Tab 1 — Grundlegende Informationen

Feld	DCAT-AP Prädikat	Pflicht
Titel	`dct:title`	✓
Beschreibung	`dct:description`	✓
Herausgeber	`dct:publisher` → `foaf:Organization`	✓
Thema	`dcat:theme`	—

Tab 2 — Inhaltliche Angaben

Feld	DCAT-AP Prädikat	Pflicht
Sprache	`dct:language`	—
Schlagworte (eine pro Zeile)	`dcat:keyword`	—
Veröffentlichungsdatum	`dct:issued`	—
Änderungsdatum	`dct:modified` (auto)	—
CESSDA Themenklassifikation	`cessda:topic`	—

Tab 3 — Datenbereitstellung (Distribution)

Feld	DCAT-AP Prädikat	Pflicht
Zugriffs-URL	`dcat:accessURL`	✓ (min. 1)
Format	`dct:format` (MIME)	—
Dateigröße	`dcat:byteSize`	—
Lizenz	`dct:license` (URI)	✓ pro Distribution
Zuschreibungstext	`odrl:attribution`	—

Tab 4 — Erweiterte Angaben

Feld	DCAT-AP Prädikat	Pflicht
Projektseite	`dcat:landingPage` (`@id`)	—
Aktualisierungsfrequenz	`dct:accrualPeriodicity` (EU-URI)	—
Geographische Abdeckung	`dct:spatial` → `dct:Location` + `skos:prefLabel`	—
Zeitlicher Bezug Start	`dct:temporal` → `dcat:startDate`	—
Zeitlicher Bezug Ende	`dct:temporal` → `dcat:endDate`	—
Kontaktpunkt Name	`dcat:contactPoint` → `vcard:fn`	—
Kontaktpunkt E-Mail	`vcard:hasEmail` (mit `mailto:`-Prefix)	—
Kontaktpunkt Website	`vcard:hasURL` (`@id`)	—

Sidebar — Download-Datei

Feld	Interner Meta-Key	Beschreibung
Attachment-ID	`_odw_file_id`	Mediathek-Datei
Dateigröße (auto)	`_odw_file_size`	Bytes, auto-berechnet beim Speichern
Dateiformat (auto)	`_odw_file_format`	z.B. „CSV", auto-berechnet

REST API

Catalog

GET /wp-json/datenatlas/v1/catalog

Parameter	Standard	Beschreibung
`page`	1	Seitennummer
`per_page`	20	Einträge pro Seite (max. 100)
`theme`	–	Filter nach Thema
`license`	–	Filter: Kurzform (`cc-by`) oder volle URI
`format`	`jsonld`	`jsonld` → `application/ld+json`, `json` → `application/json`

Response-Header: X-WP-Total, X-WP-TotalPages, X-ODW-Cache (HIT/MISS)

Einzel-Dataset

GET /wp-json/datenatlas/v1/datasets/<id>

Delta-Harvesting (inkrementell)

GET /wp-json/datenatlas/v1/delta?since=2024-01-01T00:00:00Z

Parameter	Standard	Beschreibung
`since`	erforderlich	ISO 8601 Datetime
`page`	1	Seitennummer
`per_page`	20	Einträge pro Seite (max. 100)
`format`	`jsonld`	Content-Type

Response enthält dcat:dataset (geänderte Datasets) und odw:removed (Tombstones).

Beispiel-Response

{
  "@context": {
    "dcat":  "https://www.w3.org/ns/dcat#",
    "dct":   "http://purl.org/dc/terms/",
    "foaf":  "http://xmlns.com/foaf/0.1/",
    "xsd":   "http://www.w3.org/2001/XMLSchema#",
    "vcard": "http://www.w3.org/2006/vcard/ns#",
    "skos":  "http://www.w3.org/2004/02/skos/core#",
    "odw":   "https://github.com/daimpad/OpenDataWizard/ns#"
  },
  "@type": "dcat:Catalog",
  "dct:title": "Mein Datenkatalog",
  "dcat:dataset": [
    {
      "@type": "dcat:Dataset",
      "dct:title": "Mitgliederdaten 2023",
      "dct:description": "Anonymisierte Mitgliederstatistik.",
      "dct:publisher": { "@type": "foaf:Organization", "foaf:name": "Musterorganisation e.V." },
      "dcat:distribution": [
        {
          "@type": "dcat:Distribution",
          "dcat:accessURL": "https://organisation.de/daten/mitglieder.csv",
          "dct:format": "text/csv",
          "dct:license": "https://creativecommons.org/licenses/by/4.0/",
          "dcat:byteSize": 20480
        }
      ]
    }
  ]
}

Erweiterbarkeit

Hook	Beschreibung
`odw_license_options`	Weitere Lizenz-Optionen hinzufügen
`odw_theme_options`	Weitere Thema-Optionen hinzufügen
`odw_dataset_jsonld`	JSON-LD Array vor Ausgabe anpassen
`odw_catalog_title`	Catalog-Titel anpassen

// Eigene Lizenz hinzufügen
add_filter( 'odw_license_options', function( array $options ): array {
    $options['https://example.com/custom-license'] = 'Custom License 1.0';
    return $options;
} );

// JSON-LD Dataset anpassen
add_filter( 'odw_dataset_jsonld', function( array $jsonld, int $post_id ): array {
    $jsonld['dct:spatial'] = 'https://sws.geonames.org/2921044/';
    return $jsonld;
}, 10, 2 );

WP-CLI Befehle

# Qualitätsscores für alle veröffentlichten Datasets neu berechnen
wp open-data-wizard quality recalculate

# Alle Datasets einschließlich Entwürfe und Trash berechnen
wp open-data-wizard quality recalculate --all

# Alle REST API Transient-Caches löschen
wp open-data-wizard cache clear

Abhängigkeiten

Paket	Version	Zweck
Carbon Fields	^3.6	Admin-Formular (5-Tab-Wizard)
PHPUnit	^9.6	Unit-Tests (dev)
WP_Mock	^1.0	WordPress-Stubs für Tests (dev)
PHPStan + WordPress-Stubs	^2.0	Statische Analyse Level 6 (dev)
WPCS	^3.1	Coding Standards (dev)

Roadmap

Abgeschlossen (v1.0 — v2.1):

In Planung (v2.2+):

Content Negotiation: Turtle / RDF-XML Ausgabe
Gutenberg Block für die Download-Card
Mehrsprachigkeit (WPML/Polylang)
Phase 3 UX: Tooltip-Popups, Wizard-Vorschau

Mitwirken

Beiträge sind willkommen — ob Fehlermeldungen, Verbesserungsvorschläge oder Pull Requests.

Bitte öffne zunächst ein Issue, bevor du größere Änderungen einreichst.

Deinstallation

Das Plugin löscht bei Deinstallation standardmäßig keine Daten (Opt-in).

Um alle Plugin-Daten zu löschen, die Checkbox unter Datensätze → Einstellungen → Deinstallation aktivieren und dann das Plugin im WordPress-Backend deinstallieren. uninstall.php entfernt alle odw_dataset-Posts, alle _odw_*-Metafelder sowie die Plugin-Optionen.

Lizenz

GPL-2.0-or-later — siehe LICENSE

Name		Name	Last commit message	Last commit date
Latest commit History 74 Commits
.github/workflows		.github/workflows
assets		assets
config		config
includes		includes
tests		tests
vendor		vendor
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
TopicClassification-4.2.3_de-4.2.3.rdf		TopicClassification-4.2.3_de-4.2.3.rdf
composer.json		composer.json
composer.lock		composer.lock
open-data-wizard.php		open-data-wizard.php
uninstall.php		uninstall.php

Folders and files

Latest commit

History

Repository files navigation

Open Data Wizard 🧙

Das Problem

Die Idee

Was ist DCAT-AP?

Für wen ist das Plugin?

Funktionsübersicht

🗂 Datensätze verwalten

😊 Benutzerfreundliche Formularsprache

🧭 Geführter Wizard

🏷 Lizenz-Auswahl

🎓 CESSDA-Themenklassifikation

📎 Download-Datei (nativer wp.media Upload)

⚙️ Einstellungsseite

📊 Qualitätsindikatoren

📥 Download-Card Shortcode

🔗 REST API Endpoints

✅ DCAT-AP 3.0 Konformität

Installation

Für Anwender:innen

Für Entwickler:innen

Technische Dokumentation

Architektur

Dateistruktur

Feldmapping DCAT-AP 3.0

Tab 1 — Grundlegende Informationen

Tab 2 — Inhaltliche Angaben

Tab 3 — Datenbereitstellung (Distribution)

Tab 4 — Erweiterte Angaben

Sidebar — Download-Datei

REST API

Catalog

Einzel-Dataset

Delta-Harvesting (inkrementell)

Beispiel-Response

Erweiterbarkeit

WP-CLI Befehle

Abhängigkeiten

Roadmap

Mitwirken

Deinstallation

Lizenz

About

Topics

Resources

License

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages