[FEATURE] Introduce HeaderData and FooterData ViewHelpers

linawolf · linawolf · commit 2a314f7bf7d9 · 2025-09-06T16:23:49.000+02:00
References: TYPO3-Documentation/Changelog-To-Doc#1301 Releases: main
diff --git a/Documentation/Global/Page/FooterData.rst b/Documentation/Global/Page/FooterData.rst
@@ -12,5 +12,30 @@
 Page.footerData ViewHelper `<f:page.footerData>`
 ================================================
 
+..  versionadded:: 14.0
+
+The `<f:page.footerData>` ViewHelper allows injecting arbitrary content right
+before the closing :php:`</body>` tag of a rendered page.
+
+The ViewHelper internally uses the `PageRenderer API <https://docs.typo3.org/permalink/t3coreapi:assets-page-renderer>`_
+and is useful when ViewHelpers like
+`<f:asset.css> <https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-asset-css>`_ or
+`<f:asset.script> <https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-asset-script>`_
+do not support all required attributes or use cases
+(for example tracking code or inline JavaScript).
+
+..  warning::
+
+    The ViewHelper outputs given content as is. Possible user supplied input for
+    the ViewHelpers **must manually be escaped** in order to prevent a
+    `Cross-site scripting (XSS) <https://docs.typo3.org/permalink/t3coreapi:security-xss>`_
+    vulnerability.
+
 ..  typo3:viewhelper:: page.footerData
     :source: ../../Global.json
+    :display: tags,gitHubLink
+
+..  rubric:: Example usage
+
+..  literalinclude:: _codesnippets/_FooterData.html
+
diff --git a/Documentation/Global/Page/HeaderData.rst b/Documentation/Global/Page/HeaderData.rst
@@ -1,7 +1,3 @@
-..  This reStructured text file has been automatically generated, do not change.
-..  Source: https://github.com/TYPO3/typo3/blob/main/typo3/sysext/fluid/Classes/ViewHelpers/Page/HeaderDataViewHelper.php
-
-:edit-on-github-link: https://github.com/TYPO3/typo3/edit/main/typo3/sysext/fluid/Classes/ViewHelpers/Page/HeaderDataViewHelper.php
 :navigation-title: page.headerData
 
 ..  include:: /Includes.rst.txt
@@ -12,5 +8,30 @@
 Page.headerData ViewHelper `<f:page.headerData>`
 ================================================
 
+..  versionadded:: 14.0
+
+The `<f:page.headerData>` ViewHelper allows injecting arbitrary content into
+the HTML :php:`<head>` of a rendered page.
+
+The ViewHelper internally uses the `PageRenderer API <https://docs.typo3.org/permalink/t3coreapi:assets-page-renderer>`_
+and is useful when ViewHelpers like
+`<f:asset.css> <https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-asset-css>`_ or
+`<f:asset.script> <https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-asset-script>`_
+do not support all required attributes or use cases
+(for example `dns-prefetch`, `preconnect`, tracking scripts, or inline
+JavaScript).
+
+..  warning::
+
+    The ViewHelper outputs given content as is. Possible user supplied input for
+    the ViewHelpers **must manually be escaped** in order to prevent a
+    `Cross-site scripting (XSS) <https://docs.typo3.org/permalink/t3coreapi:security-xss>`_
+    vulnerability.
+
 ..  typo3:viewhelper:: page.headerData
     :source: ../../Global.json
+    :display: tags,gitHubLink
+
+..  rubric:: Example usage
+
+..  literalinclude:: _codesnippets/_HeaderData.html
diff --git a/Documentation/Global/Page/_codesnippets/_FooterData.html b/Documentation/Global/Page/_codesnippets/_FooterData.html
@@ -0,0 +1,14 @@
+<f:page.footerData>
+    <script>
+        var _paq = window._paq = window._paq || [];
+        _paq.push(['trackPageView']);
+        _paq.push(['enableLinkTracking']);
+        (function() {
+            var u = "https://your-matomo-domain.example.com/";
+            _paq.push(['setTrackerUrl', u + 'matomo.php']);
+            _paq.push(['setSiteId', '1']);
+            var d = document, g = d.createElement('script'), s = d.getElementsByTagName('script')[0];
+            g.async = true; g.src = u + 'matomo.js'; s.parentNode.insertBefore(g, s);
+        })();
+    </script>
+</f:page.footerData>
diff --git a/Documentation/Global/Page/_codesnippets/_HeaderData.html b/Documentation/Global/Page/_codesnippets/_HeaderData.html
@@ -0,0 +1,5 @@
+<f:page.headerData>
+    <link rel="preload" href="/fonts/myfont.woff2" as="font" type="font/woff2" crossorigin="anonymous">
+    <link rel="dns-prefetch" href="//example-cdn.com">
+    <link rel="preconnect" href="https://example-cdn.com">
+</f:page.headerData>
