From 9a645a2766cabd5809b6630adec6b75e34a754e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Chris=20M=C3=BCller?=
 <2566282+brotkrueml@users.noreply.github.com>
Date: Wed, 16 Aug 2023 18:26:14 +0200
Subject: [PATCH] [Backport 12.4] [TASK] Add deprecations and changes to site
 language (#782) (#787)

- "direction" and "twoLetterIsoCode" have been deprecated with v12.3
- "hreflang" has been changed with v12.4

Related: https://github.com/TYPO3-Documentation/Changelog-To-Doc/issues/362
Related: https://github.com/TYPO3-Documentation/Changelog-To-Doc/issues/365
Related: https://github.com/TYPO3-Documentation/Changelog-To-Doc/issues/583
Releases: main, 12.4
---
 Documentation/Conditions/Index.rst |  9 +++++++++
 Documentation/Functions/Data.rst   | 15 ++++++++++++---
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/Documentation/Conditions/Index.rst b/Documentation/Conditions/Index.rst
index c1459d46..a3e8904c 100644
--- a/Documentation/Conditions/Index.rst
+++ b/Documentation/Conditions/Index.rst
@@ -1414,13 +1414,22 @@ siteLanguage()
         or the two-letter language code.
 
     :typoscript:`siteLanguage("twoLetterIsoCode")`
+        .. deprecated:: 12.3
+
         Returns the two-letter code for the language according to ISO-639
         nomenclature as a string.
 
     :typoscript:`siteLanguage("hreflang")`
+        ..  versionchanged:: 12.4
+            This option is not relevant anymore for regular websites without
+            rendering hreflang tag, but is now customizable, and has a proper
+            fallback.
+
         Returns the language information for the hreflang tag as a string.
 
     :typoscript:`siteLanguage("direction")`
+        .. deprecated:: 12.3
+
         Returns the text direction for content in this language (left-to-right
         or right-to-left) as a string.
 
diff --git a/Documentation/Functions/Data.rst b/Documentation/Functions/Data.rst
index 7ffa9fb3..b17ff6a6 100644
--- a/Documentation/Functions/Data.rst
+++ b/Documentation/Functions/Data.rst
@@ -792,18 +792,25 @@ siteLanguage
         The base URL for this language.
 
     :typoscript:`direction`
+        ..  deprecated:: 12.3
+
         The direction for this language.
 
     :typoscript:`flagIdentifier`
-        The flag key (like `gb` or `fr`) used to be used in the TYPO3 backend.
+        The flag key (like `gb` or `fr`) used in the TYPO3 backend.
 
         ..  versionadded:: 12.4
             You can also use :typoscript:`flag` to match the corresponding site
             configuration setting.
 
     :typoscript:`hreflang`
+        ..  versionchanged:: 12.4
+            This option is not relevant anymore for regular websites without
+            rendering hreflang tag, but is now customizable, and has a proper
+            fallback.
+
         The language tag for this language defined by RFC 1766 / 3066 for
-        :html:`lang` and :html:`hreflang` attributes
+        :html:`hreflang` attributes
 
     :typoscript:`languageId`
         The language mapped to the ID of the site language.
@@ -818,6 +825,8 @@ siteLanguage
         The label to be used within TYPO3 to identify the language.
 
     :typoscript:`twoLetterIsoCode`
+        ..  deprecated:: 12.3
+
         The ISO-639-1 code for this language (two letters).
 
     :typoscript:`typo3Language`
@@ -838,7 +847,7 @@ siteLanguage
         page.10.wrap = This is the title of the current site language: |
 
         page.20 = TEXT
-        page.20.dataWrap = The current site language direction is {siteLanguage:direction}
+        page.20.dataWrap = The current site language's locale is {siteLanguage:locale}
 
         # Website title for the current language with fallback
         # to the website title of the site configuration.