53 lines
1.9 KiB
ReStructuredText
53 lines
1.9 KiB
ReStructuredText
.. include:: /Includes.rst.txt
|
|
|
|
.. _deprecation-101807-1693474000:
|
|
|
|
====================================================================
|
|
Deprecation: #101807 - ExtensionManagementUtility::addUserTSConfig()
|
|
====================================================================
|
|
|
|
See :issue:`101807`
|
|
|
|
Description
|
|
===========
|
|
|
|
The method :php:`\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addUserTSConfig()`
|
|
has been marked as deprecated in TYPO3 v13 and will be removed with TYPO3 v14.
|
|
|
|
The global configuration option :php:`$GLOBALS['TYPO3_CONF_VARS']['BE']['defaultUserTSconfig']`
|
|
has been marked as deprecated in TYPO3 v13, will be ignored and removed from instance configuration
|
|
files as silent upgrade with TYPO3 v14.
|
|
|
|
|
|
Impact
|
|
======
|
|
|
|
Setting default user TSconfig using :php:`ExtensionManagementUtility::addUserTSConfig()`
|
|
in :file:`ext_localconf.php` files has been superseded by
|
|
:ref:`Automatic inclusion of user TSconfig of extensions <feature-101807-1693473782>`. The
|
|
old way has been deprecated, extensions should switch to the new functionality by placing
|
|
default user TSconfig in :file:`Configuration/user.tsconfig` files.
|
|
|
|
|
|
Affected installations
|
|
======================
|
|
|
|
Instances with extensions using :php:`ExtensionManagementUtility::addUserTSConfig()`
|
|
or directly extending :php:`$GLOBALS['TYPO3_CONF_VARS']['BE']['defaultUserTSconfig']`
|
|
are affected: Using :php:`ExtensionManagementUtility::addUserTSConfig()` triggers a
|
|
deprecation level log message. The extension scanner will find usages of
|
|
:php:`ExtensionManagementUtility::addUserTSConfig()` as strong match.
|
|
|
|
|
|
Migration
|
|
=========
|
|
|
|
Add default user TSconfig to a :file:`Configuration/user.tsconfig` file within an
|
|
extension and remove calls to :php:`ExtensionManagementUtility::addUserTSConfig()`.
|
|
|
|
Extensions with compatibility for both TYPO3 v12 and v13 should keep the old
|
|
way and switch to the new way when v12 support is dropped.
|
|
|
|
|
|
.. index:: LocalConfiguration, PHP-API, TSConfig, FullyScanned, ext:core
|