v5.0.0-rc1 - TYPO3 v14 Support (Release Candidate)

First release candidate of the TYPO3 v14 line. Major version bump - drops support for TYPO3 12 and 13.
Use the 4.x branch / ^4.0 for older TYPO3 versions.

⚠️ RC quality - please test in staging before deploying to production. Feedback welcome via issues.

Breaking Changes

• TYPO3 14 only. Requires typo3/cms-core: ^14.0 and typo3/cms-install: ^14.0.
• PHP 8.2+ required (8.2, 8.3, 8.4, 8.5 tested in CI).
• Removed PreviewController XClass - TYPO3 v14 ships a native preview implementation. Custom
  integrations relying on the XClass override need migration to the v14 hooks.
• Dropped dev dependencies: phpspec/prophecy-phpunit, saschaegerer/phpstan-typo3.
• Bumped composer constraints: typo3/cms-form: ^14.0, typo3/testing-framework: ^9.0.

New Features

• TYPO3 v14 compatibility across data processors, middlewares, SEO handling, and XClasses (#878).
• LanguageMenuProcessor - language menu data processor that cleans data automatically; use
  appendData if you need to keep/extend output.
• PHP 8.5 support added to CI matrix.

Improvements

• Refactored UrlUtility for cleaner language-aware URL generation (#882).
• Migrated remaining GeneralUtility::makeInstance calls to DI / typed factories where applicable.
• Tag manager improvements for v14 meta tag rendering.
• Annotated page/record methods on BackendEditorUrl as AsAllowedCallable for v14 compatibility (#876).
• Service signature fixes for the v14 DI container.
• Expanded unit test coverage across data processors, SEO, and utilities.

Bug Fixes

• Fixed link generation for TYPO3 14 (#886).
• Restored Forms integration that broke during the v14 migration.
• Final preview disabled pending v14 native preview integration.
• CI test fixes for the new TYPO3 14 / PHPUnit 11 stack.

Compatibility

	Version
TYPO3	^14.0
PHP	>= 8.2 (tested up to 8.5)
typo3/cms-form	^14.0
typo3/testing-framework	^9.0

Upgrading from 4.x

1. Bump typo3/cms-core and friendsoftypo3/headless in composer.json.
2. Verify any project XClasses against Classes/XClass/ - PreviewController is gone, others adjusted.
3. Re-check custom data processors against the renewed LanguageMenuProcessor if you build language
   menus.
4. Run your test suite - many internal signatures changed for v14.

Maintenance

The 4.x branch continues to receive critical bugfixes for the TYPO3 12/13 line. Open issues against that
branch where applicable.

Full Changelog: v4.8.0...v5.0.0-rc1

v4.8.0 Release

What's New in 4.8.0

Bug Fixes

• Fixed Dependency Injection for RootSiteProcessor (#848)
• Corrected array index in request header checks for JSON acceptance (#853)
• Conditional ParseFunc loading (#851)
• Fixed workspace preview implementation (#855)
• Disabled GIF processing and updated related tests (#859, #860)
• Suppressed warning when TYPO3_REQUEST is unavailable (#861)
• Improved language-based URL handling (#871)
• Refactored USER_INT unwrapping (#869)

Tasks & Documentation

• Improved documentation for feature flags (#874)
• Release 4.8.0 (#884)

Dependencies

• Bump actions/checkout from 5 to 6 (#858)
• Bump actions/cache from 4 to 5 (#862)

New Contributors

• @ecRobertEngel made their first contribution in #853

Full Changelog: v4.7.3 → v4.8.0

v4.7.3 - bugfix release

Compatibility release with latest TYPO3 13.4.18 (security) version.

What's Changed

• [BUGFIX] Align method parameters by @twoldanski in #844
• [TASK] Set extension version to 4.7.3 by @twoldanski in #845

Full Changelog: v4.7.2...v4.7.3

v4.7.2 Bugfix release

What's Changed

Fixed issue with PreviewController and FlexFormProcessor in latest TYPO3 v13 version.

• [BUGFIX] Fix issues with >= v13.4.16 by @twoldanski in #841
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in #838
• [TASK] Set version v4.7.2 by @twoldanski in #842

Full Changelog: v4.7.1...v4.7.2

v4.7.1 Bugfix release

What's Changed

• [BUGFIX] Add missing use statement for HeadlessModeInterface by @aseemann in #831
• [BUGFIX] Fix middleware handling when headless.cookieDomainPerSite … by @twoldanski in https://github.com/TYPO3

New Contributors

• @aseemann made their first contribution in #831

Full Changelog: v4.7.0...v4.7.1

v4.7.0 Feature release

TYPO3 Headless v4.7.0

🐛 Bug Fixes

• Allow headless.redirectMiddlewares feature without EXT:redirects ([@dvdmlln][#809])
• Simplify DatabaseQueryProcessor handling ([@twoldanski][#818])
• Fix nullable check for layout ([@SvenLie][#814])
• Fix URL generation for shortcuts ([@twoldanski][#825])
• Add missing cookie-domain middleware inside frontend middlewares ([@kubilaymelnikov][#813])
• Improve meta tag handling ([@twoldanski][#823])
• Make Translator service public ([@twoldanski][#828])
• Ensure relative path is not empty ([@twoldanski][#827])

✨ Improvements & Tasks

• Improve docs on DataProcessors ([@kitzberger][#817])
• Add proper support for PHP 8.4 ([@twoldanski][#811])

🌟 New Contributors

• @SvenLie made their first contribution ([@SvenLie][#814])

Full Changelog:
v4.6.0...v4.7.0

v4.6.0 Feature release

🚀 Headless v4.6.0 Release Notes

🎉 What's New

✨ Features

• Backend editor links on frontend – Added links for backend editing directly on the frontend. #800
• Extended configuration support – Now supports config.htmlTag & page.bodyTagAdd. #802
• Nuxt-TYPO3 SEO tags compatibility – By default, body tag classes are now generated for Nuxt-TYPO3. #803

🐛 Bug Fixes

• File URL rendering – Fixed an issue where file URLs contained double slashes. #796
• Login hash generation – Improved hash generation for v13 in LoginFormViewHelper. #804
• Database Query Processor – Improved handling of returnFlattenObject in Headless DatabaseQueryProcessor. #807

🔧 Tasks & Improvements

• Clear messaging for colPos – Improved clarity when grouping is enabled. #806

📌 Full Changelog: v4.5.0 → v4.6.0

v3.4.3 Bufix release

What's Changed

• [BUGFIX] Add option to process SVG files by @twoldanski in #783

Full Changelog: v3.4.2...v3.4.3

v4.5.0 Feature release - TYPO3 v13 compatibility

We are excited to announce the release of TYPO3 Headless v4.5.0! This version brings significant changes, including compatibility with TYPO3 v13 and implementation of Sets.

🔄 What's Changed

• [FEATURE] ✨ Added compatibility with TYPO3 v13 by @twoldanski in #778
• [FEATURE] 🛠️ Introduced the barebone site set configuration, allowing other extensions to access it by @tobiasquadflieg in #793

👥 New Contributors

A special thank you to our new contributor:

• @tobiasquadflieg made their first contribution in #793

📜 For a complete list of changes, please refer to the full changelog.

Thank you for your continued support and contributions to TYPO3 Headless! 🙏

v4.4.1 Hotfix release

What's Changed

v4.4.1 release brings fix for ext:felogin on TYPO3 version 12.4.21.
Also, introduced additional check if ext:seo is loaded.

Changelog

• [TASK] Bump typo3/coding-standards & align code-style by @twoldanski in #779
• [BUGFIX] Wrap loading of seo functionality in isLoaded clause by @thomashohn in #781
• [BUGFIX] Fix for felogin on v12.4.21 by @lukaszuznanski in #786

New Contributors

• @thomashohn made their first contribution in #781

Full Changelog: v4.4.0...v4.4.1