Changelog
All notable changes to this project are documented here.
Version 5.0.0
This is a major release targeting TYPO3 v13.4 LTS and v14.3 LTS. It also fixes several defects, two of which were already silent on TYPO3 v13.
Breaking Changes
- Dropped TYPO3 v12.4 support - use version 4.x for TYPO3 v12.4
- Removed
ext_- deprecated in TYPO3 v14.3 (forge#109438)tables. php - Removed
FrontendControllerService::registerQueryParameter(),::createHashBase()and::configArrayPostProc() - Removed
PageService::createHashBase()- use the publicPageService::getHashString() - Removed the empty
CacheHashEventListener - Removed the protected
AbstractContext::getTypoScriptFrontendController()andAbstractContext::getIndpEnv()- custom context types usegetRequest(),getFrontendUser()andgetNormalizedParams() - Dropped the unused
typo3/cms-extbaseandtypo3/cms-extensionmanagerrequirements - no class of either package is referenced - Removed the site set settings
contexts.matchModeandcontexts.cacheLifetimeModifier- neither was ever read by the extension Configuration::no longer writes the FlexForm file intoregister Context Type () TCA[tx_contexts_contexts][columns][type_conf][config][ds]; the data structure is resolved from the context type registry instead
Bug Fixes
- Context records can be edited on TYPO3 v14.3 again -
ds_pointerFieldand the multi-entrydsarray were removed in TYPO3 v14.0 (forge#107047), so every read oftx_contexts_contexts.type_confthrew anInvalidTcaException.FlexFormDataStructureEventListenerresolves the data structure through the PSR-14BeforeFlexFormDataStructure*events, which behave identically on v13.4 and v14.3 - Frontend caches are invalidated when a context record changes - saving,
deleting or restoring a context flushes the
pagescache group. TYPO3 caches theModifyresult under an identifier derived from the TypoScript sources, so a new or renamed GET parameter context previously never reachedTypo Script Config Event config.link Vars - Session context matches again - the frontend user is read from the
frontend.userrequest attribute instead of theTypoScriptFrontendControllerremoved in TYPO3 v14 (forge#107831). The same applies to theuse_sessionpersistence of the GET parameter context - Context-aware page caching works again - the active contexts and the
values of all context GET parameters are added to the page cache identifier
via
\TYPO3\, replacing theCMS\ Frontend\ Event\ Before Page Cache Identifier Is Hashed Event createHashBasehook removed in TYPO3 v13.0 (forge#102932) - config.linkVars works again - the GET parameters of all query parameter
contexts are appended via
\TYPO3\, replacing the removedCMS\ Frontend\ Event\ Modify Typo Script Config Event configArrayPostProchook - Page tree restrictions are no longer dropped - the
PageTreeRepositoryXCLASS forwards the third$additionalQueryRestrictionsconstructor argument, sooptions.pageTree.excludeDoktypesis honoured again - Removed the write to
$TYPO3_CONF_VARS['FE']['addRootLineFields'], removed in TYPO3 v13.2 (forge#103752)
Improvements
- CI matrix covers TYPO3
^13.4and^14.3on PHP 8.2 - 8.5 composer.declaresjson extra.typo3/cms.versionandextra.typo3/cms.Package.providesPackages(forge#108345)- Rector and Fractor run the TYPO3 v14 rule sets; the one rule that may not be applied while TYPO3 v13.4 is supported is skipped explicitly
- PHPStan enables
reportUnmatchedIgnoredErrorsand drops the 27 ignore patterns that no longer matched anything - DDEV development environment provides TYPO3 v13 and v14 instances
Version 4.0.0
Release date: 2026-03-01
This is a major release with TYPO3 v12/v13 support and significant modernization.
Breaking Changes
- Dropped TYPO3 v11 support - Use version 3.x for TYPO3 v11
- Dropped PHP 7.4/8.0/8.1 support - Minimum PHP 8.2 required
- Removed SC_OPTIONS hooks - Migrated to PSR-14 events
- PHPUnit 10/11/12/13 required - Test code must use new patterns
New Features
- TYPO3 v12.4 LTS support - Full compatibility with TYPO3 v12
- TYPO3 v13.4 LTS support - Full compatibility with TYPO3 v13
- Site Sets support - Modern site configuration for TYPO3 v13
- PHP 8.2/8.3/8.4/8.5 support - Latest PHP versions supported
- PSR-14 events - Modern event dispatching system
- PHP 8 Attributes - Native attribute-based configuration
- Docker-based runTests.sh - TYPO3 core testing pattern
Improvements
- Modernized codebase with strict types
- Enhanced IDE support through better typing
- Improved test coverage (target: 80%+)
- Mutation testing - Infection with MSI > 80%
- PHPStan level 10 compliance
- Updated coding standards (PSR-12)
Migration
See Migration Guide for detailed upgrade instructions.
Version 3.x
Legacy version supporting TYPO3 v10 and v11. No longer actively developed. Use version 4.0+ for new installations.
Version 2.x
Legacy version supporting TYPO3 v8 and v9. End of life.
Version 1.x
Initial release for TYPO3 v6 and v7. End of life.