Merge pull request #68 from daimpad/claude/fix-data-prep-errors-kJYpl

feat: Add dcatde:geocodingDescription + collapsible Tab-4 subsections (v2.26.0)

Author: daimpad

CHANGELOG.md

@@ -7,6 +7,24 @@ und dieses Projekt folgt [Semantic Versioning](https://semver.org/spec/v2.0.0.ht
 
 ---
 
+## [2.26.0] — 2026-07-30
+
+### ✨ Added — DCAT-AP.de-Feld & Profi-UX
+- **Neues Feld `dcatde:geocodingDescription`** („Wie lässt sich der räumliche Bezug in Worten
+  beschreiben?", Tab „Erweiterte Angaben" → Abdeckung): textuelle Ergänzung zu `dct:spatial` /
+  `dcatde:politicalGeocodingURI`. Im JSON-LD als sprachgetaggtes Literal, in Feld-Referenz und
+  Frontend-Widget-Accordion enthalten.
+- **Profi-UX v2:** Der große Bereich „Erweiterte Angaben" (Tab 4) ist jetzt in **einzeln aufklappbare
+  Untergruppen** gegliedert (Verantwortlichkeiten · Zugriff · HVD · Weitere DCAT-AP-Felder ·
+  Distribution) statt eines einzigen großen Reveals. Standardmäßig eingeklappt; Zustand je Gruppe in
+  `sessionStorage`. Progressive Enhancement: ohne JS bleiben alle Felder sichtbar.
+
+### 🌍 i18n / ✅ Tests
+- 7 neue UI-Strings in `en_US`; JSON-LD-Test für `dcatde:geocodingDescription` (167 Tests). Feld-Referenz
+  neu generiert (53 Felder).
+
+---
+
 ## [2.25.0] — 2026-07-30
 
 ### 📚 Added — Offizielle SHACL-Shapes gebündelt

README.md

@@ -7,7 +7,7 @@
 ![PHP Version](https://img.shields.io/badge/PHP-%3E%3D%208.1-8892BF?style=flat-square&logo=php&logoColor=white)
 ![WordPress](https://img.shields.io/badge/WordPress-compatible-21759B?style=flat-square&logo=wordpress&logoColor=white)
 ![DCAT-AP](https://img.shields.io/badge/DCAT--AP-3.0-brightgreen?style=flat-square)
-![Version](https://img.shields.io/badge/Version-2.25.0-brightgreen?style=flat-square)
+![Version](https://img.shields.io/badge/Version-2.26.0-brightgreen?style=flat-square)
 ![PRs Welcome](https://img.shields.io/badge/PRs-willkommen-brightgreen?style=flat-square)
 
 📖 [Dokumentation](DOCUMENTATION.md) · 📋 [Feld-Referenz](docs/FELD-REFERENZ.md) · 📐 [Technische Spezifikation](TECHNICAL-SPEC.md) · 📝 [Changelog](CHANGELOG.md) · 🛡️ [Security](SECURITY.md) · ⚖️ [Lizenz](LICENSE)

assets/css/admin.css

@@ -642,6 +642,38 @@
 	transform: rotate( 90deg );
 }
 
+/* Collapsible subsection headers (Tab 4 „Erweiterte Angaben") */
+.odw-section-toggle {
+	display: flex;
+	align-items: center;
+	gap: 6px;
+	width: 100%;
+	margin: 12px 0 4px;
+	padding: 8px 12px;
+	background: var( --odw-color-bg-light, #f6f7f7 );
+	border: 1px solid var( --odw-color-border, #c3c4c7 );
+	border-radius: 4px;
+	color: var( --odw-color-text, #1d2327 );
+	font-size: 13px;
+	font-weight: 600;
+	text-align: left;
+	cursor: pointer;
+}
+
+.odw-section-toggle:hover {
+	background: #eef1f3;
+	color: var( --odw-color-primary, #2271b1 );
+}
+
+.odw-section-caret {
+	color: var( --odw-color-primary, #2271b1 );
+	transition: transform 0.15s ease;
+}
+
+.odw-section-toggle.odw-section-open .odw-section-caret {
+	transform: rotate( 90deg );
+}
+
 /* -------------------------------------------------------------------------
  * Help tooltips (ⓘ popup next to field labels)
  * ------------------------------------------------------------------------- */

assets/js/odw-admin-fields.js

@@ -249,37 +249,49 @@
 	// toggle into an opt-in section. Progressive enhancement: if JS is absent,
 	// every field simply stays visible. State persists in sessionStorage.
 	// -------------------------------------------------------------------------
-	var PRO_KEY = 'odw_pro_open';
-
-	function applyProState( wrapper, btn, open ) {
-		var node = wrapper.nextElementSibling;
+	// Fields belonging to a section = every .cf-field after the heading until
+	// the next section heading (or the end of the tab).
+	function sectionFields( wrapper ) {
+		var fields = [];
+		var node   = wrapper.nextElementSibling;
 		while ( node ) {
 			if ( node.classList && node.classList.contains( 'cf-field' ) ) {
-				node.classList.toggle( 'odw-pro-collapsed', ! open );
+				if ( node.querySelector && node.querySelector( '[data-odw-section-toggle]' ) ) {
+					break;
+				}
+				fields.push( node );
 			}
 			node = node.nextElementSibling;
 		}
+		return fields;
+	}
+
+	function applySection( btn, fields, open ) {
+		fields.forEach( function ( f ) {
+			f.classList.toggle( 'odw-pro-collapsed', ! open );
+		} );
 		btn.setAttribute( 'aria-expanded', open ? 'true' : 'false' );
-		btn.classList.toggle( 'odw-pro-open', open );
+		btn.classList.toggle( 'odw-section-open', open );
 	}
 
 	function initProSection() {
-		document.querySelectorAll( '[data-odw-pro-toggle]' ).forEach( function ( btn ) {
+		document.querySelectorAll( '[data-odw-section-toggle]' ).forEach( function ( btn ) {
 			var wrapper = btn.closest( '.cf-field' );
 			if ( ! wrapper || ! wrapper.parentNode ) {
 				return;
 			}
-			var open = sessionStorage.getItem( PRO_KEY ) === '1';
-			applyProState( wrapper, btn, open );
+			var key  = 'odw_sec_' + ( btn.getAttribute( 'data-odw-section-toggle' ) || '' );
+			var open = sessionStorage.getItem( key ) === '1'; // Default: collapsed.
+			applySection( btn, sectionFields( wrapper ), open );
 
-			if ( ! btn.getAttribute( 'data-odw-pro-bound' ) ) {
-				btn.setAttribute( 'data-odw-pro-bound', '1' );
+			if ( ! btn.getAttribute( 'data-odw-sec-bound' ) ) {
+				btn.setAttribute( 'data-odw-sec-bound', '1' );
 				btn.addEventListener( 'click', function () {
-					var nowOpen = sessionStorage.getItem( PRO_KEY ) !== '1';
+					var nowOpen = sessionStorage.getItem( key ) !== '1';
 					try {
-						sessionStorage.setItem( PRO_KEY, nowOpen ? '1' : '0' );
+						sessionStorage.setItem( key, nowOpen ? '1' : '0' );
 					} catch ( e ) {} // eslint-disable-line no-empty
-					applyProState( wrapper, btn, nowOpen );
+					applySection( btn, sectionFields( wrapper ), nowOpen );
 				} );
 			}
 		} );

config/field-catalog.php

@@ -292,6 +292,18 @@
 		'desc_dcat'  => '`dcatde:politicalGeocodingURI` (DCAT-AP.de) referenziert ein konkretes amtliches Gebiet über eine URI (z. B. amtlicher Regionalschlüssel/AGS als URI). Kardinalität 0..n. Ermöglicht die eindeutige, maschinenlesbare Verortung.',
 		'desc_human' => 'Verlinken Sie das genaue amtliche Gebiet, auf das sich die Daten beziehen — als offizielle Kennung (z. B. Gemeindeschlüssel). Damit ist eindeutig, welche Region gemeint ist. Beispiel: die URI zum amtlichen Gemeindeschlüssel Ihrer Stadt.',
 	),
+	array(
+		'key'        => 'geocoding_description',
+		'meta_key'   => '_odw_geocoding_description',
+		'dcat_prop'  => 'dcatde:geocodingDescription',
+		'tab'        => '4 — Erweiterte Angaben',
+		'tier'       => 'optional',
+		'vocab'      => '',
+		'q_dcat'     => 'Wie lautet die `dcatde:geocodingDescription` (textuelle Beschreibung des räumlichen Bezugs)?',
+		'q_human'    => 'Wie lässt sich der räumliche Bezug in Worten beschreiben?',
+		'desc_dcat'  => '`dcatde:geocodingDescription` (DCAT-AP.de) ist eine frei formulierte textuelle Beschreibung der räumlichen Abdeckung (`literal`/`literal-lang`). Kardinalität 0..n. Ergänzt die maschinenlesbaren Angaben `dct:spatial` und `dcatde:politicalGeocodingURI` um eine menschenlesbare Erläuterung.',
+		'desc_human' => 'Beschreiben Sie den räumlichen Bezug zusätzlich in Worten — etwa wenn ein Gebietsschlüssel allein nicht genau genug ist. Das hilft Nutzenden, die Abdeckung einzuordnen. Beispiel: „Stadtgebiet Musterstadt ohne den Ortsteil X".',
+	),
 	array(
 		'key'        => 'spatial',
 		'meta_key'   => '_odw_spatial',

docs/FELD-REFERENZ.md

@@ -40,6 +40,7 @@ Legende der Stufen-Spalte: **Pflicht** (Veröffentlichung wird ohne dieses Feld
   - [Wie oft werden diese Daten aktualisiert?](#wie-oft-werden-diese-daten-aktualisiert)
   - [Auf welcher Verwaltungsebene wurden diese Daten erhoben?](#auf-welcher-verwaltungsebene-wurden-diese-daten-erhoben)
   - [Auf welches amtliche Gebiet beziehen sich die Daten?](#auf-welches-amtliche-gebiet-beziehen-sich-die-daten)
+  - [Wie lässt sich der räumliche Bezug in Worten beschreiben?](#wie-lässt-sich-der-räumliche-bezug-in-worten-beschreiben)
   - [Welche geografische Region betreffen diese Daten?](#welche-geografische-region-betreffen-diese-daten)
   - [Ab wann sind diese Daten gültig?](#ab-wann-sind-diese-daten-gültig)
   - [Bis wann sind diese Daten gültig?](#bis-wann-sind-diese-daten-gültig)
@@ -429,6 +430,23 @@ Legende der Stufen-Spalte: **Pflicht** (Veröffentlichung wird ohne dieses Feld
 
 **4 · Verständliche Langbeschreibung:** Verlinken Sie das genaue amtliche Gebiet, auf das sich die Daten beziehen — als offizielle Kennung (z. B. Gemeindeschlüssel). Damit ist eindeutig, welche Region gemeint ist. Beispiel: die URI zum amtlichen Gemeindeschlüssel Ihrer Stadt.
 
+### Wie lässt sich der räumliche Bezug in Worten beschreiben?
+
+| Eigenschaft | Wert |
+|---|---|
+| DCAT-Property | `dcatde:geocodingDescription` |
+| Meta-Key | `_odw_geocoding_description` |
+| Stufe | Optional |
+| Vokabular | — |
+
+**1 · DCAT-AP-Frage:** Wie lautet die `dcatde:geocodingDescription` (textuelle Beschreibung des räumlichen Bezugs)?
+
+**2 · Verständliche Frage:** Wie lässt sich der räumliche Bezug in Worten beschreiben?
+
+**3 · DCAT-AP-Langbeschreibung:** `dcatde:geocodingDescription` (DCAT-AP.de) ist eine frei formulierte textuelle Beschreibung der räumlichen Abdeckung (`literal`/`literal-lang`). Kardinalität 0..n. Ergänzt die maschinenlesbaren Angaben `dct:spatial` und `dcatde:politicalGeocodingURI` um eine menschenlesbare Erläuterung.
+
+**4 · Verständliche Langbeschreibung:** Beschreiben Sie den räumlichen Bezug zusätzlich in Worten — etwa wenn ein Gebietsschlüssel allein nicht genau genug ist. Das hilft Nutzenden, die Abdeckung einzuordnen. Beispiel: „Stadtgebiet Musterstadt ohne den Ortsteil X".
+
 ### Welche geografische Region betreffen diese Daten?
 
 | Eigenschaft | Wert |

includes/class-fields.php

@@ -308,6 +308,10 @@ private static function register_required_fields(): void {
 						->set_attribute( 'placeholder', 'http://dcat-ap.de/def/politicalGeocoding/regionalKey/09' )
 						->set_help_text( __( 'AMTLICHER GEBIETSSCHLÜSSEL (dcatde:politicalGeocodingURI)', 'open-data-wizard' ) . "\n\n" . __( 'URI des amtlichen Regional-/Gemeindeschlüssels (AGS/ARS). Beispiel: http://dcat-ap.de/def/politicalGeocoding/regionalKey/09', 'open-data-wizard' ) ),
 
+					Field::make( 'text', 'odw_geocoding_description', __( 'Wie lässt sich der räumliche Bezug in Worten beschreiben?', 'open-data-wizard' ) )
+						->set_attribute( 'placeholder', __( 'z.B. Stadtgebiet Musterstadt ohne Ortsteil X', 'open-data-wizard' ) )
+						->set_help_text( __( 'RÄUMLICHE BESCHREIBUNG (dcatde:geocodingDescription)', 'open-data-wizard' ) . "\n\n" . __( 'Freitextbeschreibung des räumlichen Bezugs, ergänzend zum amtlichen Gebietsschlüssel. Beispiel: Stadtgebiet Musterstadt', 'open-data-wizard' ) ),
+
 					Field::make( 'text', 'odw_spatial', __( 'Welche geografische Region betreffen diese Daten?', 'open-data-wizard' ) )
 						->set_attribute( 'placeholder', __( 'Region aus der Liste wählen oder eintippen…', 'open-data-wizard' ) )
 						->set_attribute( 'data-odw-autosuggest', 'spatial' )
@@ -350,18 +354,22 @@ private static function register_required_fields(): void {
 						->set_attribute( 'placeholder', 'https://beispiel.de/kontakt' )
 						->set_help_text( __( 'Website mit weiteren Kontaktinformationen.', 'open-data-wizard' ) . "\n\n" . __( 'Beispiel: https://beispiel.de/kontakt', 'open-data-wizard' ) ),
 
-					// Toggle: collapses all following Tab-4 fields into an opt-in
-					// "advanced/pro" section (progressive enhancement via odw-admin-fields.js).
-					Field::make( 'html', 'odw_pro_toggle' )
+					// "Erweiterte Angaben" — the groups below are individually
+					// collapsible (progressive enhancement via odw-admin-fields.js:
+					// each odw-section-toggle collapses its fields until the next).
+					Field::make( 'html', 'odw_ext_hint_pro' )
 					->set_html(
-						'<button type="button" class="odw-pro-toggle" data-odw-pro-toggle aria-expanded="false">'
-						. '<span class="odw-pro-caret" aria-hidden="true">▸</span> '
-						. esc_html__( 'Erweiterte Angaben (DCAT-AP.de, HVD, Zugriffsrechte) anzeigen', 'open-data-wizard' )
-						. '</button>'
+						'<h4 style="margin:20px 0 2px">' . esc_html__( 'Erweiterte Angaben (optional)', 'open-data-wizard' ) . '</h4>'
+						. '<p class="description" style="margin:0 0 4px">' . esc_html__( 'Für Profis: DCAT-AP.de-, HVD- und weitere Detailfelder. Öffnen Sie gezielt nur die Gruppen, die Sie brauchen.', 'open-data-wizard' ) . '</p>'
 					),
 
 					Field::make( 'html', 'odw_ext_hint_responsibility' )
-					->set_html( '<h4 style="margin:16px 0 4px">' . esc_html__( 'Verantwortlichkeiten & Herkunft', 'open-data-wizard' ) . '</h4>' ),
+					->set_html(
+						'<button type="button" class="odw-section-toggle" data-odw-section-toggle="responsibility" aria-expanded="false">'
+						. '<span class="odw-section-caret" aria-hidden="true">▸</span> '
+						. esc_html__( 'Verantwortlichkeiten & Herkunft', 'open-data-wizard' )
+						. '</button>'
+					),
 
 					Field::make( 'text', 'odw_contributor_id', __( 'Welche Stelle stellt diese Daten im GovData-Verbund bereit?', 'open-data-wizard' ) )
 						->set_attribute( 'data-odw-vocab', 'contributors' )
@@ -397,7 +405,12 @@ private static function register_required_fields(): void {
 						->set_help_text( __( 'QUALITÄTSPROZESS (dcatde:qualityProcessURI)', 'open-data-wizard' ) . "\n\n" . __( 'URL zur Beschreibung des Qualitätssicherungs-Prozesses (optional).', 'open-data-wizard' ) ),
 
 					Field::make( 'html', 'odw_ext_hint_access' )
-					->set_html( '<h4 style="margin:16px 0 4px">' . esc_html__( 'Zugriff & weitere Auffindbarkeit', 'open-data-wizard' ) . '</h4>' ),
+					->set_html(
+						'<button type="button" class="odw-section-toggle" data-odw-section-toggle="access" aria-expanded="false">'
+						. '<span class="odw-section-caret" aria-hidden="true">▸</span> '
+						. esc_html__( 'Zugriff & weitere Auffindbarkeit', 'open-data-wizard' )
+						. '</button>'
+					),
 
 					Field::make( 'select', 'odw_access_rights', __( 'Wer darf auf diese Daten zugreifen?', 'open-data-wizard' ) )
 						->add_options( self::get_access_rights_options() )
@@ -409,7 +422,12 @@ private static function register_required_fields(): void {
 						->set_help_text( __( 'ZUSÄTZLICHES THEMA (dcat:theme)', 'open-data-wizard' ) . "\n\n" . __( 'Optional ein weiteres Thema aus der offiziellen EU-Themenliste (ergänzt die Kategorie aus Tab 1).', 'open-data-wizard' ) ),
 
 					Field::make( 'html', 'odw_ext_hint_hvd' )
-					->set_html( '<h4 style="margin:16px 0 4px">' . esc_html__( 'High-Value-Datensatz (HVD)', 'open-data-wizard' ) . '</h4>' ),
+					->set_html(
+						'<button type="button" class="odw-section-toggle" data-odw-section-toggle="hvd" aria-expanded="false">'
+						. '<span class="odw-section-caret" aria-hidden="true">▸</span> '
+						. esc_html__( 'High-Value-Datensatz (HVD)', 'open-data-wizard' )
+						. '</button>'
+					),
 
 					Field::make( 'select', 'odw_is_hvd', __( 'Ist dies ein hochwertiger Datensatz (HVD)?', 'open-data-wizard' ) )
 						->add_options( self::get_hvd_flag_options() )
@@ -429,7 +447,12 @@ private static function register_required_fields(): void {
 						),
 
 					Field::make( 'html', 'odw_ext_hint_more' )
-					->set_html( '<h4 style="margin:16px 0 4px">' . esc_html__( 'Weitere DCAT-AP-Felder (optional)', 'open-data-wizard' ) . '</h4>' ),
+					->set_html(
+						'<button type="button" class="odw-section-toggle" data-odw-section-toggle="more" aria-expanded="false">'
+						. '<span class="odw-section-caret" aria-hidden="true">▸</span> '
+						. esc_html__( 'Weitere DCAT-AP-Felder (optional)', 'open-data-wizard' )
+						. '</button>'
+					),
 
 					Field::make( 'text', 'odw_identifier', __( 'Welche eindeutige Kennung hat dieser Datensatz?', 'open-data-wizard' ) )
 						->set_attribute( 'placeholder', __( 'z. B. DOI oder interne ID', 'open-data-wizard' ) )
@@ -474,7 +497,12 @@ private static function register_required_fields(): void {
 						->set_help_text( __( 'HERKUNFT (dct:provenance)', 'open-data-wizard' ) . "\n\n" . __( 'Freitext zur Entstehung und Herkunft der Daten.', 'open-data-wizard' ) ),
 
 					Field::make( 'html', 'odw_ext_hint_dist' )
-					->set_html( '<h4 style="margin:16px 0 4px">' . esc_html__( 'Distribution — erweitert', 'open-data-wizard' ) . '</h4>' ),
+					->set_html(
+						'<button type="button" class="odw-section-toggle" data-odw-section-toggle="dist" aria-expanded="false">'
+						. '<span class="odw-section-caret" aria-hidden="true">▸</span> '
+						. esc_html__( 'Distribution — erweitert', 'open-data-wizard' )
+						. '</button>'
+					),
 
 					Field::make( 'text', 'odw_dist_title', __( 'Wie heißt die bereitgestellte Datei/Distribution?', 'open-data-wizard' ) )
 						->set_help_text( __( 'TITEL DER DISTRIBUTION (dct:title)', 'open-data-wizard' ) . "\n\n" . __( 'Kurzer Titel der Distribution. Beispiel: Gesamtdaten als CSV', 'open-data-wizard' ) ),
@@ -1512,6 +1540,7 @@ function odw_build_dataset_jsonld( int $post_id ): ?array {
 	$accrual_periodicity       = (string) carbon_get_post_meta( $post_id, 'odw_accrual_periodicity' );
 	$political_geocoding_level = (string) carbon_get_post_meta( $post_id, 'odw_political_geocoding_level' );
 	$political_geocoding_uri   = (string) carbon_get_post_meta( $post_id, 'odw_political_geocoding_uri' );
+	$geocoding_description     = (string) carbon_get_post_meta( $post_id, 'odw_geocoding_description' );
 	$spatial                   = (string) carbon_get_post_meta( $post_id, 'odw_spatial' );
 	$temporal_start            = (string) carbon_get_post_meta( $post_id, 'odw_temporal_start' );
 	$temporal_end              = (string) carbon_get_post_meta( $post_id, 'odw_temporal_end' );
@@ -1744,6 +1773,10 @@ function odw_build_dataset_jsonld( int $post_id ): ?array {
 		$dataset['dcatde:politicalGeocodingURI'] = array( '@id' => odw_sanitize_jsonld_id( (string) $political_geocoding_uri ) );
 	}
 
+	if ( '' !== trim( (string) $geocoding_description ) ) {
+		$dataset['dcatde:geocodingDescription'] = odw_lang_literal( (string) $geocoding_description, $lang_tag );
+	}
+
 	if ( ! empty( $spatial ) ) {
 		$location = array(
 			'@type'          => 'dct:Location',

includes/class-shortcode.php

@@ -285,6 +285,7 @@ private static function collect_metadata_rows( int $post_id, string $license_lab
 		$add( __( 'Zugriffsrechte', 'open-data-wizard' ), self::meta( $post_id, 'odw_access_rights' ), true );
 
 		$add( __( 'Räumliche Abdeckung', 'open-data-wizard' ), self::meta( $post_id, 'odw_spatial' ) );
+		$add( __( 'Räumliche Beschreibung', 'open-data-wizard' ), self::meta( $post_id, 'odw_geocoding_description' ) );
 
 		$t_start = self::meta( $post_id, 'odw_temporal_start' );
 		$t_end   = self::meta( $post_id, 'odw_temporal_end' );