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,88 @@
+..  include:: /Includes.rst.txt
+
+..  _breaking-17406-1762953718:
+
+================================================================
+Breaking: #17406 - Field "url" in table "pages" has been removed
+================================================================
+
+See :issue:`17406`
+
+Description
+===========
+
+The former page type "External link" has been renamed to "Link" and now fully
+supports all typolink capabilities. It now uses the field :sql:`link`.
+
+Since the field `url` was only used by this former page type, it has been
+removed.
+
+Impact
+======
+
+Custom code that expects the field  `url` to exist in the table :sql:`pages`
+will fail as the field is not found anymore.
+
+Affected installations
+======================
+
+*   TYPO3 projects that used the former page type *External URL* to link to
+    resources other than true external URLs, for example sections such as `#abc`.
+*   TYPO3 projects with custom code that expects the field `url` to exist
+    in the table :sql:`pages`.
+
+Migration
+=========
+
+The upgrade wizard **"Migrate links of pages of type link"** automatically migrates
+pages of the former type *External URL* to the new page type *Link*.
+
+It migrates all links that resolve to external URLs. If your project used the
+*External URL* field for other purposes — for example, to link sections such
+as `#abc` — you must migrate those links manually.
+
+If your project contains custom code that expects the field :sql:`url` to exist
+in the table :sql:`pages`, you can reintroduce this field via a TCA override,
+for example:
+
+..  code-block::
+    :caption: EXT:my_extension/Configuration/TCA/Overrides/pages.php
+
+    <?php
+
+    defined('TYPO3') || die('Access restricted.');
+
+    $GLOBALS['TCA']['pages']['columns']['url'] = [
+        'label' => 'External URL',
+        'config' => [
+            'type' => 'input',
+            'size' => 50,
+            'max' => 255,
+            'required' => true,
+            'eval' => 'trim',
+            'softref' => 'url',
+            'behaviour' => [
+                'allowLanguageSynchronization' => true,
+            ],
+        ],
+    ];
+
+    // Adding column to a existing or new palette and configure showitem,
+    // for a specific doktype the field is still required, for example:
+    $GLOBALS['TCA']['pages']['palettes]['custom_url'] = [
+        'showitem' => 'url',
+    ];
+    $GLOBALS['TCA']['pages']['types'][$customDokTypeValue] = [
+        'showitem' => [
+            --div--;core.form.tabs:general,
+                doktype,
+                --palette--;;title,
+                --palette--;;custom_url,
+        ],
+    ];
+
+Adding it back at least ensures that the database field is not renamed and
+dropped by the Database Analyzer. In case TCA is not required while keeping
+the database field it could be added to a extension `ext_tables.sql` file.
+
+..  index:: TCA, NotScanned, ext:core