structured-content — semantische Metadaten, die vererbt werden.

Architektur

Classes/
├── Domain/          # Annotation-Modelle, Beziehungstypen, Contracts
├── Application/     # Context-Resolution, Relationship-Services
├── Infrastructure/  # Repositories, JSON-LD-Builder, Context-Resolver
└── Presentation/    # Controller, Event-Listener

Datenbank-Tabellen

Schema.org-Generator-Stack

Alle Generatoren in Classes/Infrastructure/SchemaOrg/ implementieren SchemaGeneratorInterface, werden via Service-Tag structured_content.schema_generator registriert und nach priority gerendert (höher = früher im JSON-LD-Block).

Builder und Traits

Application/Service/PersonSchemaBuilder.buildFromRow($personRow) emittet Person mit worksFor[], sameAs[] (mit Label|URL-Pipe-Format), knowsAbout, knowsLanguage und image. PersonRoutingArgumentTrait resolved den person-Slug aus den _routingArguments der Person-Plugin-Detail-View. PodcastFeedCacheReaderTrait liest gecachte Feed-Items für Podcast-Schemata ohne Re-Fetch. SanitizesSchemaTrait filtert leere und nicht-JSON-konforme Werte. ContextAndRelationshipsTrait hängt AI-Context und Relationships an den Schema-Output.

Repositories

AuthoredPagesRepository.findByPersonUid findet Pages, die tx_structuredcontent_author_records mit der Person verknüpfen (für Person.hasPart). CategoryRepository.findByPageUid liest sys_category-Records via sys_category_record_mm (für Article.articleSection). EpisodeGuestsRepository liefert Bulk episode_slug → Person[] für PodcastEpisode.actor.

Article-Schema-Erweiterungen (AI Disclosure, Reading Time, Language Fallback)

AI Content Disclosure (v1.5.10+)

Article-Schema enthält bei AI-getaggten Hero-Bildern image: {creator: {SoftwareApplication, name}, creditText: "AI-generated"}. Damit ist die EU-AI-Act-Artikel-50-Disclosure direkt im JSON-LD verankert. Pflege über die TCA-Felder aus moselwal/content-provenance (tx_provenance_origin, tx_provenance_ai_system).

Reading Time (v1.5.9+)

Article-Schema enthält wordCount und timeRequired (ISO-8601 PT*M) — byte-identisch zur Frontend-Reading-Time-Badge (200 Wörter pro Minute). Vereinheitlicht die Reading-Time-Anzeige zwischen Markup und User-Sicht.

Language-Fallback in Schema-Generators (v1.5.7+)

Translation-aware: Default-Sprache-Records werden geladen und EN-Translations overlay'd. Der Schema-Output funktioniert auch unter fallbackType: fallback ohne Lücken — unvollständige Lokalisierungen führen nicht mehr zu fehlendem Schema-Markup.

Relationship-Type-Mappings (Schema.org)

• replaces → isBasedOn
• belongs_to → isPartOf
• related_to → relatedLink
• explains → about

Sys-Category-Mapping

Erweiterung von sys_category um ein slug-Feld (auto aus Titel) für Filter-URLs und um eine RTE-Description für Kategorie-Hero-Blöcke. Im Article-JSON-LD wird die Kategorie als articleSection emittiert.

CLI-Befehle

vendor/bin/typo3 structured-content:missing-context   # Seiten ohne AI-Kontext finden
vendor/bin/typo3 structured-content:export-relations   # Beziehungen als JSON exportieren
vendor/bin/typo3 structured-content:validate-channels  # Channel-Konfiguration prüfen

Konfiguration

AI-Context-Felder werden in den TYPO3-Formularen für Seiten und Inhaltselemente ergänzt. Default-Werte und Vererbungsverhalten konfigurieren Sie über die Site Settings.

Voraussetzungen

• PHP 8.3+
• TYPO3 14.0

Optionale Abhängigkeiten

Die Architektur folgt strikt der DDD-4-Layer-Trennung; Layer-Verstöße werden über deptrac in CI verhindert.

Setzen wir ein bei …

Dieses Paket ist Teil der Plattform-Linie zu AI-Ready CMS und AI-Ready Commerce — als semantischer Layer, der Inhalte für Retrieval-Systeme und Agenten lesbar macht. In der betreuten Variante: AI-Ready CMS as a Service.