Skip to content

Contributing

Pedro Vidal edited this page Sep 22, 2026 · 1 revision

Contributing

Requirements

Setup

composer install
npm install
npm run env:start

See Development for the full local-environment commands and project structure.

Before opening a pull request

Run the full quality gate and make sure everything passes:

npm run lint:php
npm run lint:php:stan
npm run test:php
npm run test:js
npm run typecheck

Conventions

  • PHP: strict types (declare(strict_types=1)), typed everywhere possible, WordPress-Extra coding standards (WPCS)
  • Block names: pv-blocks-suite/{block-name}
  • Every block's block.json must declare "category": "pv-blocks-suite" and a realistic "example" — see Development for why these are enforced by tests, not just convention
  • All code, comments, docblocks, and commit messages: English

License

By contributing, you agree your changes are released under the GPL-2.0-or-later license, in line with the rest of the plugin.

Clone this wiki locally