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