Merge branch 'main' into feature/records

linawolf · web-flow · commit f584082426da · 2025-11-28T13:46:50.000+01:00
diff --git a/Documentation/ApiOverview/Backend/BackendModules/_DocHeaderComponent.rst.txt b/Documentation/ApiOverview/Backend/BackendModules/_DocHeaderComponent.rst.txt
@@ -150,19 +150,59 @@
 
         Disables this component to prevent rendering.
 
+    ..  php:method:: setLanguageSelector(?\TYPO3\CMS\Backend\Template\Components\ComponentInterface $component)
+
+        :param $component: the component
+
+    ..  php:method:: getLanguageSelector()
+        :returns: `?\TYPO3\CMS\Backend\Template\Components\ComponentInterface`
+
+    ..  php:method:: setShortcutContext(string $routeIdentifier, string $displayName, array $arguments = [])
+
+        Sets the context for the automatic shortcut button.
+
+        Controllers can use this method to provide shortcut information without
+        manually creating and adding the shortcut button. The button will be
+        automatically added to the button bar in the correct position.
+
+        Example:
+
+            $docHeader->setShortcutContext(
+                routeIdentifier: 'site_configuration.edit',
+                displayName: sprintf('Edit site: %s', $siteIdentifier),
+                arguments: ['site' => $siteIdentifier]
+            );
+
+        :param $routeIdentifier: The route identifier for the shortcut
+        :param $displayName: The display name shown in the bookmark list
+        :param $arguments: Optional arguments to include in the shortcut URL, default: []
+
+    ..  php:method:: disableAutomaticReloadButton()
+
+        Disables the automatic reload button for this module.
+
+        Use this if your module needs custom reload behavior or should not
+        have a reload button at all.
+
+    ..  php:method:: disableAutomaticShortcutButton()
+
+        Disables the automatic shortcut button for this module.
+
+        Use this if your module should not have a shortcut button.
+
     ..  php:method:: docHeaderContent(?\Psr\Http\Message\ServerRequestInterface $request)
         :returns: `array`
 
         Returns the complete document header content as an array for rendering.
 
-        This method aggregates all components (buttons, menus, breadcrumbs) into
+        This method aggregates all components (buttons, breadcrumbs) into
         a structured array that can be consumed by the Fluid template rendering
         the backend module layout.
 
         The returned array structure:
         - 'enabled': Whether the document header should be rendered
         - 'buttons': Array of button configurations from the button bar
-        - 'menus': Array of menu configurations from the menu registry
         - 'breadcrumb': Breadcrumb trail data from the breadcrumb context
+        - 'languageSelector': Language Selector
 
         :param $request: the request
diff --git a/Documentation/ApiOverview/Backend/BackendModules/_ModuleTemplate.rst.txt b/Documentation/ApiOverview/Backend/BackendModules/_ModuleTemplate.rst.txt
@@ -125,7 +125,10 @@
     ..  php:method:: makeDocHeaderModuleMenu(array $additionalQueryParams = [])
         :returns: `self`
 
-        Generates a menu in the docheader to access third-level modules
+        Generates a module actions dropdown in the docheader button bar.
+
+        Creates a dropdown button on the LEFT side (group 0) containing navigation to
+        submodules or module actions. The button label shows the currently active module/action.
 
         :param $additionalQueryParams: the additionalQueryParams, default: []
 
