From 205003f9de014d4dfb0cb076a4124826686bed01 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Chris=20M=C3=BCller?= <2566282+brotkrueml@users.noreply.github.com> Date: Mon, 4 Mar 2024 10:36:59 +0100 Subject: [PATCH 1/3] [FEATURE] #103211 - Introduce tree node labels Related: https://github.com/TYPO3-Documentation/Changelog-To-Doc/issues/864 Releases: main --- .../List/optionsPageTreeLabel.png | Bin 0 -> 6906 bytes Documentation/UserTsconfig/Options.rst | 44 ++++++++++++++++++ 2 files changed, 44 insertions(+) create mode 100644 Documentation/Images/ManualScreenshots/List/optionsPageTreeLabel.png diff --git a/Documentation/Images/ManualScreenshots/List/optionsPageTreeLabel.png b/Documentation/Images/ManualScreenshots/List/optionsPageTreeLabel.png new file mode 100644 index 0000000000000000000000000000000000000000..9dd79a26633e24e7b782ccb5f373f06693d941e2 GIT binary patch literal 6906 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 F{~wyzUE%-$ literal 0 HcmV?d00001 diff --git a/Documentation/UserTsconfig/Options.rst b/Documentation/UserTsconfig/Options.rst index 476bfa44..44237fd9 100644 --- a/Documentation/UserTsconfig/Options.rst +++ b/Documentation/UserTsconfig/Options.rst @@ -897,6 +897,15 @@ pageTree.altElementBrowserMountPoints.append pageTree.backgroundColor ~~~~~~~~~~~~~~~~~~~~~~~~ +.. deprecated:: 13.1 + This setting has been deprecated and will be removed in TYPO3 v14 due to its + lack of accessibility. It is being replaced with a new label system for tree + nodes. + + In TYPO3 v13 the setting will be migrated to the new label system. Since the + use case is unknown, the generated label will be "Color: ". This + information will be displayed on all affected nodes. + .. confval:: pageTree.backgroundColor :Data type: string @@ -975,6 +984,41 @@ pageTree.excludeDoktypes options.pageTree.excludeDoktypes = 254,1 +.. index:: Page tree; Node labels +.. _useroptions-pageTree-label: + +pageTree.label +~~~~~~~~~~~~~~ + +.. versionadded:: 13.1 + This setting is the successor of :ref:`useroptions-pageTree-backgroundColor`. + +.. confval:: pageTree.label. + + :Data type: list of page IDs + + Labels offer customizable color markings for tree nodes and require an + associated label for accessibility. + + Example: + + .. code-block:: typoscript + :caption: EXT:my_extension/Configuration/user.tsconfig + + options.pageTree.label.296 { + label = Campaign A + color = #ff8700 + } + + Display: + + .. figure:: /Images/ManualScreenshots/List/optionsPageTreeLabel.png + :alt: Page with configured color and label + :class: with-shadow + + Page with configured color and label + + .. todo:: does this still work with site configuration? .. index:: Page tree; Show domain names .. _useroptions-pageTree-showDomainNameWithTitle: From 146efe29e5972a88210c6552b19c3ac8400777a3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Chris=20M=C3=BCller?= <2566282+brotkrueml@users.noreply.github.com> Date: Mon, 4 Mar 2024 13:22:57 +0100 Subject: [PATCH 2/3] Add link to PSR-14 event --- Documentation/UserTsconfig/Options.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Documentation/UserTsconfig/Options.rst b/Documentation/UserTsconfig/Options.rst index 44237fd9..2846c9a3 100644 --- a/Documentation/UserTsconfig/Options.rst +++ b/Documentation/UserTsconfig/Options.rst @@ -1018,6 +1018,10 @@ pageTree.label Page with configured color and label + .. note:: + Only one label per page can be set through this method. Use the + PSR-14 event :ref:`t3coreapi:AfterPageTreeItemsPreparedEvent` to assign + multiple labels to a page. .. todo:: does this still work with site configuration? .. index:: Page tree; Show domain names From e74b2efa4e7797282a0f1984cdbdce90d304f2aa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Chris=20M=C3=BCller?= <2566282+brotkrueml@users.noreply.github.com> Date: Mon, 4 Mar 2024 19:19:55 +0100 Subject: [PATCH 3/3] Add reference to new setting --- Documentation/UserTsconfig/Options.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/UserTsconfig/Options.rst b/Documentation/UserTsconfig/Options.rst index 2846c9a3..1b1eb4e7 100644 --- a/Documentation/UserTsconfig/Options.rst +++ b/Documentation/UserTsconfig/Options.rst @@ -899,8 +899,8 @@ pageTree.backgroundColor .. deprecated:: 13.1 This setting has been deprecated and will be removed in TYPO3 v14 due to its - lack of accessibility. It is being replaced with a new label system for tree - nodes. + lack of accessibility. It is being replaced with a + :ref:`new label system ` for tree nodes. In TYPO3 v13 the setting will be migrated to the new label system. Since the use case is unknown, the generated label will be "Color: ". This