web-vision / unity-schema

1.0.2 2026-09-25 15:05 UTC

Requires

• php: ^8.1 || ^8.2 || ^8.3 || ^8.4
• brotkrueml/schema: ^3.15
• typo3/cms-backend: ^12.4
• typo3/cms-core: ^12.4
• typo3/cms-filelist: ^12.4
• typo3/cms-frontend: ^12.4
• typo3/cms-tstemplate: ^12.4
• web-vision/wv_t3unity: ^3.0

Requires (Dev)

• b13/container: ^3.0
• friendsofphp/php-cs-fixer: ^3.94.2
• helmich/typo3-typoscript-lint: ^3.3
• phpstan/phpstan: ^1.10.9
• saschaegerer/phpstan-typo3: ^1.10.2
• sbuerk/fixture-packages: ^1.1
• sbuerk/typo3-site-based-test-trait: ^1
• typo3/cms-dashboard: ^12.4
• typo3/cms-extbase: ^12.4
• typo3/cms-extensionmanager: ^12.4
• typo3/cms-felogin: ^12.4
• typo3/cms-filemetadata: ^12.4
• typo3/cms-fluid: ^12.4
• typo3/cms-fluid-styled-content: ^12.4
• typo3/cms-form: ^12.4
• typo3/cms-indexed-search: ^12.4
• typo3/cms-info: ^12.4
• typo3/cms-install: ^12.4
• typo3/cms-linkvalidator: ^12.4
• typo3/cms-lowlevel: ^12.4
• typo3/cms-seo: ^12.4
• typo3/cms-setup: ^12.4
• typo3/testing-framework: ^8.3.3

GPL-2.0-or-later

• web-vision GmbH

Published on Packagist.org on 2026-09-25 15:05 UTC

README

schema.org integration for TYPO3 Unity (web-vision/wv_t3unity). It enriches Unity's headless "head data" JSON response with rich structured data (JSON-LD), rendered through EXT:schema (brotkrueml/schema).

What it does

• Adds a WebPage (or a more specific subtype, e.g. AboutPage, FAQPage, ...) schema.org node for every page, based on the page's tx_schema_webpagetype field (provided by EXT:schema).
• Reliably exposes EXT:schema's own RenderAdditionalTypesEvent inside Unity's head request, so any PSR-14 listener that adds structured data through the documented EXT:schema API actually gets rendered - see DEVELOPER.md for why this needs an extra step in Unity.
• Lets editors and integrators turn any content element into a schema.org type (Article, Product, SoftwareApplication, a Question for an FAQPage, ...) via a few TCA fields, without any PHP - see INTEGRATOR.md.
• Provides a small extension point (StructuredDataProviderInterface) plus reusable helpers (content element fetching, FAL image metadata) for structured data that needs repeatable child items (carousels, FAQ question lists, product offers, ...) - see DEVELOPER.md.

Requirements

• TYPO3 ^12.4
• PHP ^8.1
• brotkrueml/schema ^3.15
• web-vision/wv_t3unity

Installation

composer require web-vision/unity-schema

Then include the extension's TypoScript (EXT:unity_schema/Configuration/TypoScript/) in your site package, alongside EXT:wv_t3unity's and EXT:schema's TypoScript.

Documentation

• INTEGRATOR.md - for editors/integrators: which fields to fill in, worked examples per schema.org type, and where the limits of the no-code approach are.
• DEVELOPER.md - for developers: the Unity-specific architecture quirk this extension works around, and how to implement custom structured data providers for a consuming project.