NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #4159 most downloaded on Packagist
Create fields, blocks, option pages, and widgets using ACF Builder and Sage 10
Latest stable
v3.4.8
Last release 16 days ago
06 Nov 2026
Ships unpredictably
gaps range from 8 days to 10 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
104 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
🩹 Pass auto_inline_editing when registering uncached blocks by @frugan-dev in https://github.com/Log1x/acf-composer/pull/371
auto_inline_editing when registering uncached blocks by @frugan-dev in https://github.com/Log1x/acf-composer/pull/371Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.4.7...v3.4.8
✨ Add inline editing for blocks (ACF 6.7+) by @dsturm in https://github.com/Log1x/acf-composer/pull/361
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.4.6...v3.4.7
Your coding agent can read these notes before it upgrades. Set up the MCP server →
📝 Update README for Sage 11 compatibility by @rguttersohn in https://github.com/Log1x/acf-composer/pull/359
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.4.5...v3.4.6
🩹 fix: block.json: wrong names for contexts by @dulgermuhammet in https://github.com/Log1x/acf-composer/pull/363
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.4.4...v3.4.5
🩹 Fix publishing stubs by @harryscheiner in https://github.com/Log1x/acf-composer/pull/342
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.4.3...v3.4.4
🩹 Fix potential exception on the ACF health page by @Log1x in https://github.com/Log1x/acf-composer/pull/337
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.4.2...v3.4.3
🩹 Pass current $block instance to the asset hook by @danlapteacru in https://github.com/Log1x/acf-composer/pull/332
$block instance to the asset hook by @danlapteacru in https://github.com/Log1x/acf-composer/pull/332Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.4.1...v3.4.2
🩹 Re-separate api version and block version by @Log1x in https://github.com/Log1x/acf-composer/pull/329
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.4.0...v3.4.1
🧑💻 Utilize native WordPress handling of block wrapper HTML attributes by @Log1x in https://github.com/Log1x/acf-composer/pull/313
$apiVersion property to blocks by @drbroad in https://github.com/Log1x/acf-composer/pull/321Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.3.0...v3.4.0
🧑💻 Enhance search on acf:usage for multiple results
acf:usage for multiple results (#301)acorn optimize in Acorn v5 (#299)collect() (Fixes #303) (#307)fields() method optional (#298)fields() methodacf:usage when dealing with similar field namesgradients typo on default block supports (Fixes #308) (#309)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.2.4...v3.3.0
🧑💻 Add blockVersion & validate props for blocks
blockVersion & validate props for blocks (#300)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.2.3...v3.2.4
🐛 Respect post type restrictions for cached blocks
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.2.2...v3.2.3
🐛 Only set parent and ancestor when not empty (Fixes #293)
parent and ancestor when not empty (Fixes #293) (#294)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.2.1...v3.2.2
🔧 Use the default array for parent and ancestor block settings
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.2.0...v3.2.1
✨ Add a acf:usage command to search/show field type usage examples
acf:usage command to search/show field type usage examples (#285)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.1.3...v3.2.0
✨ Add Builder::addPartials for adding multiple partials in an array
Builder::addPartials for adding multiple partials in an array (#286)Widget::show() method to control widget visibility when rendering (#287)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.1.2...v3.1.3
🔧 Lower the render template hook priority
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.1.1...v3.1.2
🩹 Suppress the template_not_found_message when rendering cached blocks on ACF v6.3.x
template_not_found_message when rendering cached blocks on ACF v6.3.x (#281)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.1.0...v3.1.1
🧑💻 Add support for passing partials for flexible content to ->addLayout (Fixes #257)
->addLayout (Fixes #257) (#275)InvalidFieldsException when fields are invalidFull Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.29...v3.1.0
🧑💻 Add modifyField to Builder intellisense
modifyField to Builder intellisense (#272)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.28...v3.0.29
🩹 Fix innerBlocks template handling (Fixes #269)
innerBlocks template handling (Fixes #269) (#270)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.27...v3.0.28
🩹 Check if template is an array before handling
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.26...v3.0.27
🧑💻 Improve block template syntax handling (Fixes #239)
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.25...v3.0.26
🦺 Add validation support to uncached blocks (Fixes #254)
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.24...v3.0.25
📝 Change field to field group by @johanmolen in https://github.com/Log1x/acf-composer/pull/238
acf/init priority to 100 to improve compatibilityFull Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.23...v3.0.24
🧑💻 Add textdomain to blocks (Fixes #233)
textdomain to blocks (Fixes #233)acf_block_version is set to 2 (#232)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.22...v3.0.23
🐛 Fix legacy widget registration
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.21...v3.0.22
@marcbelletre made their first contribution in https://github.com/Log1x/acf-composer/pull/228
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.20...v3.0.21
🧑💻 Improve the acf:cache command output
Block class (#227)acf:cache command outputacf:upgrade confirm to yesFlexibleContentBuilder conditional code stylebeforeRegister() and afterRegister() overridable methods to ComposersComposer contractcompose docblocksFull Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.19...v3.0.20
This dramatically improves load performance of individual blocks in the editor.
This dramatically improves load performance of individual blocks in the editor.
block.json when caching (#224)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.18...v3.0.19
🧑💻 Prevent ACF Composer from booting multiple times
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.17...v3.0.18
🩹 Fix path keys for acf:upgrade command
acf:upgrade command (#225)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.16...v3.0.17
🎨 Improve the cache manifest implementation
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.15...v3.0.16
🧑💻 Improve Builder intellisense in child contexts
Builder intellisense in child contexts (#221)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.14...v3.0.15
🐛 Fix parent context inside of Repeaters and Groups (Fixes #219)
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.13...v3.0.14
🩹 Fix calling custom types (Fixes #217)
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.12...v3.0.13
🩹 Fix registering field groups with no fields (Fixes #215)
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.11...v3.0.12
✨ Add support for registering multiple field groups in a single Field Composer (Fixes #182)
Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.10...v3.0.11
🐛 Fix block template handling (Fixes #212)
example() methodFull Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.9...v3.0.10
✨ Add an attributes() method for cleanly & safely setting block properties instead of using __construct
attributes() method for cleanly & safely setting block properties instead of using __constructassets with method_exists to prevent unnecessary clashingalign_content conditionalassets method (Fixes #206)styles property on stubsexample() method in the block construct stubassets() replacement in acf:upgradegetTemplate() (#209)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.8...v3.0.9
🩹 Add missing Exception namespace (Fixes #205)
Exception namespace (Fixes #205) (#207)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.7...v3.0.8
🧑💻 Add block construct replacements to acf:upgrade
acf:upgradeacf:ide-helpers command_ide-helpers.php to the .gitignore file$composer in the Block construct stub (#202)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.6...v3.0.7
✨ Add an acf:ide-helpers command to generate IDE helpers for configured custom field types
acf:ide-helpers command to generate IDE helpers for configured custom field types (#201)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.5...v3.0.6
🧑💻 Improve intellisense for addPartial on repeaters and groups
addPartial on repeaters and groups (#200)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.4...v3.0.5
🩹 Fix partial detection when running acf:upgrade
acf:upgrade (#199)🗑️ Deprecate enqueue() in place of assets($block)
Builder (Fixes #197)enqueue() in place of assets($block)enqueue() with assets($block)Full Changelog: https://github.com/Log1x/acf-composer/compare/v3.0.2...v3.0.3
🩹 Pass empty array to enqueue()'s $block when replacing with acf:upgrade
enqueue()'s $block when replacing with acf:upgrade (#196)🩹 Fix the replacements property in acf:upgrade (Fixes #194)
🗑️ Deprecate the get() Partial method
If you generated Blocks using the --construct option, you will need to manually update the block __construct()'s with a find & replace:
- use Roots\Acorn\Application;
+ use Log1x\AcfComposer\AcfComposer;
- public function __construct(Application $app)
+ public function __construct(AcfComposer $composer)
- parent::__construct($app);
+ parent::__construct($composer);
Once done, continue to the upgrade guide below.
composer.json as Acorn.composer require log1x/acf-composer to upgrade to ^3.0.wp acorn acf:upgrade.Going forward, it is recommended to use the new Builder class:
- use StoutLogic\AcfBuilder\FieldsBuilder;
+ use Log1x\AcfComposer\Builder;
- $listItems = new FieldsBuilder('listItems');
+ $listItems = Builder::make('listItems');
When using the new Builder class, you can now use ->addPartial() to add field partials:
- $listItems->addFields($this->get(Partial::class));
+ $listItems->addPartial(Partial::class);
Inside of Blocks, enqueue() has been changed to assets($block):
- public function enqueue()
+ public function assets($block)
Running wp acorn acf:upgrade should do all of the above for you automatically.
There are 2 new entries to the acf.php config if you have it published:
/*
|--------------------------------------------------------------------------
| Custom Field Types
|--------------------------------------------------------------------------
|
| Here you can define custom field types that are not included with ACF
| out of the box. This allows you to use the fluent builder pattern with
| custom field types such as `addEditorPalette()`.
|
*/
'types' => [
// 'editorPalette' => 'editor_palette',
// 'phoneNumber' => 'phone_number',
],
/*
|--------------------------------------------------------------------------
| Cache Manifest Path
|--------------------------------------------------------------------------
|
| Here you can define the cache manifest path. Fields are typically cached
| when running the `acf:cache` command. This will cache the built field
| groups and potentially improve performance in complex applications.
|
*/
'manifest' => storage_path('framework/cache'),
ACF Composer now includes field group caching. It may be a good idea to add this to your deployment script:
$ wp acorn acf:cache
You can view the status of the cache by running wp acorn acf:cache --status or wp acorn about.
Seen in the config changes above is support for adding custom field types to the Builder. This should help tidy up code a bit when using custom types like ACF Phone Number and ACF Editor Palette.
Once defined in config/acf.php, you can generate IDE helpers for them using wp acorn acf:ide-helpers.
- $fields->addField('mobile_number', 'phone_number');
+ $fields->addPhoneNumber('mobile_number');
Please open an issue if you experience any problems.
$block data to enqueue() (#154)acf:cache command for caching built field groups (Fixes #176)FieldsBuilder wrapper for improved builder support (Fixes #173)acf:upgrade command to upgrade classes to v3acf:clear command to clear the ACF Composer cache$settings property to pass additional settings to acf_add_options_page() (#156)acf/init (#163)uses_context and provides_context (#153)laravel/pint to the projectroots/acorn to the projectsquizlabs/php_codesniffer from the projecttypes and manifest configuration to the ACF Composer config$redirect property default value to falseacf-composer to make publishing assets easiersuggest and scripts configurationget() Partial method--status option to the acf:cache commandBuilder classacorn aboutcomposer.lock to .gitignoreFull Changelog: https://github.com/Log1x/acf-composer/compare/v2.1.0...v3.0.0
This is a maintenance release. Please try to use 3.x instead.
This is a maintenance release. Please try to use 3.x instead.
🩹 Fix block type registration in WordPress 6.8 by @harryscheiner in https://github.com/Log1x/acf-composer/pull/344
Full Changelog: https://github.com/Log1x/acf-composer/compare/v2.1.1...v2.1.2
This is a maintenance release. Please try to use 3.x instead.
This is a maintenance release. Please try to use 3.x instead.
Full Changelog: https://github.com/Log1x/acf-composer/compare/v2.1.0...v2.1.1
enhance(block): Add missing block render callback properties
$context param to block render callback (Fixes #130)$wp_block param to block render callback$block->context property to access $context$block->instance property to access $wp_block$post_id property definitionfields() docblock return type (#134)chore(block): Change $example conditional to explicitly require false to disable block preview
$example conditional to explicitly require false to disable block preview (#126)enhance(block): Conditionally check if $this->example is not null before setting it
$this->example is not null before setting it (#124)
acf_register_block_type instead of acf_register_blockThis might fix random issues related to #109 – not sure.
This might fix random issues related to #109 – not sure.
$this->app->make to bottom of boot methodfix: Replace Str::remove() with str_replace() for Acorn 1.x compatibility
Str::remove() with str_replace() for Acorn 1.x compatibilityfeat(stubs): Allow customization of console stubs
feat(composer): Sort loaded composers by name
fields() call (#112)enhance(blade): Only replace last occurrence of "preview"
fix(make-command): fix directory separator for Windows (Fixes #71)
One column per quarter.