Hook List

<?php

// ── Event hooks in boot() ───────────────────────────────────────
public function boot(): void
{
    Module::registerHook('order.placed', function (array $order): void {
        Logger::info('Order placed: ' . ($order['id_order'] ?? ''));
    });

    Module::registerHook('order.updated', function (array $order, $oldStatus = null): void {
        // status / cargo / content edits
    });

    Module::registerHook('product.updated', function (int $idProduct, $product = null, $isNew = false): void {
        // sync external catalog, clear caches, etc.
    });

    Module::registerHook('cart.changed', function (array $cart): void {
        // abandoned-cart tracking, analytics
    });

    Module::registerHook('form.captcha.validate', function (string $form, string &$error): void {
        // set $error when CAPTCHA fails
    });

    Module::registerHook('smarty.assign', function ($smarty): void {
        if ($smarty) {
            $smarty->assign('myModuleEnabled', true);
        }
    });

    Module::registerHook('head.assets', function (array &$assets): void {
        $assets['css'][] = 'https://cdn.example.com/extra.css';
    });
}

// ── Display hooks: declare + render ────────────────────────────
public array $displayHooks = [
    'footer'         => 'Footer block',
    'product_detail' => 'Product detail section',
    'auth_login'     => 'Login CAPTCHA',
];

public array $defaultDisplayHooks = ['footer'];

public function renderDisplayHook(string $hook, array $context = []): ?string
{
    return match ($hook) {
        'footer' => $this->renderFrontTemplate('footer', [
            'message' => Settings::get('MY_MODULE_TEXT'),
        ]),
        'product_detail' => $this->renderFrontTemplate('product_detail', [
            'id_product' => $context['id_product'] ?? 0,
        ]),
        default => null,
    };
}

{* assets/templates/front/footer.tpl *}

<div class="my-module-footer">
    {if $message}
        <p>{$message|escape}</p>
    {/if}
</div>

<?php

// Call from product detail controller after $smarty is ready:
Module::refreshHook($smarty, 'product_detail', [
    'id_product' => (int) $product['id_product'],
]);

// Smarty template:
// {$hooks.product_detail}

<?php

public array $displayHooks = [
    'admin_order_detail' => 'Extra block on order detail',
    'admin_dashboard_top' => 'Dashboard banner',
];

public function renderAdminDisplayHook(string $hook, array $context = []): ?string
{
    return match ($hook) {
        'admin_order_detail' => $this->renderAdminTemplate('order-detail', $context),
        'admin_dashboard_top' => $this->renderAdminTemplate('dashboard-top', $context),
        default => null,
    };
}

<?php

// Minimum setup inside {name}.php:

public array $displayHooks = [
    'footer' => 'Shown in store footer',
];

public array $defaultDisplayHooks = ['footer'];

public function renderDisplayHook(string $hook, array $context = []): ?string
{
    if ($hook !== 'footer') {
        return null;
    }

    return $this->renderFrontTemplate('footer', $context);
}