From 68faab135cf6a24c62c8255b8d266ebc2ce5d039 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bj=C3=B6rn=20Jacob?= <bjoern.jacob@tritum.de>
Date: Mon, 4 Oct 2021 08:43:21 +0200
Subject: [PATCH] [TASK] Deprecate legacy form templates

Using the legacy form template / partial variants residing in
:file:`EXT:form/Resources/Private/Frontend/Templates` and
:file:`EXT:form/Resources/Private/Frontend/Partials`
is deprecated. The legacy templates will be removed in v13.

Resolves: #95456
Releases: main
Change-Id: Ib1346065d69a12d6664758a3c9bedf7efa3bd834
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/71423
Tested-by: core-ci <typo3@b13.com>
Tested-by: waldhacker <hello@waldhacker.dev>
Reviewed-by: waldhacker <hello@waldhacker.dev>
---
 ...strap5CompatibleAndAccessibleTemplates.rst | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 typo3/sysext/core/Documentation/Changelog/12.0/Deprecation-95456-IntroduceBootstrap5CompatibleAndAccessibleTemplates.rst

diff --git a/typo3/sysext/core/Documentation/Changelog/12.0/Deprecation-95456-IntroduceBootstrap5CompatibleAndAccessibleTemplates.rst b/typo3/sysext/core/Documentation/Changelog/12.0/Deprecation-95456-IntroduceBootstrap5CompatibleAndAccessibleTemplates.rst
new file mode 100644
index 000000000000..1a3e2a8cc342
--- /dev/null
+++ b/typo3/sysext/core/Documentation/Changelog/12.0/Deprecation-95456-IntroduceBootstrap5CompatibleAndAccessibleTemplates.rst
@@ -0,0 +1,52 @@
+.. include:: ../../Includes.txt
+
+=====================================================
+Deprecation: #95456 - Deprecate legacy form templates
+=====================================================
+
+See :issue:`95456`
+
+Description
+===========
+
+Using the legacy form template / partial variants residing in
+:file:`EXT:form/Resources/Private/Frontend/Templates` and
+:file:`EXT:form/Resources/Private/Frontend/Partials`
+is deprecated. The legacy templates will be removed in v13.
+
+
+Impact
+======
+
+No deprecation is logged since it would flood the logs.
+
+
+Affected Installations
+======================
+
+Installations using custom templates for form elements.
+
+
+Migration
+=========
+
+Set your form rendering option "templateVariant" within the form setup from
+"version1" to "version2" to use the future default templates.
+
+.. code-block:: yaml
+
+    TYPO3:
+      CMS:
+        Form:
+          prototypes:
+            standard:
+              formElementsDefinition:
+                Form:
+                  renderingOptions:
+                    templateVariant: version2
+
+
+Migrate your templates / partials to make them compatible with the ones stored in
+:file:`EXT:form/Resources/Private/FrontendVersion2`.
+
+.. index:: Frontend, NotScanned, ext:form
-- 
GitLab