Listeners

Listeners are classes that respond to WordPress actions and filters. Instead of calling add_action() and add_filter() manually, you decorate your class with the #[AsListener] PHP attribute.

Creating a listener

php nikogin make:listener SavePostListener --type=action --name=save_post
php nikogin make:listener TheContentListener --type=filter --name=the_content

Action listener

// app/Listeners/Action/SavePostListener.php
#[AsListener(name: 'save_post', type: 'action')]
class SavePostListener extends Listener
{
    public function handle(mixed ...$args): mixed
    {
        $postId = $args[0];
        // do something when a post is saved
        return null;
    }
}

Filter listener

// app/Listeners/Filter/TheContentListener.php
#[AsListener(name: 'the_content', type: 'filter')]
class TheContentListener extends Listener
{
    public function handle(mixed ...$args): mixed
    {
        $content = $args[0] ?? '';
        return $content . '<p>Appended by Nikogin.</p>';
    }
}

#[AsListener] parameters

Parameter	Type	Default	Description
name	string	required	The WordPress hook name
type	string	required	'action' or 'filter'
priority	int	10	Hook priority
argsCount	int	1	Number of arguments passed to handle()

#[AsListener(name: 'save_post', type: 'action', priority: 20, argsCount: 3)]

Auto-discovery

ListenerManager recursively scans app/Listeners/ — any class that extends Listener and has the #[AsListener] attribute is registered automatically. No manual registration needed.

app/Listeners/
├── Action/   ← scanned
└── Filter/   ← scanned

WARNING

The handle() method receives arguments via variadic spread (...$args). Access them by index: $args[0], $args[1], etc.