Add callouts to page module in TYPO3 backend

Installs: 30 226

Dependents: 0

Suggesters: 1

Security: 0

Stars: 0

Watchers: 2

Forks: 2

Open Issues: 2



v4.0.2 2024-02-08 07:07 UTC


Why this extension?

Informational, warning and error messages are displayed as "callouts" in the page module for various reasons, for example:

  • info message if page is of type folder
  • warning message if there are elements with an invalid colpos ("unused elements")
  • a page was defined as a shortcut, but has a missing target

However, it is not easily possible for extensions to add callouts of their own.

This extension provides a hook to add additional messages.

How it works

This extension Xclasses the PageLayoutController of the TYPO3 core. The class is inherited and the method getHeaderFlashMessagesForCurrentPid() overriden.

All functions which use the hook are called and the additional messages rendered.

How to use the hook

Simple example:


// ...
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['Sypets/PageCallouts/Xclass/PageLayoutControllerWithMessages']['addFlashMessageToPageModule'][] =


namespace Myvendor\MyExtension\Hooks;

use TYPO3\CMS\Core\Localization\LanguageService;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Fluid\ViewHelpers\Be\InfoboxViewHelper;

final class PageCalloutsHook
    public function addMessages(array $pageInfo): array
        $pageId = (int) ($pageInfo['uid']);
        $doktype = (int) ($pageInfo['doktype'] ?? 0);

        if ($someCondition) {
            $title = 'Some title';
            $message = 'some message';
            return [
                'title' => $title,
                'message' => $message,
                'state' => InfoboxViewHelper::STATE_ERROR
        return [];