[!!!][FEATURE] Streamline Fluid Styled Content and CSS Styled Content
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Breaking-79622-RemovalOfFluidStyledContentMenuViewHelpers.rst
1 .. include:: ../../Includes.txt
2
3 ===================================================================
4 Breaking: #79622 - Removal of Fluid Styled Content Menu ViewHelpers
5 ===================================================================
6
7 See :issue:`79622`
8
9 Description
10 ===========
11
12 Fetching data directly in the view is not recommended and the temporary
13 solution of menu viewhelpers are now replaced by it´s successor the menu
14 processor that is based on HMENU.
15
16 Menu ViewHelpers have been moved to the `compatibility7` extension, and are
17 replaced in the core menu content elements.
18
19 List of removed ViewHelpers:
20 - menu.categories
21 - menu.directory
22 - menu.keywords
23 - menu.list
24 - menu.section
25 - menu.updated
26
27
28 Affected Installations
29 ======================
30
31 All installations that use the `fluid_styled_content` menu viewhelpers.
32
33
34 Migration
35 =========
36
37 Use `TYPO3\CMS\Frontend\DataProcessing\MenuProcessor` instead of viewhelpers.
38
39 For CMS 8 the viewhelpers will be available as soon as `compatibility7` is
40 installed, but it´s highly recommended to migrate your configuration.
41
42 Example (Directory)
43 -------------------
44
45 Before:
46
47 .. code-block:: typoscript
48
49    tt_content.menu_subpages.dataProcessing {
50       10 = TYPO3\CMS\Frontend\DataProcessing\SplitProcessor
51       10 {
52          if.isTrue.field = pages
53          fieldName = pages
54          delimiter = ,
55          removeEmptyEntries = 1
56          filterIntegers = 1
57          filterUnique = 1
58          as = pageUids
59       }
60    }
61
62 .. code-block:: html
63
64    <ce:menu.directory pageUids="{pageUids}" as="pages" levelAs="level">
65       <f:for each="{pages}" as="page">
66          ...
67       </f:for>
68    </ce.menu.directory>
69
70 After:
71
72 .. code-block:: typoscript
73
74    tt_content.menu_subpages.dataProcessing {
75       10 = TYPO3\CMS\Frontend\DataProcessing\MenuProcessor
76       10.special = directory
77       10.special.value.field = pages
78    }
79
80 .. code-block:: html
81
82    <f:for each="{menu}" as="page">
83       ...
84    </f:for>
85
86 .. index:: Fluid, Frontend