Deprecation: #107813 - Deprecate MetaInformation API in DocHeader
See forge#107813
Description
The
\TYPO3\
class and related methods in
\TYPO3\
have been deprecated in favor of the new breadcrumb component architecture.
The following have been marked as deprecated:
DocHeader Component:: set Meta Information () DocHeader Component:: set Meta Information For Resource () MetaclassInformation
These APIs were previously used to display page navigation paths in the backend document header. This functionality is now handled by the breadcrumb component, which provides richer context and better navigation capabilities.
Impact
Calling any of the deprecated methods will trigger a PHP
E_ error.
The
Meta
class is now marked as
@internal and should not be used in extensions.
Affected installations
All installations using custom backend modules that call:
$view->getDoc Header Component ()->set Meta Information ($page Record) $view->getDoc Header Component ()->set Meta Information For Resource ($resource)
or any custom code relying on the
Meta class.
The Extension Scanner will detect usage of the deprecated methods and classes, making it easy to identify code that needs to be updated.
Migration
Replace calls to the deprecated methods with the new convenience methods on
Doc.
Before:
use TYPO3\CMS\Backend\Template\Components\DocHeaderComponent;
// For page records
$view->getDocHeaderComponent()->setMetaInformation($pageInfo);
// For file or folder resources
$view->getDocHeaderComponent()->setMetaInformationForResource($resource);
After:
use TYPO3\CMS\Backend\Template\Components\DocHeaderComponent;
// For page records
$view->getDocHeaderComponent()->setPageBreadcrumb($pageInfo);
// For file or folder resources
$view->getDocHeaderComponent()->setResourceBreadcrumb($resource);
An additional convenience method is available for records:
use TYPO3\CMS\Backend\Template\Components\DocHeaderComponent;
// For any record type (by table and UID)
$view->getDocHeaderComponent()->setRecordBreadcrumb('tt_content', 123);
For advanced scenarios requiring custom breadcrumb logic (such as conditional
context selection based on controller state), see the implementation in
\TYPO3\, which uses
\TYPO3\
directly with
set.