[DOCS] 7.5 Docs Part 7/4
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 7.5 / Deprecation-69057-DeprecateIconUtilityAndMoveMethodsIntoIconFactory.rst
1 =============================================================================
2 Deprecation: #69057 - Deprecate IconUtility and move methods into IconFactory
3 =============================================================================
4
5 Description
6 ===========
7
8 The ``IconUtility`` class will be removed with TYPO3 CMS 8. All public methods of this class have been marked as deprecated:
9
10 * ``IconUtility::skinImg()``
11 * ``IconUtility::getIcon()``
12 * ``IconUtility::getSpriteIcon()``
13 * ``IconUtility::getSpriteIconForFile()``
14 * ``IconUtility::getSpriteIconForRecord()``
15 * ``IconUtility::getSpriteIconForResource()``
16 * ``IconUtility::getSpriteIconClasses()``
17
18 The PageTSConfig setting ``mod.wizards.newContentElement.wizardItems.*.elements.*.icon`` also has been marked as deprecated.
19
20 The ``IconUtilityOverrideResourceIconHookInterface`` interface will be removed with TYPO3 CMS 8.
21
22
23 Impact
24 ======
25
26 Any usage of these methods will trigger a deprecation log entry.
27
28
29 Affected Installations
30 ======================
31
32 Extensions that call these PHP methods directly.
33 Extensions that register own content elements with an icon for the new content element wizard.
34
35
36 Migration
37 =========
38
39 Use the new ``IconFactory`` class instead of ``IconUtility``.
40
41 For content element wizard register your icon in ``IconRegistry::registerIcon()`` and use the new setting:
42 ``mod.wizards.newContentElement.wizardItems.*.elements.*.iconIdentifier``