[FEATURE] Introduce Fluid page title ViewHelper (#6004)

* [FEATURE] Introduce Fluid page title ViewHelper

Resolves: TYPO3-Documentation/Changelog-To-Doc#1308

Releases: main

* [FEATURE] Introduce Fluid page title ViewHelper

Resolves: TYPO3-Documentation/Changelog-To-Doc#1308

Releases: main

* [FEATURE] Introduce Fluid page title ViewHelper

Resolves: TYPO3-Documentation/Changelog-To-Doc#1308

Releases: main

* Update PageTitleApi.rst

* Update PageTitleApi.rst

---------

Co-authored-by: Garvin Hicking <[email protected]>

Author: linawolf

Documentation/ApiOverview/Seo/PageTitleApi.rst

@@ -17,6 +17,10 @@ providers if a title is given by the provider.
 Besides the providers shipped by the Core, you can add own providers. An
 integrator can define the priority of the providers for his project.
 
+..  versionadded:: 14.0
+    The page title can also be set via the `Page.title ViewHelper
+    <f:page.title> <https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-page-title>`_.
+
 .. seealso::
 
    The page title is further influenced by :ref:`t3tsref:setup-config-pagetitle`
@@ -48,6 +52,22 @@ page, this provider will provide that title.
 If you have not installed the SEO system
 extension, the field and provider are not available.
 
+..  _page-title-provider-record-title:
+
+RecordTitleProvider
+-------------------
+
+..  versionadded:: 14.0
+
+The fallback provider with the lowest priority is the
+:php:`\TYPO3\CMS\Core\PageTitle\RecordTitleProvider`. It has the identifier
+`recordTitle`.
+
+This provider can be used by third-party extensions to set the page title.
+
+..  literalinclude:: _PageTitleProvider/_RecordTitleProviderUsage.php
+    :caption: my_extension/Classes/Controller/ItemController.php
+
 ..  _page-title-provider-record:
 
 RecordPageTitleProvider
@@ -72,6 +92,10 @@ the page record will not be the correct title. To make sure to display the
 correct page title, you have to create your own page title provider. It is
 quite easy to create one.
 
+..  versionadded:: 14.0
+    In many use cases, the provider `RecordTitleProvider`
+    can be used instead of writing a custom page title provider.
+
 ..  _page-title-provider-custom-example:
 
 Example: Set the page title from your extension's controller
@@ -154,8 +178,9 @@ The sorting of the providers is based on the :typoscript:`before` and
 specific other provider, just set that provider in the :typoscript:`before`,
 do the same with :typoscript:`after`.
 
-If you have installed the system extension SEO, you will also get a second
-provider. The configuration will be:
+For example, if you want the :php-short:`\TYPO3\CMS\Core\PageTitle\RecordTitleProvider`
+to take priority over the :php-short:`\TYPO3\CMS\Seo\PageTitle\SeoTitlePageTitleProvider`
+you can change the order via TypoScript:
 
 ..  literalinclude:: _PageTitleProvider/_pageTitleProviders.typoscript
 

Documentation/ApiOverview/Seo/_PageTitleProvider/_RecordTitleProviderUsage.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MyVendor\MyExtension\Controller;
+
+use MyVendor\MyExtension\Domain\Model\Item;
+use Psr\Http\Message\ResponseInterface;
+use TYPO3\CMS\Core\PageTitle\RecordTitleProvider;
+use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
+
+final class ItemController extends ActionController
+{
+    public function __construct(
+        private readonly RecordTitleProvider $recordTitleProvider,
+    ) {}
+
+    public function showAction(Item $item): ResponseInterface
+    {
+        $this->recordTitleProvider->setTitle($item->getTitle());
+        $this->view->assign('item', $item);
+        return $this->htmlResponse();
+    }
+}

Documentation/ApiOverview/Seo/_PageTitleProvider/_core.typoscript

@@ -1,5 +1,7 @@
 config.pageTitleProviders {
-  record {
-    provider = TYPO3\CMS\Core\PageTitle\RecordPageTitleProvider
+  record.provider = TYPO3\CMS\Core\PageTitle\RecordPageTitleProvider
+  recordTitle {
+    provider = TYPO3\CMS\Core\PageTitle\RecordTitleProvider
+    before = record
   }
 }

Documentation/ApiOverview/Seo/_PageTitleProvider/_pageTitleProviders.typoscript

@@ -1,9 +1,5 @@
 config.pageTitleProviders {
-  record {
-    provider = TYPO3\CMS\Core\PageTitle\RecordPageTitleProvider
-  }
-  seo {
-    provider = TYPO3\CMS\Seo\PageTitle\SeoTitlePageTitleProvider
-    before = record
+  recordTitle {
+    before = seo
   }
 }