[TASK] Alias Fluid's AbstractNode to ViewHelperNode for backwards compatibility
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Breaking-73046-AliasAbstractNode-ViewHelperNodeForBackwardsCompatibility.rst
1 ===================================================================================
2 Breaking: #73046 - Alias AbstractNode -> ViewHelperNode for backwards compatibility
3 ===================================================================================
4
5 Description
6 ===========
7
8 ViewHelperInterface::compile() in standalone Fluid now requires an actual ViewHelperNode instead of AbstractNode as it was before.
9 The reason for changing this should be fairly obvious. In order to preserve signature compatibility an alias is put in place.
10
11 The alias is created so that TYPO3\CMS\Fluid\Core\Parser\SyntaxTree\AbstractNode becomes an alias of TYPO3Fluid\Fluid\Core\Parser\SyntaxTree\ViewHelperNode.
12 This is obviously less than ideal but solves the problem immediately and prioritises not breaking the public API by somewhat
13 breaking the non-public API.
14
15
16 Impact
17 ======
18
19 This signature change means that ViewHelpers which implement a custom compile() method must update their signature (dot not apply
20 to ViewHelpers implementing only renderStatic). Two ViewHelpers in TYPO3 CMS Fluid were migrated as part of the standalone Fluid
21 merge - but third-party ViewHelpers would require either migration or an alias.
22
23 * Overridden TemplateParsers (before standalone Fluid merge) might not function, depending on the nature of overrides (conditions
24   checking class names may fail)
25 * Custom Nodes (implemented via an overridden TemplateParser, before standalone Fluid) would break either in function or form
26   (incompatible constructor signatures on php7 at least)
27
28
29 Affected Installations
30 ======================
31
32 Any TYPO3 site using an extension which replaces or directly interacts with TemplateParser or TemplateCompiler from Fluid. Only
33 known affected community extension is at this point EXT:builder, specifically the template validation/analysis feature.
34
35
36 Migration
37 =========
38
39 Change any reference to classes in ``TYPO3\CMS\Fluid\Core\TemplateParser`` to ``TYPO3Fluid\Fluid\Core\TemplateParser``.