diff --git a/Documentation/ApiOverview/Backend/_UriBuilder/_LinksAction.rst.txt b/Documentation/ApiOverview/Backend/_UriBuilder/_LinksAction.rst.txt
@@ -23,7 +23,7 @@
         {
             $pageUid = (int)($this->request->getQueryParams()['id'] ?? 0);
             $returnUrl = (string)$this->backendUriBuilder->buildUriFromRoute(
-                'web_examples',
+                'content_examples_links',
                 ['id' => $pageUid, 'action' => 'links'],
             );
 
diff --git a/Documentation/ApiOverview/Fal/Administration/Storages.rst b/Documentation/ApiOverview/Fal/Administration/Storages.rst
@@ -7,7 +7,7 @@ File storages
 =============
 
 :ref:`File storages <fal-architecture-components-storage>` can be administered
-through the :guilabel:`Content > List` module. They have a few properties which
+through the :guilabel:`Content > Records` module. They have a few properties which
 deserve further explanation.
 
 ..  include:: /Images/AutomaticScreenshots/Fal/AdministrationFileStorageAccessTab.rst.txt
diff --git a/Documentation/ApiOverview/Logging/Processors/Index.rst b/Documentation/ApiOverview/Logging/Processors/Index.rst
@@ -157,6 +157,11 @@ It is suggested to extend the abstract class
 :t3src:`core/Classes/Log/Processor/AbstractProcessor.php` which allows you use
 configuration options by adding the corresponding properties and setter methods.
 
+..  rubric:: Example
+
+..  literalinclude:: _MyProcessorWithOptions.php
+    :caption: EXT:my_extension/Classes/Log/Processor/MyProcessor.php
+
 Please keep in mind that TYPO3 will silently continue operating,
 in case a log processor is throwing an exception while executing
 the :php:`processLogRecord()` method.
diff --git a/Documentation/ApiOverview/Logging/Processors/_MyProcessorWithOptions.php b/Documentation/ApiOverview/Logging/Processors/_MyProcessorWithOptions.php
@@ -0,0 +1,22 @@
+<?php
+
+namespace MyVendor\MyExtension\Log\Processor;
+
+use TYPO3\CMS\Core\Log\LogRecord;
+
+class MyProcessor extends \TYPO3\CMS\Core\Log\Processor\AbstractProcessor
+{
+    protected bool $option = true;
+
+    public function setOption(bool $option): void
+    {
+        $this->option = $option;
+    }
+
+    public function processLogRecord(LogRecord $logRecord): LogRecord
+    {
+        // add magic
+
+        return $logRecord;
+    }
+}
diff --git a/Documentation/CodeSnippets/Events/Backend/ModifyDatabaseQueryForRecordListingEvent.rst.txt b/Documentation/CodeSnippets/Events/Backend/ModifyDatabaseQueryForRecordListingEvent.rst.txt
@@ -3,7 +3,7 @@
 
 ..  php:class:: ModifyDatabaseQueryForRecordListingEvent
 
-    Use this Event to alter the database query when loading content for a page (usually in the Records module)
+    Use this Event to alter the database query when loading content for a page (usually in the "Records" module)
     before it is executed.
 
     ..  php:method:: getQueryBuilder()
diff --git a/Documentation/CodeSnippets/Events/Form/AfterCurrentPageIsResolvedEvent.rst.txt b/Documentation/CodeSnippets/Events/Form/AfterCurrentPageIsResolvedEvent.rst.txt
@@ -28,4 +28,3 @@
         :public:
 
         The current request
-
diff --git a/Documentation/CodeSnippets/Extbase/Controllers/BlogControllerNew.rst.txt b/Documentation/CodeSnippets/Extbase/Controllers/BlogControllerNew.rst.txt
@@ -7,7 +7,7 @@
     use Psr\Http\Message\ResponseInterface;
     use T3docs\BlogExample\Domain\Model\Blog;
 
-    class BlogController extends AbstractController
+    class BlogController extends ActionController
     {
         /**
          * Displays a form for creating a new blog
diff --git a/Documentation/CodeSnippets/Extbase/Controllers/BlogControllerUpdate.rst.txt b/Documentation/CodeSnippets/Extbase/Controllers/BlogControllerUpdate.rst.txt
@@ -8,7 +8,7 @@
     use T3docs\BlogExample\Domain\Model\Blog;
     use T3docs\BlogExample\Exception\NoBlogAdminAccessException;
 
-    class BlogController extends AbstractController
+    class BlogController extends ActionController
     {
         /**
          * Updates an existing blog
diff --git a/Documentation/CodeSnippets/Extbase/Controllers/ForwardAction.rst.txt b/Documentation/CodeSnippets/Extbase/Controllers/ForwardAction.rst.txt
@@ -11,7 +11,7 @@
     use TYPO3\CMS\Extbase\Http\ForwardResponse;
     use TYPO3\CMS\Extbase\Pagination\QueryResultPaginator;
 
-    class PostController extends AbstractController
+    class PostController extends ActionController
     {
         /**
          * Displays a list of posts. If $tag is set only posts matching this tag are shown
diff --git a/Documentation/CodeSnippets/Extbase/Controllers/Settings.rst.txt b/Documentation/CodeSnippets/Extbase/Controllers/Settings.rst.txt
@@ -7,7 +7,7 @@
 
     use Psr\Http\Message\ResponseInterface;
 
-    class PostController extends AbstractController
+    class PostController extends ActionController
     {
         public function displayRssListAction(): ResponseInterface
         {
diff --git a/Documentation/CodeSnippets/Extbase/Persistence/TCA.rst.txt b/Documentation/CodeSnippets/Extbase/Persistence/TCA.rst.txt
@@ -23,7 +23,9 @@
             'enablecolumns' => [
                 'disabled' => 'hidden',
             ],
-            'iconfile' => 'EXT:blog_example/Resources/Public/Icons/icon_tx_blogexample_domain_model_tag.gif',
+            'typeicon_classes' => [
+                'default' => 'module-info',
+            ],
         ],
         'columns' => [
             'name' => [
diff --git a/Documentation/CodeSnippets/Extbase/PropertyManager/IntegerMapping.rst.txt b/Documentation/CodeSnippets/Extbase/PropertyManager/IntegerMapping.rst.txt
@@ -6,7 +6,7 @@
 
     use TYPO3\CMS\Extbase\Property\Exception;
 
-    class PostController extends AbstractController
+    class PostController extends ActionController
     {
         /**
          * This method demonstrates property mapping to an integer
diff --git a/Documentation/CodeSnippets/Extbase/PropertyManager/ObjectMapping.rst.txt b/Documentation/CodeSnippets/Extbase/PropertyManager/ObjectMapping.rst.txt
@@ -7,7 +7,7 @@
     use T3docs\BlogExample\Domain\Model\Tag;
     use TYPO3\CMS\Extbase\Property\Exception;
 
-    class PostController extends AbstractController
+    class PostController extends ActionController
     {
         /**
          * This method demonstrates property mapping to an object
diff --git a/Documentation/CodeSnippets/Extbase/PropertyManager/PropertyMapperInjection.rst.txt b/Documentation/CodeSnippets/Extbase/PropertyManager/PropertyMapperInjection.rst.txt
@@ -10,7 +10,7 @@
     use T3docs\BlogExample\PageTitle\BlogPageTitleProvider;
     use TYPO3\CMS\Extbase\Property\PropertyMapper;
 
-    class PostController extends AbstractController
+    class PostController extends ActionController
     {
         /**
          * PostController constructor.
diff --git a/Documentation/CodeSnippets/Extbase/View/CustomResponse.rst.txt b/Documentation/CodeSnippets/Extbase/View/CustomResponse.rst.txt
@@ -7,7 +7,7 @@
 
     use Psr\Http\Message\ResponseInterface;
 
-    class PostController extends AbstractController
+    class PostController extends ActionController
     {
         /**
          * Displays a list of posts as RSS feed
diff --git a/Documentation/CodeSnippets/Extbase/View/HtmlResponse.rst.txt b/Documentation/CodeSnippets/Extbase/View/HtmlResponse.rst.txt
@@ -8,7 +8,7 @@
     use Psr\Http\Message\ResponseInterface;
     use T3docs\BlogExample\Domain\Model\Blog;
 
-    class BlogController extends AbstractController
+    class BlogController extends ActionController
     {
         /**
          * Displays a form for creating a new blog
diff --git a/Documentation/CodeSnippets/Extbase/View/HtmlResponseCustom.rst.txt b/Documentation/CodeSnippets/Extbase/View/HtmlResponseCustom.rst.txt
@@ -7,7 +7,7 @@
 
     use Psr\Http\Message\ResponseInterface;
 
-    class BlogController extends AbstractController
+    class BlogController extends ActionController
     {
         /**
          * Output <h1>Hello World!</h1>
diff --git a/Documentation/CodeSnippets/Extbase/View/JsonResponseCustom.rst.txt b/Documentation/CodeSnippets/Extbase/View/JsonResponseCustom.rst.txt
@@ -8,7 +8,7 @@
     use Psr\Http\Message\ResponseInterface;
     use T3docs\BlogExample\Domain\Model\Blog;
 
-    class BlogController extends AbstractController
+    class BlogController extends ActionController
     {
         public function showBlogAjaxAction(Blog $blog): ResponseInterface
         {
diff --git a/Documentation/CodeSnippets/Manual/Cache/BackendInterface.rst.txt b/Documentation/CodeSnippets/Manual/Cache/BackendInterface.rst.txt
@@ -11,7 +11,7 @@
 
         :param $cache: The frontend for this backend
 
-    ..  php:method:: set(?string $entryIdentifier, ?string $data, array $tags = [], ?int $lifetime = NULL)
+    ..  php:method:: set(string $entryIdentifier, string $data, array $tags = [], ?int $lifetime = NULL)
 
         Saves data in the cache.
 
@@ -20,23 +20,23 @@
         :param $tags: Tags to associate with this cache entry. If the backend does not support tags, this option can be ignored., default: []
         :param $lifetime: Lifetime of this cache entry in seconds. If NULL is specified, the default lifetime is used. "0" means unlimited lifetime., default: NULL
 
-    ..  php:method:: get(?string $entryIdentifier)
+    ..  php:method:: get(string $entryIdentifier)
         :returns: `mixed`
 
         Loads data from the cache.
 
         :param $entryIdentifier: An identifier which describes the cache entry to load
         :Return description: The cache entry's content as a string or FALSE if the cache entry could not be loaded
 
-    ..  php:method:: has(?string $entryIdentifier)
+    ..  php:method:: has(string $entryIdentifier)
         :returns: `bool`
 
         Checks if a cache entry with the specified identifier exists.
 
         :param $entryIdentifier: An identifier specifying the cache entry
         :Return description: TRUE if such an entry exists, FALSE if not
 
-    ..  php:method:: remove(?string $entryIdentifier)
+    ..  php:method:: remove(string $entryIdentifier)
         :returns: `bool`
 
         Removes all cache entries matching the specified identifier.
diff --git a/Documentation/CodeSnippets/Manual/Cache/FrontendInterface.rst.txt b/Documentation/CodeSnippets/Manual/Cache/FrontendInterface.rst.txt
@@ -5,20 +5,6 @@
 
     Contract for a Cache (frontend)
 
-    ..  php:const:: TAG_CLASS
-        :public:
-
-        :php:`'%CLASS%'`, type string
-
-        "Magic" tag for class-related entries
-
-    ..  php:const:: TAG_PACKAGE
-        :public:
-
-        :php:`'%PACKAGE%'`, type string
-
-        "Magic" tag for package-related entries
-
     ..  php:const:: PATTERN_ENTRYIDENTIFIER
         :public:
 
@@ -41,13 +27,13 @@
         :Return description: The identifier for this cache
 
     ..  php:method:: getBackend()
-        :returns: `\TYPO3\CMS\Core\Cache\Backend\BackendInterface`
+        :returns: `\BackendInterface`
 
         Returns the backend used by this cache
 
         :Return description: The backend used by this cache
 
-    ..  php:method:: set(?string $entryIdentifier, ?mixed $data, array $tags = [], ?int $lifetime = NULL)
+    ..  php:method:: set(string $entryIdentifier, ?mixed $data, array $tags = [], ?int $lifetime = NULL)
 
         Saves data in the cache.
 
@@ -56,22 +42,22 @@
         :param $tags: Tags to associate with this cache entry, default: []
         :param $lifetime: Lifetime of this cache entry in seconds. If NULL is specified, the default lifetime is used. "0" means unlimited lifetime., default: NULL
 
-    ..  php:method:: get(?string $entryIdentifier)
-        :returns: `mixed`
+    ..  php:method:: get(string $entryIdentifier)
+        :returns: `?mixed`
 
         Finds and returns data from the cache.
 
         :param $entryIdentifier: Something which identifies the cache entry - depends on concrete cache
 
-    ..  php:method:: has(?string $entryIdentifier)
+    ..  php:method:: has(string $entryIdentifier)
         :returns: `bool`
 
         Checks if a cache entry with the specified identifier exists.
 
         :param $entryIdentifier: An identifier specifying the cache entry
         :Return description: TRUE if such an entry exists, FALSE if not
 
-    ..  php:method:: remove(?string $entryIdentifier)
+    ..  php:method:: remove(string $entryIdentifier)
         :returns: `bool`
 
         Removes the given cache entry from the cache.
@@ -83,7 +69,7 @@
 
         Removes all cache entries of this cache.
 
-    ..  php:method:: flushByTag(?string $tag)
+    ..  php:method:: flushByTag(string $tag)
 
         Removes all cache entries of this cache which are tagged by the specified tag.
 
@@ -99,14 +85,14 @@
 
         Does garbage collection
 
-    ..  php:method:: isValidEntryIdentifier(?string $identifier)
+    ..  php:method:: isValidEntryIdentifier(string $identifier)
         :returns: `bool`
 
         Checks the validity of an entry identifier. Returns TRUE if it's valid.
 
         :param $identifier: An identifier to be checked for validity
 
-    ..  php:method:: isValidTag(?string $tag)
+    ..  php:method:: isValidTag(string $tag)
         :returns: `bool`
 
         Checks the validity of a tag. Returns TRUE if it's valid.
diff --git a/Documentation/CodeSnippets/Manual/Cache/PhpCapableBackendInterface.rst.txt b/Documentation/CodeSnippets/Manual/Cache/PhpCapableBackendInterface.rst.txt
diff --git a/Documentation/CodeSnippets/Manual/Cache/TaggableBackendInterface.rst.txt b/Documentation/CodeSnippets/Manual/Cache/TaggableBackendInterface.rst.txt
diff --git a/Documentation/ExtensionArchitecture/HowTo/BackendModule/_ModuleConfiguration/_Modules.rst.txt b/Documentation/ExtensionArchitecture/HowTo/BackendModule/_ModuleConfiguration/_Modules.rst.txt
diff --git a/Documentation/ExtensionArchitecture/HowTo/ExtendingTca/Examples/Index.rst b/Documentation/ExtensionArchitecture/HowTo/ExtendingTca/Examples/Index.rst
diff --git a/Documentation/ExtensionArchitecture/HowTo/ExtendingTca/Index.rst b/Documentation/ExtensionArchitecture/HowTo/ExtendingTca/Index.rst
diff --git a/Documentation/ExtensionArchitecture/HowTo/ExtendingTca/StoringChanges/Index.rst b/Documentation/ExtensionArchitecture/HowTo/ExtendingTca/StoringChanges/Index.rst
diff --git a/Documentation/ExtensionArchitecture/HowTo/ExtendingTca/Verifying/Index.rst b/Documentation/ExtensionArchitecture/HowTo/ExtendingTca/Verifying/Index.rst
diff --git a/Documentation/ExtensionArchitecture/HowTo/Index.rst b/Documentation/ExtensionArchitecture/HowTo/Index.rst
diff --git a/Documentation/ExtensionArchitecture/Index.rst b/Documentation/ExtensionArchitecture/Index.rst
diff --git a/Documentation/ExtensionArchitecture/Tutorials/Tea/Model.rst b/Documentation/ExtensionArchitecture/Tutorials/Tea/Model.rst

Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,7 @@`
`23`	`23`	`{`
`24`	`24`	`$pageUid = (int)($this->request->getQueryParams()['id'] ?? 0);`
`25`	`25`	`$returnUrl = (string)$this->backendUriBuilder->buildUriFromRoute(`
`26`		`- 'web_examples',`
	`26`	`+ 'content_examples_links',`
`27`	`27`	`['id' => $pageUid, 'action' => 'links'],`
`28`	`28`	`);`
`29`	`29`
Original file line number	Diff line number	Diff line change
`@@ -28,4 +28,3 @@`
`28`	`28`	`:public:`
`29`	`29`
`30`	`30`	`The current request`
`31`		`-`
Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@`
`7`	`7`	`use Psr\Http\Message\ResponseInterface;`
`8`	`8`	`use T3docs\BlogExample\Domain\Model\Blog;`
`9`	`9`
`10`		`- class BlogController extends AbstractController`
	`10`	`+ class BlogController extends ActionController`
`11`	`11`	`{`
`12`	`12`	`/**`
`13`	`13`	`* Displays a form for creating a new blog`
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`use T3docs\BlogExample\Domain\Model\Blog;`
`9`	`9`	`use T3docs\BlogExample\Exception\NoBlogAdminAccessException;`
`10`	`10`
`11`		`- class BlogController extends AbstractController`
	`11`	`+ class BlogController extends ActionController`
`12`	`12`	`{`
`13`	`13`	`/**`
`14`	`14`	`* Updates an existing blog`