Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

CI pipeline

Overview of the ACPT automated test and code quality CI pipeline.

The CI pipeline configuration described here reflects ACPT 2.1.0. Pipeline details may evolve between releases.

ACPT ships with a GitHub Actions CI pipeline that runs on every push and pull request. The pipeline enforces code quality, type safety, and functional correctness.

Trigger conditions

The pipeline runs automatically on:

  • Push to branches: main, master, develop, feature/*, cct

  • Pull requests targeting: main, master, develop

Jobs

1. PHPStan static analysis

Runs PHP static analysis at level 7 with PHP 7.4 compatibility mode.

Scope: src/ and functions/ directories.

Key settings:

  • phpVersion: 70400 — all code must be compatible with PHP 7.4

  • Memory limit: 2 GB

  • Baseline: empty — no suppressed errors. All issues must be fixed at the source.

A second PHPStan run analyses the tests/ directory at PHP 8.0 compatibility (continue-on-error: true — test suite may use PHP 8 features).

To run locally:

2. PHPUnit tests

Runs the full PHPUnit test suite against a real MySQL 8.0 database.

Environment:

  • PHP 8.3

  • MySQL 8.0 service (root password: root, database: wordpress_test)

  • WordPress test library set up via bin/install-wp-tests.sh

Excluded tests:

Tests tagged @group external are skipped in CI because they make real network calls:

To run all tests locally (including external):

To run a single test file:

Test suites

Directory
Coverage

tests/api/

REST API v1 controllers

tests/commands/

CQRS Command and Query classes (31+ files)

tests/data/

Data handling and serialisation

tests/functions/

PHP helper functions and settings

tests/integrations/

Page builder integrations (Gutenberg, Elementor, Bricks)

tests/models/

Entity model unit tests

tests/objects/

Value object tests

tests/repo/

Repository layer tests

tests/shortcodes/

WordPress shortcode output

tests/unit/

Low-level unit tests (CCT field rendering, value normalization)

CCT-specific tests

ACPT 2.1.0 introduces dedicated test coverage for Custom Content Types:

File
Description

tests/api/v1/TableRecordControllerTest.php

77+ integration tests for the CCT REST API

tests/api/v1/TableControllerTest.php

Table management endpoints

tests/commands/SaveTableGroupCommandTest.php

Table group CQRS commands

tests/models/TableModelCreateTableTest.php

Schema creation

tests/models/TableModelPermissionsTest.php

Permission trait (10 tests)

tests/models/TableModelVisibilityTest.php

Visibility rules

tests/functions/values/fields/single/CCT*FieldValuesTest.php

Per-field-type value handling (Address, Currency, Date, Media, Number, Phone, Relations, Text)

tests/unit/CCTFieldRenderTest.php

Field rendering

tests/unit/CCTValueNormalizerTest.php

Value normalization

PHPStan level 7 — zero baseline

vendor/bin/phpstan analyse runs clean with zero errors and an empty phpstan-baseline.neon. Do not add new entries to the baseline — fix issues at the source.

See CLAUDE.md in the plugin repository for detailed patterns used to fix common level-7 errors (string|false returns, WP API unions, dynamic class instantiation, etc.).

Running the full quality check locally

PreviousLogs
NextFunctions

Last updated