ralfhortt / wp-block

3.2.0 2026-04-02 14:58 UTC

Requires

• ralfhortt/service-contracts: ^1.0

Requires (Dev)

• brain/monkey: ^2.6
• mockery/mockery: ^1.6
• pestphp/pest: ^4.1
• phpstan/phpstan: ^1.10
• szepeviktor/phpstan-wordpress: ^1.3

GPL-2.0-or-later

• Ralf Hortt

Published on Packagist.org on 2026-04-02 15:01 UTC

README

A fluent PHP wrapper for registering WordPress blocks and adjusting block metadata (defaults, supports, styles, variations).

Installation

composer require ralfhortt/wp-block

Requires PHP 8.3+.

Documentation

Class	Purpose
BlockManifest	Register blocks from a build manifest
Block	Abstract base for PHP-rendered custom blocks
BlockDefaults	Override attribute defaults (incl. callbacks)
BlockSupports	Add or remove block supports for one block
BlockStyles	Add or remove block styles
BlockVariations	Add or remove block variations
BlockManager	Supports + styles + variations for one block
BlockPatterns	Pattern categories; disable core/remote patterns

WordPress hooks reference

Quick example

use RalfHortt\WPBlock\BlockManifest;

(new BlockManifest(__DIR__ . '/build/blocks/blocks-manifest.php'))->register();

Development

composer install
composer test              # Run tests
composer test:coverage     # With coverage
composer phpstan           # Static analysis (level 8)
composer ci                # validate + phpstan + test

Pest, PHPStan, Brain Monkey, and GitHub Actions CI.

Changelog

See CHANGELOG.md.

License

GPL-2.0-or-later — see LICENSE.

Credits

Ralf Hortt