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