Hooks (Events)

apidcms provides a hook system for extending functionality through plugins.

Available Hooks

core.init

Called during core initialization. Register global settings.

twig.init

Called when creating the Twig environment. Add custom functions and filters.

$pm->addAction('twig.init', function($frontController, $twig) {
    $twig->addFunction(new TwigFunction('my_helper', function($x) {
        return strtoupper($x);
    }));
});

front.router.before

Before route processing. Modify the path or add a redirect.

$pm->addAction('front.router.before', function($path, $frontController) {
    if ($path === 'old-page') {
        header('Location: /new-page', true, 301);
        exit;
    }
});

front.router.after

After route processing. Modify the response.

front.render

Called before template rendering. Modify data passed to Twig.

$pm->addFilter('front.render', function($data) {
    $data['cart_count'] = $cartService->getCount();
    return $data;
});

admin.menu

Allows plugins to add items to the admin sidebar menu.

$pm->addFilter('admin.menu', function($menu) {
    $menu[] = ['title' => 'My Plugin', 'url' => '/admin/myplugin', 'icon' => '🔧'];
    return $menu;
});

db.migrate

Called when init_system_tables.php runs. Allows plugins to create their tables.

$pm->addAction('db.migrate', function($db) {
    $pdo = $db->getConnection();
    $pdo->exec('CREATE TABLE IF NOT EXISTS my_table (...)');
});

Registering a Hook

In the plugin's init.php:

$pm = \Core\PluginManager::getInstance();

$pm->addAction('twig.init', function($fc, $twig) {
    // your code
}, 10, 'my_plugin');

Filters vs Actions

• addAction — execute an action, no return value
• addFilter — modify a value and return it

$pm->addFilter('page_title', function($title) {
    return $title . ' — My Site';
});