[BUGFIX] Ensure manually updated slug is saved correctly
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.0 / Deprecation-72827-ModuleIconConfigurationViaLabelstabs_imagestab.rst
1
2 .. include:: ../../Includes.txt
3
4 ==============================================================================
5 Deprecation: #72827 - Module Icon configuration via [labels][tabs_images][tab]
6 ==============================================================================
7
8 See :issue:`72827`
9
10 Description
11 ===========
12
13 When registering a non-extbase module, the option to configure an icon was
14 previously done with the module configuration option `[labels][tabs_images][tab]`.
15 To clarify the naming, the property "icon" is introduced which expects a reference
16 to the icon via the `EXT:myextension/path/to/the/file.png` syntax.
17
18 The old option `[labels][tabs_images][tab]` has been marked as deprecated.
19
20
21 Impact
22 ======
23
24 When using the old configuration property `[labels][tabs_images][tab]`, a
25 deprecation message is thrown.
26
27
28 Affected Installations
29 ======================
30
31 Installations with custom backend non-extbase modules of third-party-extensions that
32 still use the old configuration property.
33
34
35 Migration
36 =========
37
38 Replace the `[labels][tabs_images][tab]` with `[icon]` in `ext_tables.php` in
39 your extension like this:
40
41 .. code-block:: php
42
43     \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addModule(
44         'system',
45         'dbint',
46         '',
47         '',
48         array(
49             'routeTarget' => \TYPO3\CMS\Lowlevel\View\DatabaseIntegrityView::class . '::mainAction',
50             'access' => 'admin',
51             'name' => 'system_dbint',
52             'workspaces' => 'online',
53             'icon' => 'EXT:lowlevel/Resources/Public/Icons/module-dbint.svg',
54             'labels' => 'LLL:EXT:lowlevel/Resources/Private/Language/locallang_mod.xlf'
55         )
56     );
57
58 .. index:: PHP-API, Backend