yard / brave-hooks

v3.1.1 2026-09-14 12:07 UTC

Requires

• php: >=8.2
• ext-dom: *
• ext-intl: *
• ext-libxml: >=8.1
• lib-libxml: >=2.9
• roots/acorn: ^5.0
• spatie/laravel-csp: ^2.10
• spatie/laravel-package-tools: ^1.16
• yard/wp-hook-registrar: ^2.0

Requires (Dev)

• 10up/wp_mock: ^0.4.2
• pestphp/pest: ^3.0 || ^4.0 || ^5.0
• php-stubs/gravity-forms-stubs: ^2.9
• szepeviktor/phpstan-wordpress: ^2.0
• yard/php-cs-fixer-rules: ^1.0

MIT

Published on Packagist.org on 2026-09-14 12:07 UTC

README

Features

• Register Hooks using php attributes
• Configure Hook registration using a config file
• Load plugin-specific hooks only when the plugin is active

Installation

1. Install this package with Composer:

   composer require yard/brave-hooks

2. Run the Acorn WP-CLI command to discover this package:

   wp acorn package:discover

3. Publish the config file with:

   wp acorn vendor:publish --provider="Yard\Brave\Hooks\HookServiceProvider"

4. Register all your project hooks in the published configuration file config/hooks.php.

Usage

Add your custom hook classes to the hooks configuration file. Any hooks defined within these classes will be automatically registered with WordPress.

This plugin leverages wp-hook-registrar for hook registration. For detailed information about the hook registration process, please refer to that package's documentation.

Plugin-specific Hooks

Some classes contain hooks that should only be active when a specific WordPress plugin is active. To achieve this, add the #[Plugin] attribute to the class containing hooks and provide the plugin's file path:

The plugin path should match the format required by the WordPress function is_plugin_active()

#[Plugin('advanced-custom-fields-pro/acf.php')]
class ACF
{
    ...
}

About us