Issue Bug Under Review Stale

#110369Remove internal from public API for backend preview

Daniel Siepmann 08/04/26, 08:17 updated 08/11/26, 09:44

Description

TYPO3 has a way to alter the rendering of TCA records via a public API as documented at: https://docs.typo3.org/permalink/t3tca:confval-ctrl-previewrenderer. This references the public Interface TYPO3\CMS\Backend\Preview\PreviewRendererInterface https://docs.typo3.org/permalink/t3coreapi:configurece-preview-preview-renderer which I would consider public API.

This interface now has type hints to classes which are marked as @internal, leading to a public API forcing users into using internal API, which seems incompatible to me.

So either the whole concept and interface is not public yet, or the internal classes should become public, which I would prefer.

Mainly: TYPO3\CMS\Backend\View\BackendLayout\Grid\GridColumnItem @internal this is experimental and subject to change in TYPO3 v10 / v11

But it would also be cool if other classes can be made public as well, as it is very likely that those will be used in that context:
- TYPO3\CMS\Backend\View\BackendLayout\Grid\Grid @internal this is experimental and subject to change in TYPO3 v10 / v11
- TYPO3\CMS\Backend\View\BackendLayout\Grid\GridRow @internal this is experimental and subject to change in TYPO3 v10 / v11
- TYPO3\CMS\Backend\View\BackendLayout\Grid\AbstractGridObject @internal this is experimental and subject to change in TYPO3 v10 / v11

This was reported by PHPStan and reveals that developers need to take extra care during each update to check compatibility.

Reviews 1

History 46

  1. Daniel Siepmann changed subject Remove internal from public API Remove internal from public API for backend preview <span data-processor="relativetime" data-value="2026-08-04T08:18:50+00:00" > 08/04/26, 08:18 </span>

  2. Daniel Siepmann commented <span data-processor="relativetime" data-value="2026-08-11T09:43:30+00:00" > 08/11/26, 09:43 </span>

    I just noticed that TYPO3\CMS\Backend\View\PageLayoutContext has the same issue and is provided by TYPO3\CMS\Backend\View\BackendLayout\Grid\AbstractGridObject