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,91 @@
+.. include:: /Includes.rst.txt
+
+.. _breaking-107927-1763052738:
+
+=========================================================================================
+Breaking: #107927 - Remove "external" property / option from TypoScript and AssetRenderer
+=========================================================================================
+
+See :issue:`107927`
+
+Description
+===========
+
+The :typoscript:`resource` property :typoscript:`external` in the :typoscript:`PAGE` properties
+:typoscript:`includeCSS`, :typoscript:`includeCSSLibs`, :typoscript:`includeJS`,
+:typoscript:`includeJSFooter`, :typoscript:`includeJSFooterlibs` and :typoscript:`includeJSLibs`
+is now obsolete.
+
+This also obsoletes the :ref:`External option in AssetRenderer <feature-102255-1726090749>`.
+
+Both are removed in favor of the new unified :ref:`URI resource definition <feature-107537-1759136314>`.
+
+Instead of marking URIs as URIs with an additional option, prefix the URI, that shall be used with `URI:`,
+or simply use absolute URLs starting with `http(s)://`, where the prefix is not required.
+
+This URI resource definition will work across the system, not only in TypoScript or `AssetCollector`/ `AssetRenderer`.
+
+Impact
+======
+
+Using the `external` property in TypoScript or the `external` option in `AssetCollector`
+will have no effect any more. If absolute URLs have been used as resources, everything
+will work as before. Relative URIs **must** be prefixed with `URI:` from now on, otherwise
+an exception is thrown.
+
+Additionally, the string after the `URI:` keyword **must** be a valid URI, otherwise an exception
+is thrown as well. Before this change, invalid URIs (marked as external) would have been rendered
+to HTML, without any obvious feedback for developers or integrators. Browsers then ignored
+such invalid references.
+
+Affected installations
+======================
+
+TYPO3 installations using the `external` property in TypoScript or the `external` option in `AssetCollector`.
+
+Migration
+=========
+
+TypoScript before:
+
+..  code-block:: typoscript
+
+    page = PAGE
+    page.includeCSS {
+        main = https://example.com/styles/main.css
+        main.external = 1
+        other = /styles/main.css
+        other.external = 1
+    }
+
+TypoScript after:
+
+..  code-block:: typoscript
+
+    page = PAGE
+    page.includeCSS {
+        main = https://example.com/styles/main.css
+        other = URI:/styles/main.css
+    }
+
+PHP Code before:
+
+..  code-block:: php
+
+    $assetCollector->addStyleSheet(
+        'myCssFile',
+        '/styles/main.css',
+        [],
+        ['external' => true]
+    );
+
+PHP Code after:
+
+..  code-block:: php
+
+    $assetCollector->addStyleSheet(
+        'myCssFile',
+        'URI:/styles/main.css',
+    );
+
+.. index:: Frontend, NotScanned, ext:frontend