Using Hooks

February 7, 2026

Hooks are a simple way to make Pure Blog do extra things when something changes on your site. Think of them like little trip‑wires: when a post is published, updated, or deleted, you can run your own code.

You don’t need a plugin system or any complicated setup. Just drop a small file into config/hooks.php, define the hook functions you care about, and Pure Blog will call them when the matching event happens.

What can hooks do?

Here are a few examples of what people typically use hooks for:

• Clear your CDN cache (Bunny, Cloudflare, etc.)
• Ping search engines or IndexNow
• Post to Mastodon, Bluesky, or X when you publish
• Send yourself a notification when something goes live
• Trigger a webhook (Zapier, Make, your own API)
• Rebuild a static index or sitemap

How hooks work

Hooks are just regular PHP functions. If a function exists, Pure Blog will call it. If it doesn’t, nothing happens.

For example, you can add this to config/hooks.php:

<?php
function on_post_published(string $slug): void
{
    // do something here
}

When you publish a post, Pure Blog will call that function and pass the post slug.

Available hook events

At the moment, Pure Blog supports these events:

• on_post_published($slug)
• on_post_updated($slug)
• on_post_deleted($slug)
• on_page_published($slug)
• on_page_updated($slug)
• on_page_deleted($slug)
• admin_action_buttons()
• on_admin_action($actionId)

You can implement any or all of them, it’s entirely optional. /config/hooks-example.php is included with Pure Blog, which is a working example that adds support for clearing cache with Bunny CDN whenever a post/page is published, updated, or deleted, as well as an on-demand purge button in admin. Just enter the API and Zone ID at the top.

Adding custom admin buttons

You can also add your own action buttons to the admin top nav with hooks.

Use admin_action_buttons() to define one or more buttons, then handle the click in on_admin_action($actionId).

function admin_action_buttons(): array
{
    return [
        [
            'id' => 'purge_cache',
            'label' => 'Purge cache',
            'class' => 'delete',
            'confirm' => 'Purge CDN cache now?',
            'icon' => 'circle-x',
        ],
    ];
}

function on_admin_action(string $actionId): array
{
    if ($actionId !== 'purge_cache') {
        return ['ok' => false, 'message' => 'Unknown action.'];
    }

    bunny_purge();
    return ['ok' => true, 'message' => 'CDN cache purge requested.'];
}

This is handy for things like manual cache purges, reindexing for search or tags, or other one-click maintenance tasks.

If your source code is published to a repository like GitHub, please ensure hooks.php is added to your .gitignore file.

This feature is intentionally simple. It gives you power without dragging a full plugin system into the core. If you want more structure later, you can build on top of it.

docs