modifyFrontendPage

The modifyFrontendPage hook is triggered when a front end template is printed to the screen. It passes the template content and the template name as arguments and expects the template content as return value.

This hook is applied after insert tags have been replaced. If you want to apply your logic before the replacement of insert tags, use the outputFrontendTemplate hook instead.

Parameters

  1. string $buffer

    Content of the rendered front end template.

  2. string $templateName

    The template name (e.g. fe_page) without file extension.

Return Values

Return the original $buffer or override with your custom modification.

Example

// src/EventListener/ModifyFrontendPageListener.php
namespace App\EventListener;

use Contao\CoreBundle\ServiceAnnotation\Hook;
use Terminal42\ServiceAnnotationBundle\ServiceAnnotationInterface;

class ModifyFrontendPageListener implements ServiceAnnotationInterface
{
    /**
     * @Hook("modifyFrontendPage")
     */
    public function onModifyFrontendPage(string $buffer, string $templateName): string
    {
        if ('fe_page' === $templateName) {
            // Modify $buffer
        }

        return $buffer;
    }
}

References