TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,113 @@
+..  include:: /Includes.rst.txt
+
+..  _feature-107359-1740170000:
+
+=======================================================
+Feature: #107359 - Introduce Fluid page meta ViewHelper
+=======================================================
+
+See :issue:`107359`
+
+Description
+===========
+
+A new Fluid ViewHelper :html:`<f:page.meta>` has been introduced to allow
+setting meta tags directly from Fluid templates using TYPO3's
+MetaTagManager API.
+
+This is especially useful for Extbase plugins that need to set meta tags
+in their detail views without having to implement custom meta tag
+handling.
+
+In addition, frontend developers do not need to write custom TypoScript
+anymore but can use Fluid directly.
+
+..  code-block:: html
+    :caption: EXT:my_extension/Resources/Private/Templates/Item/Show.html
+
+    <f:page.meta property="description">
+        {item.description}
+    </f:page.meta>
+    <f:page.meta property="og:title">
+        {item.title}
+    </f:page.meta>
+    <f:page.meta property="og:type">
+        article
+    </f:page.meta>
+
+    <h1>{item.title}</h1>
+    <p>{item.description}</p>
+
+The ViewHelper supports all features of the MetaTagManager API:
+
+**OpenGraph and Twitter / X Card meta tags:**
+
+..  code-block:: html
+
+    <f:page.meta property="og:title">
+        My Article Title
+    </f:page.meta>
+    <f:page.meta property="og:description">
+        Article description
+    </f:page.meta>
+    <f:page.meta property="twitter:card">
+        summary_large_image
+    </f:page.meta>
+
+**Sub-properties for complex meta tags:**
+
+..  code-block:: html
+
+    <f:page.meta
+        property="og:image"
+        subProperties="{width: 1200, height: 630, alt: 'Article image'}"
+    >
+        {item.image.url}
+    </f:page.meta>
+
+**Custom meta tag types:**
+
+..  code-block:: html
+
+    <f:page.meta property="author" type="name">
+        John Doe
+    </f:page.meta>
+    <f:page.meta property="robots" type="name">
+        index, follow
+    </f:page.meta>
+
+**Replacing existing meta tags:**
+
+..  code-block:: html
+
+    <f:page.meta property="description" replace="true">
+        Override any existing description
+    </f:page.meta>
+
+ViewHelper Arguments
+====================
+
+*   **property** (required): The meta property name (for example,
+    `description`, `og:title`)
+*   **type** (optional): The meta type attribute (`name`, `property`,
+    `http-equiv`). If not set, the appropriate MetaTagManager determines
+    the type automatically.
+*   **subProperties** (optional): Array of sub-properties for complex
+    meta tags.
+*   **replace** (optional): Boolean to replace existing meta tags with
+    the same property (default: `false`).
+
+Impact
+======
+
+Extension developers can now easily set meta tags from Fluid templates
+without needing to use the MetaTagManager API directly in PHP code. This
+simplifies the implementation of SEO-optimized pages in Extbase plugins,
+especially for detail views where meta tags should reflect the displayed
+record.
+
+The ViewHelper integrates seamlessly with TYPO3's existing
+MetaTagManager system and respects all configured meta tag managers and
+their priorities.
+
+..  index:: Frontend, ext:fluid