technoquebecca / page_callouts

TYPO3 extension for adding messages to page module for TYPO3 v12

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:

ext_localconf.php:

// ...
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['Sypets/PageCallouts/Xclass/PageLayoutControllerWithMessages']['addFlashMessageToPageModule'][] =
    \Myvendor\MyExtension\Hooks\PageCalloutsHook::class;

ClassesHooksPageCalloutsHook.php:

<?php
declare(strict_types=1);
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 [];
    }
}