kaiseki/wp-reusable-blocks-admin-menu

Add a Reusable Blocks (wp_block) item to the WordPress admin menu via a kaiseki/wp-hook provider

1.0.0 2026-06-02 09:04 UTC

Requires

• php: ^8.2
• kaiseki/config: ^2.0
• kaiseki/wp-hook: ^2.0
• psr/container: ^1.1 || ^2.0

Requires (Dev)

• bnf/phpstan-psr-container: ^1.1
• kaiseki/php-coding-standard: ^1.0
• maglnet/composer-require-checker: ^4.0
• php-stubs/wordpress-stubs: ^6.2
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^11.0
• roave/security-advisories: dev-latest
• roots/wordpress-core-installer: *
• roots/wordpress-no-content: @stable
• szepeviktor/phpstan-wordpress: ^2.0
• thecodingmachine/phpstan-safe-rule: ^1.4

MIT

• Kaiseki
• David Mondok
• Wolfgang Schaefer

README

Add a Reusable Blocks (wp_block) item to the WordPress admin menu via a kaiseki/wp-hook provider.

A single kaiseki/wp-hook HookProviderInterface (ReusableBlocksAdminMenu) that registers a top-level admin menu entry linking to the wp_block post-type list (edit.php?post_type=wp_block), so editors can reach the reusable/synced block library directly. Title, capability, dashicon, and position are configurable.

Installation

composer require kaiseki/wp-reusable-blocks-admin-menu

Requires PHP 8.2 or newer.

Usage

Register ConfigProvider with your laminas-style config aggregator. It wires the ReusableBlocksAdminMenu factory and activates the provider via kaiseki/wp-hook:

use Kaiseki\WordPress\ReusableBlocksAdminMenu\ConfigProvider;

$config = (new ConfigProvider())();

Once active, the menu entry is added on the admin_menu action. Override any of the defaults under the reusable_blocks_admin_menu config key:

return [
    'reusable_blocks_admin_menu' => [
        'page_title' => 'Reusable Blocks', // defaults to __('Reusable Blocks')
        'menu_title' => 'Reusable Blocks', // defaults to __('Reusable Blocks')
        'capability' => 'delete_published_posts', // capability required to see the menu
        'icon'       => 'dashicons-layout', // dashicon (or icon URL)
        'position'   => 0,                  // menu position; 0 lets WordPress decide
    ],
];

Development

composer install
composer check   # check-deps, cs-check, phpstan

License

MIT — see LICENSE.