描述
Advanced Custom Fields turns WordPress sites into a fully-fledged content management system by giving you all the tools to do more with your data.
使用 Advanced Custom Fields 插件便能完全控制 WordPress 网站的编辑画面及自定义字段数据。
依据需求添加字段。插件的字段产生器能让网站管理员快速轻松地在几个点击操作后,将字段添加至 WordPress 网站的编辑画面。
将字段添加至任何位置。可将自定义字段添加至 WordPress 网站的任意位置,包含文章、用户、各式分类法、媒体、留言,甚至是自定义设置页面。
在任何位置显示自定义字段。使用插件内的免开发经验友善功能,便可在任何布景主题范本文件内加载并显示自定义字段及其字段值。
插件特色
- 使用方式简单直觉
- 功能强大
- 超过 30 种自定义字段类型
- 完整的在线说明文档
- 超过百万的爱用者
相关链接
付费 PRO 版
The Advanced Custom Fields plugin is also available in a professional version which includes more fields, more functionality, and more flexibility!
- The Repeater Field allows you to create a set of sub fields which can be repeated again, and again, and again.
- ACF Blocks, a powerful PHP-based framework for developing custom block types for the WordPress Block Editor (aka Gutenberg).
- Define, create, and manage content with the Flexible Content Field, which provides for multiple layout and sub field options
- Use the Options Page feature to add custom admin pages to edit ACF fields.
- Build fully customisable image galleries with the Gallery Field
- Unlock a more efficient workflow for managing field settings by reusing existing fields and field groups on demand with the Clone Field
安装
从 WordPress 网站管理后台进行安装
- 造访 [插件] > [安装插件] 页面。
- 搜索「Advanced Custom Fields」。
- 在 [插件] 页面中安装并启用 Advanced Custom Fields。
- 点击 管理后台左侧菜单上的 [自定义字段],并创建第一个自定义字段群组。
- Read the documentation to get started
常见问题
-
插件开发者能为用户提供的技术支持有哪些?
-
支持论坛:插件的官方社群论坛为搜索及寻找已回答过的技术支持问题提供了良好的资源。免费版用户可以在技术支持论坛上创建新主题,但不保证会收到官方技术支持团队的回复。这里更像是开发人员相互交流、发布想法、插件及提供基本协助的地方。查看技术支持论坛内容
评价
贡献者及开发者
“Advanced Custom Fields (高级自定义字段)” 是开源软件。 以下人员对此插件做出了贡献。
贡献者更新日志
5.12.2
Release Date 6th April 2022
- Fix – Cloned fields in custom named options pages now behave correctly
- Fix – Default values and the
acf/load_value
filter are now applied if a field value load fails security validation - Fix – The ACF field is no longer present in REST responses if the ACF REST API setting is disabled
- Fix – Duplicating a flexible content layout or repeater row now also replaces the field ID in
for
attributes
5.12.1
Release Date 23rd March 2022
- New – REST API now supports the comment route for displaying ACF fields.
- Fix – ACF now validates access to option page field values when accessing via field keys the same way as field names. View More
- Fix – REST API now correctly validates fields for POST update requests
- Fix – Fixed an issue where invalid field types caused an error during REST API requests
- Fix – Fixed a PHP warning when duplicating an empty field group
- Fix – Fixed a bug preventing block duplication detection changing an ACF Block’s ID if it was nested deeper than one level inside another block
- Fix – Fixed a bug where the
acf-block-preview
wrapper might not appear around a block if it was saved in edit mode - i18n – Updated several translations from user contributions (Thanks to Dariusz Zielonka, Mikko Kekki and Alberto!)
5.12
Release Date 23rd February 2022
- View Release Post
- New – ACF blocks now support the new Full Site Editor included in WordPress 5.9
- New – ACF blocks now support the WordPress Query Loop block
- New – Added block caching system to reduce the number of AJAX calls in the block editor
- Enhancement – Block preloading can now be disabled by using “acf_update_setting( ‘preload_blocks’, false );” in the “acf/init” action hook
- Enhancement – ACF and ACF PRO will now detect if each other are active and deactivate the other plugin on plugin activation
- Fix – Fixed an issue with the media library not working correctly in ACF Blocks in WordPress 5.9.1
- Fix – Fixed an issue where anchors weren’t working correctly in WordPress 5.9
- Fix – Fixed an issue where the “unfiltered_html” capability wasn’t being used by ACF blocks
- Fix – Fixed an issue where it was impossible to update an ACF block inside the widget block editor
- Fix – Fixed an issue where ACF fields might not appear in REST API calls made via internal WordPress functions
- Fix – Warnings and PHP 8.1 deprecation notices in REST API
- Fix – Better support for double byte characters in “acf_get_truncated()” (props @cabradb)
- i18n – Broken link in the Croatian translation
- i18n – Automated building of acf.pot for translators in each release
5.11.4
Release Date – 2nd December 2021
- Fix – Fixed several Select2.js conflicts with other plugins
- Fix – Fixed an issue where block name sanitization could change valid block names containing double hyphens
- Fix – Fixed an issue where blocks with integer IDs could fail to load example field data
5.11.3
Release Date – 24th November 2021
- Fix – Fixed a bug when accessing field values for options pages registered with a custom post_id
5.11.2
Release Date – 24th November 2021
- Fix – Previously implemented data access changes for get_field() and the_field() are now limited to the ACF shortcode only. Learn more
- Fix – get_field() and the_field() functions can once again access meta values regardless of being registered with ACF, restoring functionality that existed before 5.11
- Fix – get_field() and the_field() functions now are only able to access site options which are ACF fields
- Fix – UI issues for select boxes related to Yoast and WooCommerce’s select2 versions by upgrading our select2 version, and updating our CSS to support older versions
- Fix – User fields failed to load values when using the legacy select2 v3 option
- Fix – acf_slugify() now correctly supports special characters which solves issues with block names or field group names (during imports) containing those characters
- Fix – PHP Notice generated while processing a field group’s postbox classes
5.11.1
Release Date – 18 November 2021
- Enhancement – Added “acf/admin/license_key_constant_message” filter to allow changing of the “Your license key is defined in wp-config.php” message
- Fix – Added warning for when get_field() or similar functions are called before ACF has initialized. Learn more
- Fix – Fixed fields not appearing on user REST API endpoints if their field group location was set to a user form other than “all”
- Fix – Fixed warning in REST API if a custom field type did not have the “show_in_rest” property
- Fix – Fixed an error that could occur if value of WYSIWYG field was not a string
5.11
Release Date – 10 November 2021
- View Release Post
- New – Fields can now be viewed and updated with the WordPress REST API (props @mishterk)
- New – License key can now be defined in code with the “ACF_PRO_LICENSE” constant
- Enhancement – Improved error handling for expired or deactivated licenses
- Enhancement – Improved support for various block editor features, such as block styles and padding/spacing
- Enhancement – Added support for using WordPress “Screen Options” to hide field groups in Classic Editor
- Enhancement – Support filters adding custom classes on date and time field inputs
- Enhancement – Support filtering ACF shortcode attributes (with the “shortcode_atts_acf” filter)
- Fix – Removed usages of PHP “extract()” function
- Fix – Fixed a security issue with user field
- Fix – Fixed a security issue with “acf_get_value()”
- Fix – Correctly set “.acf-block-preview” wrapper when previewing a block in auto mode
- Fix – Resolved an issue with select2 rendering for nav menu fields
- Fix – Fixed an issue with file validation that occurred when removing a file that failed validation
- Fix – Fixed a notice in “acf_prepare_field()”
- Fix – Prevented an issue where setting an empty string for the return format of date and time fields would cause JS errors
- Fix – Fix issues with conditional logic for multi-select fields (props @bhujagendra-ishaya)
- Fix – Added support for Google Maps schema change which prevented Google Maps fields from correctly saving the city for some areas
- Fix – Fixed an issue where removing the collapsed property of a repeater prevents viewing previously collapsed rows
- i18n – Updated Polish Translations (props @webnatural)
- Dev – Formatted JavaScript to WordPress code standards
5.10.2
Release Date – 31 August 2021
- Fix – Fixed block duplication issues which created blocks with duplicate block IDs
- Fix – Fixed an issue with ACF errors displaying in the media library outside of ACF fields
- Fix – Changed label of “Enable Opacity?” to “Allow transparency” in the colour picker
- Fix – Revert “style” attributes of ACF Blocks to 5.9.x behaviour for template compatibility
- Fix – Allow safe HTML inside select2 field labels
- Fix – Don’t render the “acf-block-preview” div when preloading blocks in edit mode
5.10.1
Release Date – 26 August 2021
- Fix – Fixed conflict with WooCommerce loading SelectWoo which is not directly compatible with Select2.
5.10
Release Date – 25 August 2021
- View Release Post
- Enhancement – Improved security by running all user-generated content through
wp_kses()
by default - Enhancement – New ACF Blocks features
- Switched to v2 of the Blocks API for WordPress 5.6+
- Block preloading now enabled by default
- Block preloading now supports blocks set to “Edit” mode
- Add support for full height alignment setting
- Enhancement – Added setting to color picker field to enable an opacity slider
- Enhancement – Allow deletion of first field group location rule if multiple rules have been added thanks to Arthur Shlain
- Fix – Fixed vulnerability with
acf_shortcode()
where users with subscriber role could view arbitrary ACF data, thanks to Keitaro Yamazaki - Fix – Fixed vulnerability where users with subscriber role could move fields and view field groups, thanks to Keitaro Yamazaki
- Fix – Fixed issue where fields in legacy widgets weren’t saving in new widget block editor
- Fix – Fixed issue with custom field validation in scheduled posts
- Fix – Fixed warnings thrown by clone field if the cloned field group is empty
- Fix – Fixed issue where Select2 search input wouldn’t have focus in WordPress 5.8+
- Fix – Fixed issue with Select2 value sorting when Yoast SEO is installed
- Fix – Fixed deprecation warnings in block editor in WordPress 5.6+
- i18n – Updated Swedish translation thanks to Erik Betshammar
5.9.9
Release Date – 20 July 2021
- Fix – Fixed warning when deleting fields which don’t exist
- Fix – Fixed issues with older browsers and the blocks JavaScript
- Fix – Fixed file size & file type validation for front end forms using the basic uploader
5.9.8
发布时间 – 08 7月 2021
- 修复 – 修复了导致多个图像字段无法正确验证文件的错误
- 修复 – 修复了阻止区分大小写的 HTML 标签在块中工作的错误
- 修复 – 修复了导致启用 JSX 的块在预览中不正确删除空格的错误
- 修复 – 修复了在编辑保存的字段时导致文本字段删除 HTML 实体的错误
- 修复 – 修复了“添加字段组”页面上不推荐使用的 jQuery 通知
5.9.7
发布日期 – 2021年6月22日
- 修复 – 修复了由于
add_menu_page()
/add_submenu_page()
的参数类型不正确而记录的 PHP 警告 - 修复 – 修复了导致 WYSIWYG 字段不保留换行符的错误
- 修复 – 修复了导致电子邮件字段错误地使带有 unicode 字符的电子邮件无效的错误
- 修复 – 修复了在某些情况下导致文件类型验证失败的错误
- 修复 – 修复了新上传或选择的图片不包含自定义预览尺寸数据的问题
5.9.6
Release Date – 20 May 2021
- Enhancement – Added ‘position’ setting compatibility for Options Page submenus.
- Enhancement – Visually highlight “High” metabox area when dragging metaboxes.
- Fix – Fixed compatibility issue between Block matrix alignment setting and the latest version of Gutenberg (10.6).
- Fix – Fixed bug breaking WYSIWYG field after reordering a child block via the block’s toolbar up/down buttons.
- Fix – Added missing “readonly” and “disabled” attributes to DateTime and Time picker fields.
- Fix – Fixed bug incorrectly validating Email field values containing special characters.
- Fix – Fixed missing “dashicons” asset dependency from front-end forms.
- Fix – Fixed bug causing Review JSON diff modal to appear with narrow column since WP 5.7.
- Dev – Added label elements to Repeater, Flexible Content and Clone field’s table header titles.
- Dev – Added new
ACF_EXPERIMENTAL_ESC_HTML
constant. Read more
5.9.5
Release Date – 11 February 2021
- Fix – Fixed regression preventing blocks from loading correctly within the editor in WordPress 5.5.
- Fix – Fixed bug causing incorrect post_status properties when restoring a Field Group from trash in WordPress 5.6.
- Fix – Fixed edge case bug where a taxonomy named “options” could interfere with saving and loading option values.
- Fix – Fixed additional PHP 8.0 warnings.
- i18n – Updated Finnish translation thanks to Mikko Kekki
5.9.4
Release Date – 14 January 2021
- Enhancement – Added PHP validation for the Email field (previously relied solely on browser validation).
- Fix – Added support for PHP 8.0 (fixed logged warnings).
- Fix – Added support for jQuery 3.5 (fixed logged warnings).
- Fix – Fixed bug causing WYSIWYG field to appear unresponsive within the Gutenberg editor.
- Fix – Fixed regression preventing “blog_%d” and “site_%d” as valid
$post_id
values for custom Taxonomy terms. - Fix – Fixed bug causing Radio field label to select first choice.
- Fix – Fixed bug preventing preloading blocks that contain multiple parent DOM elements.
- i18n – Updated Japanese translation thanks to Ryo Takahashi.
- i18n – Updated Portuguese translation thanks to Pedro Mendonça.
5.9.3
Release Date – 3 November 2020
- Fix – Fixed bug causing Revision meta to incorrectly update the parent Post meta.
- Fix – Fixed bug breaking “Filter by Post Type” and “Filter by Taxonomy” Field settings.
5.9.2
Release Date – 29 October 2020
- Enhancement – Added experiment for preloading block HTML and reducing AJAX requests on page load.
- Fix – Added boolean attribute value detection to JSX parser (fixes issue with templateLock=”false”).
- Fix – Added “dateTime” attribute to JSX parser ruleset.
- Fix – Fixed unresponsive Select2 instances after duplicating a row or layout.
- Fix – Added missing Color Picker script translations for previous WordPress versions.
- Fix – Fixed bug in Clone Field causing potential PHP error if cloning a Field Group that no longer exists.
- Fix – Fixed PHP warning logged when comparing a revision that contains values for a Field that no longer exist.
- Dev – Added
$wp_block
parameter to block render_callback and render_template (unavailable during AJAX preview requests). - Dev – Deprecated
acf_get_term_post_id()
function.
5.9.1
Release Date – 8 September 2020
- Fix – Fixed guten-bug causing “Preview Post” button to publish changes.
- Fix – Fixed guten-bug causing JS errors when editing with Elementor or Beaver Builder.
- Fix – Fixed bug in Color Picker field causing JS error on front-end forms.
- Fix – Fixed bug in Post Taxonomy location rule causing incomplete list of rule choices.
- Fix – Reverted Local JSON “save to source path” enhancement due to DX feedback.
- i18n – Updated Indonesian translations thanks to Rio Bahtiar.
- i18n – Updated Turkish translation thanks to Emre Erkan.
5.9.0
Release Date – 17 August 2020
- Enhancement – New Field Groups admin.
- Added toolbar across all ACF admin pages.
- Added new table columns: Description, Key, Location, Local JSON.
- Added popup modal to review Local JSON changes before sync.
- Added visual representation of where Field Groups will appear.
- Added new help tab.
- Simplified layout.
- Enhancement – New ACF Blocks features.
- Added support for Inner Blocks.
- Added new “jsx” setting.
- Added new “align_text” settings.
- Added new “align_content” settings.
- Enhancement – Added duplicate functionality for Repeater and Flexible Content fields.
- Enhancement – Added PHP validation support for Gutenberg.
- Enhancement – Added ability to bypass confirmation tooltips (just hold shift).
- Enhancement – Local JSON files now save back to their loaded source path (not “save_json” setting).
- Tweak – Replaced all custom icons with dashicons.
- Tweak – Changed custom post status label from “Inactive” to “Disabled”.
- Tweak – Improved styling of metaboxes positioned in the block editor sidebar.
- Fix – Improved AJAX request efficiency when editing block className or anchor attributes.
- Fix – Fixed bug causing unresponsive WYSIWYG fields after moving a block via the up/down arrows.
- Fix – Fixed bug causing HTML to jump between multiple instances of the same Reusable Block.
- Fix – Fixed bug sometimes displaying validation errors when saving a draft.
- Fix – Fixed bug breaking Image field UI when displaying a scaled portrait attachment.
- Fix – Fixed bug in Link field incorrectly treating the “Cancel” button as “Submit”.
- Fix – Fixed bug where a sub field within a collapsed Repeater row did not grow to the full available width.
- Fix – Ensured all archive URLs shown in the Page Link field dropdown are unique.
- Fix – Fixed bug causing incorrect conditional logic settings on nested fields when duplicating a Field Group.
- Fix – Fixed bug causing license activation issues with some password management browser extensions.
- Dev – Major improvements to
ACF_Location
class. - Dev – Refactored all location classes to optimize performance.
- Dev – Extracted core JavaScript from “acf-input.js” into a separate “acf.js” file.
- Dev – Field Group export now shows “active” attribute as bool instead of int.
- Dev – Added filter “acf/get_object_type” to customize WP object information such as “label” and “icon”.
- Dev – Added action “acf/admin_print_uploader_scripts” fired when printing uploader (WP media) scripts in the footer.
- Dev – Added filters “acf/pre_load_attachment” and “acf/load_attachment” to customize attachment details.
- Dev – Added filter “acf/admin/toolbar” to customize the admin toolbar items.
- Dev – Added new JS actions “duplicate_fields” and “duplicate_field” fired when duplicating a row.
- i18n – Changed Croatian locale code from “hr_HR to “hr”.
- i18n – Updated Portuguese translation thanks to Pedro Mendonça.
- i18n – Updated French Canadian translation thanks to Bérenger Zyla.
- i18n – Updated French translation thanks to Maxime Bernard-Jacquet.
- i18n – Updated German translations thanks to Ralf Koller.
5.8.14
Release Date – 13 August 2020
- Fix – Fixed bug breaking ACF Block
$is_preview
parameter in WordPress 5.5. - Fix – Fixed bug breaking seamless postbox style in WordPress 5.5.
5.8.13
Release Date – 10 August 2020
- Tweak – Added styling compatibility for WordPress 5.5.
- Fix – Implemented new
wp_filter_content_tags()
function in “acf_the_content” filter. - i18n – Updated Arabic translation thanks to Karim Ramadan.
5.8.12
Release Date – 10 June 2020
- Fix – Improved string escaping in Select2 drop-downs to address XSS concerns.
- Fix – Fixed bug causing PHP error when updating the settings of a Checkbox field.
- Fix – Fixed bug causing WYSIWYG field to hide when toggling between Document and Block tabs within the Block editor.
- Fix – Fixed bug incorrectly validating the length of Text and Textarea field values that contained HTML entities.
5.8.11
Release Date – 12 May 2020
- Fix – Fixed bug in ACF Blocks where “inserter examples” and “block templates” did not load the defined “data”.
- Fix – Reverted “fix” in 5.8.9 regarding Taxonomy fields saving terms to non “post” objects.
- Fix – Fixed bug allowing the Image field to save the value of a deleted attachment.
- Fix – Improved Select field
format_value()
behaviour to correctly cast value types depending on the “multiple” setting. - Tweak – Changed language fallback for “zh_HK” to “zh_TW”.
- Tweak – Changed Time Picker field settings to display in a localized format via
date_i18n()
. - Tweak – Improved CSS styling of menu item fields.
- i18n – Updated Finnish translation thanks to Mikko Kekki
- i18n – Updated French translation thanks to Maxime Bernard-Jacquet.
- i18n – Updated Turkish translation thanks to Emre Erkan.
5.8.10
Release Date – 12 May 2020
- See hotfix version 5.8.11 for release notes.
5.8.9
Release Date – 26 March 2020
- Fix – Fixed bug in ACF Blocks causing default “align” property to be ignored.
- Fix – Fixed bug allowing Taxonomy field to save terms to a non “post” object.
- Tweak – Improved User field AJAX query performance.
- Tweak – Improved logic that determines width of Range field input.
- Tweak – Improved styling of ACF Blocks components.
- Dev – Added new “acf/register_block_type_args” filter.
- Dev – Added new generic ACF_Ajax_Query and ACF_Ajax_Query_Users classes.
- i18n – Updated French Canadian translation thanks to Bérenger Zyla.
- i18n – Updated Traditional Chinese translation thanks to Audi Lu.
- i18n – Updated German translation thanks to Ralf Koller.
- i18n – Updated Portuguese translation thanks to Pedro Mendonça.
5.8.8
Release Date – 4 March 2020
- Fix – Fixed bug in
have_rows()
function causing a PHP warning when no value is found. - Fix – Fixed bug in Google Maps field causing marker to snap to nearest address.
- Fix – Avoid Nav Menu items displaying twice in WordPress 5.4.
- Tweak – Added place name data to Google Maps field value.
- Tweak – Improved performance of PHP registered fields.
- Dev – Added new “acf/prepare_field_group_for_import” filter.
- i18n – Added Traditional Chinese translation thanks to Audi Lu.
- i18n – Added Catalan translation thanks to Jordi Tarrida.
- i18n – Updated French translation thanks to Maxime Bernard-Jacquet & Bérenger Zyla.
5.8.7
Release Date – 12 November 2019
- New – Updated admin CSS for new WordPress 5.3 styling.
- Fix – Fixed various issues affecting dynamic metaboxes in the block editor (requires WordPress 5.3)
- Fix – Fixed performance issue when checking network sites for upgrades.
- Fix – Fixed Select2 clones appearing after duplicating a Relationship field.
- Tweak – Repeater field “Add row” icons will now hide when maximum rows are reached.
- Tweak – Removed ACF Blocks keyword limit for later versions of Gutenberg.
5.8.6
Release Date – 24 October 2019
- New – Added more data to Google Maps field value including place_id, street_name, country and more.
- Fix – Fixed bug in Gallery field incorrectly displaying .pdf attachments as icons.
- Fix – Fixed bug in Checkbox field missing “selected” class after “Toggle All”.
- Dev – Added compatibility for Attachments in the Post Taxonomy location rule.
- Dev – Added missing return statement from
acf_get_form()
function. - Dev – Added “google_map_result” JS filter.
5.8.5
Release Date – 8 October 2019
- New – Added new choice “Add” to the User Form location rule.
- New – Optimized
acf_form()
logic when used in combination withacf_register_form()
. - Fix – Fixed bug causing incorrect field order after sync.
- Fix – Fixed bug reverting the first field type to Text in Firefox version 69.0.1.
- Fix – Fixed bug causing tinymce issues when changing between block modes.
- Fix – Fixed bug preventing block registration when category does not exist.
- Fix – Fixed bug preventing block registration when no icon is declared.
- Dev – Added RegExp compatibility for innerBlocks.
5.8.4
Release Date – 3 September 2019
- New – Optimized Relationship field by delaying AJAX call until UI is visible.
- Fix – Fixed bug incorrectly escaping HTML in the Link field title.
- Fix – Fixed bug showing Discussion and Comment metaboxes for newly imported field groups.
- Fix – Fixed PHP warning when loading meta from Post 0.
- Dev – Ensure Checkbox field value is an array even when empty.
- Dev – Added new
ACF_MAJOR_VERSION
constant.
5.8.3
Release Date – 7 August 2019
- Tweak – Changed Options Page location rules to show “page_title” instead of “menu_title”.
- Fix – Fixed bug causing Textarea field to incorrectly validate maxlength.
- Fix – Fixed bug allowing Range field values outside of the min and max settings.
- Fix – Fixed bug in block RegExp causing some blocks to miss the “acf/pre_save_block” filter.
- Dev – Added
$block_type
parameter to block settings “enqueue_assets” callback. - i18n – Added French Canadian language thanks to Bérenger Zyla.
- i18n – Updated French language thanks to Bérenger Zyla.
5.8.2
Release Date – 15 July 2019
- Fix – Fixed bug where validation did not prevent new user registration.
- Fix – Fixed bug causing some “reordered” metaboxes to not appear in the Gutenberg editor.
- Fix – Fixed bug causing WYSIWYG field with delayed initialization to appear blank.
- Fix – Fixed bug when editing a post and adding a new tag did not refresh metaboxes.
- Dev – Added missing
$value
parameter in “acf/pre_format_value” filter.
5.8.1
Release Date – 3 June 2019
- New – Added “Preview Size” and “Return Format” settings to the Gallery field.
- Tweak – Improved metabox styling for Gutenberg.
- Tweak – Changed default “Preview Size” to medium for the Image field.
- Fix – Fixed bug in media modal causing the primary button text to disappear after editing an image.
- Fix – Fixed bug preventing the TinyMCE Advanced plugin from adding
< p >
tags. - Fix – Fixed bug where HTML choices were not visible in conditional logic dropdown.
- Fix – Fixed bug causing incorrect order of imported/synced flexible content sub fields.
- i18n – Updated German translation thanks to Ralf Koller.
- i18n – Updated Persian translation thanks to Majix.
5.8.0
Release Date – 8 May 2019
- New – Added ACF Blocks feature for ACF PRO.
- Fix – Fixed bug causing duplicate “save metabox” AJAX requests in the Gutenberg editor.
- Fix – Fixed bug causing incorrect Repeater field value order in AJAX requests.
- Dev – Added JS filter
'relationship_ajax_data'
to customize Relationship field AJAX data. - Dev – Added
$field_group
parameter to'acf/location/match_rule'
filter. - Dev – Bumped minimum supported PHP version to 5.4.0.
- Dev – Bumped minimum supported WP version to 4.7.0.
- i18n – Updated German translation thanks to Ralf Koller.
- i18n – Updated Portuguese language thanks to Pedro Mendonça.
5.7.13
Release Date – 6 March 2019
- Fix – Fixed bug causing issues with registered fields during
switch_to_blog()
. - Fix – Fixed bug preventing sub fields from being reused across multiple parents.
- Fix – Fixed bug causing the
get_sub_field()
function to fail if a tab field exists with the same name as the selected field. - Fix – Fixed bug corrupting field settings since WP 5.1 when instructions contain
< a target="" >
. - Fix – Fixed bug in Gutenberg where custom metabox location (acf_after_title) did not show on initial page load.
- Fix – Fixed bug causing issues when importing/syncing multiple field groups which contain a clone field.
- Fix – Fixed bug preventing the AMP plugin preview from working.
- Dev – Added new ‘pre’ filters to get, update and delete meta functions.
- i18n – Update Turkish translation thanks to Emre Erkan.
5.7.12
Release Date – 15 February 2019
- Fix – Added missing function
register_field_group()
. - Fix – Fixed PHP 5.4 error “Can’t use function return value in write context”.
- Fix – Fixed bug causing wp_options values to be slashed incorrectly.
- Fix – Fixed bug where “sync” feature imported field groups without fields.
- Fix – Fixed bug preventing
get_field_object()
working with a field key. - Fix – Fixed bug causing incorrect results in
get_sub_field()
. - Fix – Fixed bug causing draft and preview issues with serialized values.
- Fix – Fixed bug causing reversed field group metabox order.
- Fix – Fixed bug causing incorrect character count when validating values.
- Fix – Fixed bug showing incorrect choices for post_template location rule.
- Fix – Fixed bug causing incorrect value retrieval after
switch_to_blog()
. - i18n – Updated Persian translation thanks to Majix.
5.7.11
Release Date – 11 February 2019
- New – Added support for persistent object caching.
- Fix – Fixed PHP error in
determine_locale()
affecting AJAX requests. - Fix – Fixed bug affecting dynamic metabox check when selecting “default” page template.
- Fix – Fixed bug where tab fields did not render correctly within a dynamic metabox.
- Tweak – Removed language fallback from “zh_TW” to “zh_CN”.
- Dev – Refactored various core functions.
- Dev – Added new hook variation functions
acf_add_filter_variations()
andacf_add_action_variations()
. - i18n – Updated Portuguese language thanks to Pedro Mendonça.
- i18n – Updated German translation thanks to Ralf Koller.
- i18n – Updated Swiss German translation thanks to Raphael Hüni.
5.7.10
Release Date – 16 January 2019
- Fix – Fixed bug preventing metaboxes from saving if validation fails within Gutenberg.
- Fix – Fixed bug causing unload prompt to show incorrectly within Gutenberg.
- Fix – Fixed JS error when selecting taxonomy terms within Gutenberg.
- Fix – Fixed bug causing jQuery sortable issues within other plugins.
- Tweak – Improved loading translations by adding fallback from region to country when .mo file does not exit.
- Tweak – Improved punctuation throughout admin notices.
- Tweak – Improved performance and accuracy when loading a user field value.
- Dev – Added filter ‘acf/get_locale’ to customize the locale used to load translations.
- Dev – Added filter ‘acf/allow_unfiltered_html’ to customize if current user can save unfiltered HTML.
- Dev – Added new data storage functions
acf_register_store()
andacf_get_store()
. - Dev – Moved from .less to .scss and minified all css.
- i18n – Updated French translation thanks to Maxime Bernard-Jacquet.
- i18n – Updated Czech translation thanks to David Rychly.
5.7.9
Release Date – 17 December 2018
- Fix – Added custom metabox location (acf_after_title) compatibility with Gutenberg.
- Fix – Added dynamic metabox check compatibility with Gutenberg.
- Fix – Fixed bug causing required date picker fields to prevent form submit.
- Fix – Fixed bug preventing multi-input values from saving correctly within media modals.
- Fix – Fixed bug where
acf_form()
redirects to an incorrect URL for sub-sites. - Fix – Fixed bug where breaking out of a sub
have_rows()
loop could produce undesired results. - Dev – Added filter ‘acf/connect_attachment_to_post’ to prevent connecting attachments to posts.
- Dev – Added JS filter ‘google_map_autocomplete_args’ to customize Google Maps autocomplete settings.
5.7.8
Release Date – 7 December 2018
- Fix – Fixed vulnerability allowing author role to save unfiltered HTML values.
- Fix – Fixed all metaboxes appearing when editing a post in WP 5.0.
- i18n – Updated Polish translation thanks to Dariusz Zielonka.
- i18n – Updated Czech translation thanks to Veronika Hanzlíková.
- i18n – Update Turkish translation thanks to Emre Erkan.
- i18n – Updated Portuguese language thanks to Pedro Mendonça.
5.7.7
Release Date – 1 October 2018
- Fix – Fixed various plugin update issues.
- Tweak – Added ‘language’ to Google Maps API url.
- Dev – Major improvements to the
acf.models.Postbox
model. - Dev – Added JS filter ‘check_screen_args’.
- Dev – Added JS action ‘check_screen_complete’.
- Dev – Added action ‘acf/options_page/submitbox_before_major_actions’.
- Dev – Added action ‘acf/options_page/submitbox_major_actions’.
- i18n – Updated Portuguese language thanks to Pedro Mendonça
5.7.6
Release Date – 12 September 2018
- Fix – Fixed unload prompt not working.
- Dev – Reduced number of queries needed to populate the relationship field taxonomy filter.
- Dev – Added ‘nav_menu_item_id’ and ‘nav_menu_item_depth’ to get_field_groups() query.
- Dev – Reordered various actions and filters for more usefulness.
- i18n – Updated Polish language thanks to Dariusz Zielonka