README

This package provides stub declarations for Wordpress core functions, classes, interfaces, and global variables. These stubs can help plugin and theme developers leverage static analysis tools.

The stubs are generated directly from the johnpbloch/wordpress-core using giacocorsiglia/stubs-generator. Needless to say, this library repackages a subset of Wordpress code, which is the work of Automattic. Granted, it's a useless subset without the real thing!

Many thanks to GiacoCorsiglia, who did all the hard work on giacocorsiglia/wordpress-stubs, from which this is shamelessly ripped off and to Paul Walton who created the Advanced Custom Fields Stubs that is the base using for this stub.

Installation

Require this package as a dev-dependency with Composer:

composer require --dev baxtian/wordpress-stubs

Alternatively, you may download wordpress-stubs.php directly.

Versioning

This package is versioned to match the Wordpress version from which the stubs are generated. If any fixes to stubs are required, subsequent releases will be versioned as WORDPRESS_VERSION.X.

Generating stubs for a different Wordpress version

You should be running PHP 8.1 or later to follow these steps, so any function definitions that are polyfills for older versions of PHP are excluded from the stubs. Additionally, the Stubs Generator package at least requires PHP 8.1.

1. Clone this repository and cd into it.
2. Update "johnpbloch/wordpress-core": "X.X.X" in composer.json with your desired version.
3. Run composer update
4. Run ./generate.sh

The wordpress-stubs.php file should now be updated. Feel free to submit a Pull Request if you'd like to see a release for a newer version. If things have fallen behind, please generate stubs for each missing version in a distinct commit so we can have a continuous release history.