Documentation · Developer Documentation

Testing Guide

This page describes the plugin's testing approach at a high level. The internal test architecture, bootstrap stubs, fixture layout and the exact contents of the test suite are not published here.

What contributors need to know

  • The plugin ships with a PHP unit-test suite that runs locally and in the project's continuous integration.
  • Tests are written with PHPUnit and target PHP 8.1 or later, matching the plugin's own runtime requirement.
  • New behavioural changes are expected to be accompanied by tests when the behaviour can reasonably be exercised by unit tests.

For environment setup (PHP, Composer, WordPress) see Local Development Setup. For the conventions new code should follow, see Coding Standards.

The internal organisation of the test suite, the helpers it uses, and the private continuous-integration workflow are implementation details.

Supported public integration surfaces

When integrating with the plugin, prefer these stable surfaces:

Internal class names, option keys, database tables, REST and AJAX endpoints, cron hook names, capability and nonce identifiers, and release / update infrastructure are treated as implementation details. They may change between releases without notice and are not part of the public integration contract.

Stability and change policy

Anything not listed as a supported public surface above is considered an internal implementation detail. Internal APIs, storage layout and security implementation may change between releases. Do not depend on them from third-party code, themes or external systems. Direct database writes are not supported.

Public documentation notice. This page provides a high-level integration overview only. Internal implementation details, private APIs, storage internals and security-sensitive release infrastructure are maintained separately and are not part of the public documentation. Supported integration surfaces are the documented shortcodes, template overrides, settings UI and any extension points explicitly published in this section.