README

Stub declarations for ACF Extended Pro core functions, classes, interfaces and traits. These stubs help plugin and theme developers leverage static analysis tools like PHPStan and improve IDE autocompletion.

The stubs are generated from the acf-extended-pro plugin folder using php-stubs/generator. ACF Extended Pro is a strict superset of the free version, so this single stub file covers both.

This package is not affiliated with or endorsed by ACF Extended. It contains only function and class signatures plus docblocks — no implementation. ACF Extended Pro is a commercial product; you must own a valid license to use it.

Requirements

• PHP ^8.0

Installation

Require this package as a development dependency with Composer:

composer require --dev webshr/acfe-pro-stubs

Alternatively download acfe-pro-stubs.php directly.

Versioning

Tags mirror the upstream ACF Extended Pro version they were generated from (e.g. tag 0.9.2.4 ↔ ACFE Pro 0.9.2.4). Pin to the version that matches your installed ACFE Pro release.

PHPStan

Reference the stub file from phpstan.neon:

parameters:
  scanFiles:
    - vendor/webshr/acfe-pro-stubs/acfe-pro-stubs.php

If you also use WordPress, combine with szepeviktor/phpstan-wordpress which already pulls in php-stubs/wordpress-stubs. You will likely also want stubs for ACF itself (the dependency ACFE builds on).

Regenerating the stubs

The acf-extended-pro/ source plugin is not redistributed in this repository (it is commercial code). To regenerate after an ACFE Pro release:

1. Place an extracted ACF Extended Pro plugin into acf-extended-pro/ at the repo root.

2. Run:

   composer install
   composer generate

3. Update CHANGELOG.md and tag the new version (matching the ACFE Pro version).

License

MIT for the stub generation tooling and the regenerated stub file. The original ACF Extended Pro source remains the property of its authors.