From e1bacc715169fa4105f0cb213cb9e898bcfadd5b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Chris=20M=C3=BCller?=
 <2566282+brotkrueml@users.noreply.github.com>
Date: Tue, 19 Dec 2023 09:23:13 +0000
Subject: [PATCH] [TASK] #102499 - User TSconfig setting "overridePageModule"
 removed (#417)

Resolves: https://github.com/TYPO3-Documentation/Changelog-To-Doc/issues/732
Releases: main
---
 Documentation/UserTsconfig/Options.rst | 50 +++++++++++++++-----------
 1 file changed, 30 insertions(+), 20 deletions(-)

diff --git a/Documentation/UserTsconfig/Options.rst b/Documentation/UserTsconfig/Options.rst
index 075c453d..a78ea01d 100644
--- a/Documentation/UserTsconfig/Options.rst
+++ b/Documentation/UserTsconfig/Options.rst
@@ -796,31 +796,41 @@ noThumbsInEB
     If set, then image thumbnails are not shown in the element browser.
 
 
-..  todo:: can we remove this?
 ..  _useroptions-overridePageModule:
 
 overridePageModule
 ------------------
 
-..  confval:: overridePageModule
-
-    :Data type: string
-
-    By this value you can substitute the default :guilabel:`Web > Page` module
-    key ("web\_layout") with another backend module key.
-
-    ..  note::
-        This property has been introduced for EXT:templavoila in the old days.
-        It is of little use nowadays and can be achieved using
-        :ref:`hideModules <useroptions-hideModules>`, too.
-
-    Example:
-
-    ..  code-block:: typoscript
-        :caption: EXT:site_package/Configuration/user.tsconfig
-
-        # Enable TemplaVoila page module as default page module.
-        options.overridePageModule = web_txtemplavoilaM1
+..  versionchanged:: 13.0
+    This setting has been removed.
+
+Migration
+~~~~~~~~~
+
+In order to replace the :guilabel:`Web > Page` module within a third-party
+extension, such as TemplaVoila, it is possible to create a custom module entry
+in an extension's :file:`Configuration/Backend/Modules.php` with the following
+entry:
+
+..  code-block:: php
+    :caption: EXT:my_extension/Configuration/Backend/Modules.php
+
+    return [
+        'my_module' => [
+            'parent' => 'web',
+            'position' => ['before' => '*'],
+            'access' => 'user',
+            'aliases' => ['web_layout'],
+            'path' => '/module/my_module',
+            'iconIdentifier' => 'module-page',
+            'labels' => 'LLL:EXT:backend/Resources/Private/Language/locallang_mod.xlf',
+            'routes' => [
+                '_default' => [
+                    'target' => \MyVendor\MyExtension\Controller\MyController::class . '::mainAction',
+                ],
+            ],
+        ],
+    ];
 
 
 ..  index:: Page tree