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,63 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-88787:
+
+=================================================
+Deprecation: #88787 - BackendUtility::editOnClick
+=================================================
+
+See :issue:`88787`
+
+Description
+===========
+
+The method :php:`\TYPO3\CMS\Backend\Utility\BackendUtility::editOnClick()`
+used to generate JavaScript `onclick` targets to
+:php:`\TYPO3\CMS\Backend\Controller\EditDocumentController` has been marked as deprecated.
+
+
+Impact
+======
+
+Using this method will trigger PHP :php:`E_USER_DEPRECATED` error.
+
+
+Affected Installations
+======================
+
+All installations with extensions using :php:`\TYPO3\CMS\Backend\Utility\BackendUtility::editOnClick()` are affected.
+
+
+Migration
+=========
+
+Migrate the method to use the :php:`\TYPO3\CMS\Backend\Routing\UriBuilder` API and attach the parameters manually.
+
+Example:
+
+.. code-block:: php
+
+   // Previous
+   $old = BackendUtility::editOnClick($params);
+
+   // Migrated
+   $uriBuilder = GeneralUtility::makeInstance(UriBuilder::class);
+
+   // Variant 1
+   $params = '&edit[pages][' . $pid . ']=new&returnNewPageId=1';
+   $migrated = $uriBuilder->buildUriFromRoute('record_edit') . $params
+       . '&returnUrl=' . rawurlencode(GeneralUtility::getIndpEnv('REQUEST_URI'));
+
+   // Variant 2
+   $params = [
+       'edit' => [
+           'pages' => [
+               $pid => 'new',
+           ],
+        ],
+        'returnNewPageId' => 1,
+        'returnUrl' => GeneralUtility::getIndpEnv('REQUEST_URI'),
+   ];
+   $migrated = (string)$uriBuilder->buildUriFromRoute('record_edit', params);
+
+.. index:: Backend, PHP-API, FullyScanned, ext:backend