Announcing WPGraphQL for ACF v2.0.0

🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨

WPGraphQL for ACF has gone through a complete re-architecture and this repository will soon be archived.

We recommend you upgrade to the new WPGraphQL for ACF v2.0+ at your earliest convenience.

The new version contains breaking changes, so update with caution. Below are some resources to help:

• UPGRADE GUIDE: https://acf.wpgraphql.com/upgrade-guide
• NEW PLUGIN REPO: https://github.com/wp-graphql/wpgraphql-acf
• NEW PLUGIN ON WORDPRESS.ORG: https://wordpress.org/plugins/wpgraphql-acf
• NEW PLUGIN ON COMPOSER: https://packagist.org/packages/wp-graphql/wpgraphql-acf
• NEW PLUGIN ON WPPACKAGIST: https://wpackagist.org/search?q=wpgraphql-acf&type=any&search=

🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨

---

NOTE: This release does not contain any functional changes and serves as a way to draw attention to the new version of WPGraphQL for ACF.

What's Changed

• Revert "filter returned value with acf/format_value" by @jasonbahl in https://github.com/wp-graphql/wp-graphql-acf/pull/336
• Release/v0.6.1 by @jasonbahl in https://github.com/wp-graphql/wp-graphql-acf/pull/338

Full Changelog: https://github.com/wp-graphql/wp-graphql-acf/compare/v0.6.0...v0.6.1

What's Changed

• Fix: Internal server error 500 for relationship to non-published post by @rsm0128 in https://github.com/wp-graphql/wp-graphql-acf/pull/301
• Use date_i18n() to set correct timezone for date time fields by @esamattis in https://github.com/wp-graphql/wp-graphql-acf/pull/299
• feat: ACF v6 support by @jasonbahl in https://github.com/wp-graphql/wp-graphql-acf/pull/333
• Fix deprecated error in PHP > 8.0.0 by @fedek6 in https://github.com/wp-graphql/wp-graphql-acf/pull/313
• filter returned value with acf/format_value by @anacoelhovicente in https://github.com/wp-graphql/wp-graphql-acf/pull/309
• Update README.md by @RodrigoTomeES in https://github.com/wp-graphql/wp-graphql-acf/pull/290
• Release/v0.6.0 by @jasonbahl in https://github.com/wp-graphql/wp-graphql-acf/pull/335

New Contributors

• @fedek6 made their first contribution in https://github.com/wp-graphql/wp-graphql-acf/pull/313
• @anacoelhovicente made their first contribution in https://github.com/wp-graphql/wp-graphql-acf/pull/309
• @seripap made their first contribution in https://github.com/wp-graphql/wp-graphql-acf/pull/304
• @RodrigoTomeES made their first contribution in https://github.com/wp-graphql/wp-graphql-acf/pull/290

Full Changelog: https://github.com/wp-graphql/wp-graphql-acf/compare/v0.5.3...v0.6.0

Release Notes

Chores / Bugfixes

• Add support (and tests) for PHP 8
• (#279): Add new Github workflow to upload the Schema after each release
• (#273): Refactor documentation so each Field Type lives in it's own Markdown file

Release notes

Bugfix

• (#257) Fixes regression (and adds test to prevent future regression) where ACF Options Page fields were returning null.

Release Notes

Bugfix

• (#253): Fixes a bug (#251) where setting one field group to show_in_graphql = false was causing other field groups to also not show in the GraphQL Schema.

Release Notes

This release focuses primarily on Location Rules and how ACF Field Groups are mapped to the WPGraphQL Schema.

Bugfixes / Chores

• #174: Typo fix in README. Thanks @pickleat!
• #175: Fixes problem with return type on Select fields. Thanks @ljanecek!
• #191: Replaces deprecated acf_get_term_post_id() method. Thanks @sboerrigter!
• #197: Adds URI to play nice with Github Plugin Updater
• #235: Updates README to include docs for registering field groups in PHP. Thanks @XAce90!

New Features / Big Changes

LOCATION, LOCATION, LOCATION!!!

This release primarily addresses issues related to Field Group location rules and adding field groups to the GraphQL Schema.

Prior to this release, ACF Field Groups were added to the GraphQL Schema strictly by analyzing the ACF Location Rules for the field group(s) and attempting to map the field group to the Schema.

Some rules are quite nuanced and hard to translate, and in some cases this meant that the Field Group would simply not show up in the Schema, or in other cases the field group wouldn't show exactly where you wanted.

This release brings a new way of mapping ACF Field Groups to the WPGraphQL Schema.

It still uses ACF Location Rules to try and "guess" where in the Schema the field group should show, but now it shows you where it will be and allows you to opt-out of the auto-mapping and set the GraphQL Types the field group should show on manually.

🎥 👉 This video walks through this new functionality: https://youtu.be/VvrZGrcwv0Y

Closes the following issues:

• closes https://github.com/wp-graphql/wp-graphql-acf/issues/58
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/149
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/169
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/206
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/76
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/135
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/198
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/189
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/186
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/188
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/210
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/22
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/42
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/52
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/65
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/127
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/132
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/162
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/203
• closes https://github.com/wp-graphql/wp-graphql-acf/issues/233

---

📣 HUGE shout out to @drewbaker @rsm0128 and @funkhaus for putting a lot of time and energy into Location Rule revamp. Would not be where it is without your work!!! 🙌🏻

Release Notes

Bugfix

• (#205): Fixes a bug where Flex Fields and Repeater Fields were not properly showing in when requesting posts as Previews. (see issue: #202)

Release Notes

Breaking Change

• (#172) changes "range" field from Integer to Float. Thanks @BronsonQuick!

Bugfix

• (#168) fixes memory leak. Thanks @acburdine!

Release Notes

This adds support for ACF Fields to be shown with WPGraphQL Preview nodes. ACF revises meta, so when WPGraphQL returns a preview node, it uses the revised fields for ACF, where "normal" meta fields use the parent node's meta because "normal" meta is not revised.

GUTENBERG NOTE:

Gutenberg (the new WordPress block editor) currently has a bug that's causing meta to not be revised after posts are published, so this feature (previewing ACF meta) only works when using the Classic editor