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