paulthewalton / acf-pro-stubs
Advanced Custom Fields Pro function, class and global variable declaration stubs for easier static analysis.
Installs: 45 442
Dependents: 4
Suggesters: 0
Security: 0
Stars: 18
Watchers: 2
Forks: 8
Open Issues: 0
Requires
Requires (Dev)
- php: ^7.1
- ext-gettext: *
- advanced-custom-fields/advanced-custom-fields-pro: *
- giacocorsiglia/stubs-generator: ^0.5.0
This package is auto-updated.
Last update: 2022-12-04 06:31:26 UTC
README
This project has been abandoned. I recommend using php-stubs/acf-pro-stubs instead, as it is far more up-to-date and actively maintained.
WordPress Advanced Custom Fields PRO Stubs
Just like paulthewalton/acf-stubs, but for ACF Pro!
This package provides stub declarations for Wordpress Advanced Custom Fields (ACF) 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 source using giacocorsiglia/stubs-generator. Needless to say, this library repackages a subset of WordPress ACF code, which is the work of the WordPress core ACF developers. 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.
Installation
Require this package as a dev-dependency with Composer:
composer require --dev paulthewalton/acf-pro-stubs
Alternatively, you may download acf-pro-stubs.php
directly.
Usage for Intellisense
From Wordpress Stubs:
If your editor has trouble parsing all of WordPress, you may find the stubs useful for enabling code completion and related features. For example, here are instructions for usage with VSCode's Intelephense extension. (In my experience, however, Intelephense parses WordPress core just fine.)
Versioning
This package is versioned to match the ACF version from which the stubs are generated. If any fixes to stubs are required, subsequent releases will be versioned as ACF_VERSION.X
.
Generating stubs for a different ACF version
Retrieving the source code for ACF Pro requires you to have a valid license key. You should be running PHP 7.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 7.1.
-
Clone this repository and
cd
into it. -
Set the environment variable
ACF_PRO_KEY
to your ACF PRO key.Alternatively you can add an entry in a
.env
file:# .env (same directory as composer.json) ACF_PRO_KEY=Your-Key-Here
-
Update the version number in
composer.json
with your desired version:Choosing an older version
If generating stubs for an older version of ACF Pro, you can just specify the lower version number in the dependancies array.
"advanced-custom-fields/advanced-custom-fields-pro": "X.X.X"
Choosing a newer version
To generate from a newer version of ACF Pro, you'll need to change the version in the package repository.
{ "type": "package", "package": { "name": "advanced-custom-fields/advanced-custom-fields-pro", "version": "X.X.X", //... } }
-
Run
composer update
-
Run
./generate.sh
The acf-pro-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.