Download the PHP package stoutlogic/acf-builder without Composer
On this page you can find all versions of the php package stoutlogic/acf-builder. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download stoutlogic/acf-builder
More information about stoutlogic/acf-builder
Files in stoutlogic/acf-builder
Package acf-builder
Short Description An Advanced Custom Field Configuration Builder
License GPL-2.0+
Informations about the package acf-builder
ACF Builder
Create configuration arrays for Advanced Custom Fields Pro using the builder pattern and a fluent API.
Quickly create, register, and reuse ACF configurations, and keep them in your source code repository. To read more about registering ACF fields via php consult https://www.advancedcustomfields.com/resources/register-fields-via-php/
Simple Example
$banner->build();
will return:
As you can see it saves you a lot of typing and is less error-prone. But brevity and correctness isn't the only benefit, you can reuse field configurations in multiple places. For example, a group of fields used for backgrounds:
Reuse Example
Here a background
field group is created, and then used in two other field groups, including twice in the section
field group. This can really DRY up your code and keep your admin UI consistent. If you wanted to add a light/dark field for the text color field based on the background used, it would just need to be added in one spot and used everywhere.
Install
Use composer to install:
If your project isn't using composer, you can require the autoload.php
file.
Tests
To run the tests you can manually run
or you can use the built in gulp task to run it on file change
Requirements
PHP 5.4 through 7.2 supported but automated tests cannot be run anymore so it might stop working at some point.
= 7.4, 8 Tested
Documentation
See the wiki for more thorough documentation. The documentation has its own repository and accepts pull requests for contributions. Any merges to master will get synced with the wiki here under the main project.