Commit c789ef8f authored by Jonas Eberle's avatar Jonas Eberle Committed by Benni Mack
Browse files

[TASK] Fix sphinx warnings in ChangeLog

This fixes some functional and visual problems in the ChangeLog:
* The use of code backticks in a headline was removed as it was also
  output as <blockquote> on the overview page.
* All warnings regarding intersphinx cross-referencing have been fixed.
* The unsupported text role :mysql: has been replaced by :sql:.

The rest of the warnings seem to come from the build command or will
automatically be fixed after the master branching is done:

WARNING: unsupported theme option 'show_sphinx' given
WARNING: unsupported theme option u'show_legalinfo' given
WARNING: unsupported theme option 'use_opensearch' given
WARNING: unsupported theme option 'show_revision' given
/Documentation/Master.rst:11: WARNING: toctree contains reference to
nonexisting document u'Changelog/master/Index'

Releases: master
Resolves: #91118
Change-Id: I290bf8879bbee66f030a32de45ea765fd40a1b92
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/64237

Tested-by: default avatarBjörn Jacob <bjoern.jacob@tritum.de>
Tested-by: default avatarTYPO3com <noreply@typo3.com>
Tested-by: Benni Mack's avatarBenni Mack <benni@typo3.org>
Reviewed-by: default avatarBjörn Jacob <bjoern.jacob@tritum.de>
Reviewed-by: Benni Mack's avatarBenni Mack <benni@typo3.org>
parent 21b63bd7
.. include:: ../../Includes.txt
=====================================================
Deprecation: #89463 - `Switchable Controller Actions`
=====================================================
===================================================
Deprecation: #89463 - Switchable Controller Actions
===================================================
See :issue:`89463`
Description
===========
`Switchable controller actions` have been marked as deprecated and will be removed in one of the next major versions
Switchable controller actions have been marked as deprecated and will be removed in one of the next major versions
of TYPO3, probably version 11.0 or 12.0.
:ts:`Switchable controller actions` are used to override the allowed set of controllers and actions via TypoScript or plugin
Switchable controller actions are used to override the allowed set of controllers and actions via TypoScript or plugin
flexforms. While this is convenient for reusing the same plugin for a lot of different use cases, it's also very
problematic as it completely overrides the original configuration defined via
:php:`\TYPO3\CMS\Extbase\Utility\ExtensionUtility::configurePlugin`.
:ts:`Switchable controller actions` therefore have bad implications that rectify their removal.
Switchable controller actions therefore have bad implications that rectify their removal.
First of all, :ts:`switchable controller actions` override the original configuration of plugins at runtime and possibly
First of all, switchable controller actions override the original configuration of plugins at runtime and possibly
depending on conditions which contradicts the idea of :php:`\TYPO3\CMS\Extbase\Utility\ExtensionUtility::configurePlugin`
being the authoritative way to define configuration.
Using the same plugin as an entry point for many different functionalities contradicts the idea of a plugin serving one
specific purpose. :ts:`Switchable controller actions` allow for creating one central plugin that takes care of everything.
specific purpose. Switchable controller actions allow for creating one central plugin that takes care of everything.
Impact
======
All plugins that are using :ts:`switchable controller actions` need to be split into multiple different plugins. Usually, one
would create a new plugin for each possible :ts:`switchable controller actions` configuration entry.
All plugins that are using switchable controller actions need to be split into multiple different plugins. Usually, one
would create a new plugin for each possible switchable controller actions configuration entry.
Affected Installations
======================
All installations that make use of :ts:`switchable controller actions`, either via flexform configuration of plugins or via
All installations that make use of switchable controller actions, either via flexform configuration of plugins or via
TypoScript configuration.
Migration
=========
Unfortunately, an automatic migration is not possible. As :ts:`switchable controller actions` allowed to override the whole
Unfortunately, an automatic migration is not possible. As switchable controller actions allowed to override the whole
configuration of allowed controllers and actions, the only way to migrate is to create dedicated plugins for each former
:ts:`switchable controller actions` configuration entry.
switchable controller actions configuration entry.
Example:
......@@ -101,7 +101,7 @@ it is possible to properly define which action should be cached.
In addition, TYPO3 v10 LTS allows to group plugins in FormEngine directly
to semantically register various plugins in one specific group.
See https://docs.typo3.org/c/typo3/cms-core/master/en-us/Changelog/10.4/Feature-91008-ItemGroupingForTCASelectItems.html
See :ref:`changelog-Feature-91008-ItemGroupingForTCASelectItems`
for more details.
......
.. include:: ../../Includes.txt
============================================================
Feature: #90213 - Support `bit and` in TypoScript stdWrap_if
Feature: #90213 - Support 'bit and' in TypoScript stdWrap_if
============================================================
See :issue:`90213`
......
.. include:: ../../Includes.txt
========================================================================================
Important: #90236 - Respect extension state `excludeFromUpdates` during language updates
Important: #90236 - Respect extension state 'excludeFromUpdates' during language updates
========================================================================================
See :issue:`90236`
......@@ -12,7 +12,7 @@ Description
If the state property inside :file:`ext_emconf.php` is set to `excludeFromUpdates`,
the extension will be skipped while updating the language files in the Install Tool.
This setting is especially helpful if you create a custom extension which uses the same extension
This setting is especially helpful if you create a custom extension which uses the same extension
key as an existing TER extension.
.. index:: Backend, ext:core
......@@ -12,7 +12,7 @@ Description
The class :php:`\TYPO3\CMS\Extbase\Domain\Model\FileMount` has been marked as deprecated.
The :php:`FileMount` is an internal class which never really had any functionality
besides being an Extbase model for the database table :mysql:`sys_filemounts`. Therefore
besides being an Extbase model for the database table :sql:`sys_filemounts`. Therefore
and in order to streamline the codebase of Extbase, the class :php:`FileMount` will be removed with TYPO3 11.0.
......
.. include:: ../../Includes.txt
.. _changelog-Feature-90899-IntroduceAssetPreRenderingEvents:
==============================================================
Feature: #90899 - Introduce AssetRenderer pre-rendering events
==============================================================
......@@ -124,6 +126,4 @@ Related
- :ref:`changelog-Feature-90522-IntroduceAssetCollector`
.. _changelog-Feature-90899-IntroduceAssetPreRenderingEvents:
.. index:: PHP-API, ext:core
.. include:: ../../Includes.txt
.. _changelog-Feature-91008-ItemGroupingForTCASelectItems:
====================================================
Feature: #91008 - Item grouping for TCA select items
====================================================
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment