还没有用过 Advanced Custom Fields 高级自定义字段 ?目前最新版为 v5.12.3 ,已通过 WordPress 6.0.1 兼容测试。

Advanced Custom Fields
开发商:Delicious Brains
当前版本:5.12.3
最后更新:2022年7月27日
用户评级:
下载次数:29,503,285
WordPress 版本:4.7 或更高版本
已经测试:6.0.1
标签:acf, custom fields, fields, meta, repeater,高级自定义字段
翻译进度
Advanced Custom Fields | 等待 | 100 % | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 | — | 0 |
---|
获取帮助
赞助捐赠


Advanced Custom Fields
插件简介
插件安装
您可以通过以下几种方式安装此插件:
1、方式一:进入网站后台(/wp-admin/),转到【插件】 =>【安装插件】并搜索 “Advanced Custom Fields”。找到之后,单击 “安装” 即可。
2、方式二:从 WordPress.org 下载到 advanced-custom-fields.zip 压缩文件包。然后转到【插件】 =>【安装插件】 =>上传压缩包进行安装。
3、安装完毕后,可通过 WordPress 网站后台的左侧【插件】菜单选择启用。
4、如果您有任何 Advanced Custom Fields 问题,请到 Advanced Custom Fields 支持论坛中发帖,获取帮助。
语言包安装
如果您是从网站后台全新安装的 Advanced Custom Fields 且左侧翻译进度已是 100% ,那么可能目前已经有提供此插件的中文语言包,如果没有可通过手动安装的方式来更新翻译。
1、【推荐】通过文派翻译导入器安装;
目前插件已上传至 WordPress.org 插件目录,您可以通过网站后台【插件】=【安装插件】=搜索【wpfanyi】找到,然后安装即可。
多站点用户请【网络启用】后,找到菜单【仪表盘】=【导入翻译】
单站点用户请【启用插件】后,找到菜单【工具】=【导入翻译】即可。
2、通过 WP 后台自动更新;
已翻译和校对过的 Advanced Custom Fields 中文语言包我们会定期提交至 WordPress Translate ,您将可以在网站后台收到翻译更新提示,前提是已安装了 Advanced Custom Fields 。
如果没有收到更新提示,也可选择手动安装。
3、通过 FTP 手动上传;
在本站下载到 advanced-custom-fields-zh_CN.zip 即最新版的 Advanced Custom Fields 中文语言包,解压后可得到两个文件,
advanced-custom-fields-zh_CN.po
advanced-custom-fields-zh_CN.mo
请上传到您网站的安装目录,路径为
/wp-content/languages/plugins
这是基于 WordPress 的系统语言路径,注意,要能正常使用,需要看下语言文件是否正确,文件名必须是 advanced-custom-fields-zh_CN.mo 才行。
如下,上传后的完整路径。
/wp-content/languages/plugins/advanced-custom-fields-zh_CN.mo
操作完毕后,到网站后台的 Advanced Custom Fields 设置页面刷新即可看见变化。
常见问题
1、下载的 .zip 语言文件无效?
情况有两种:
① 从本页面下载的 advanced-custom-fields-zh_CN.zip 内【文件没有前缀】的则为无效文件或尚未添加到翻译系统中;
② 上传后未生效或依旧为英语,若翻译完成度为【 30% 以下】则尚处于翻译准备阶段,仍需等待,其他问题请通过薇晓朵 Advanced Custom Fields 论坛发帖联系处理。
2、.po 和 .mo 有什么区别?
- advanced-custom-fields-zh_CN.po 是可编辑文件,如需查看可将文件拖放至浏览器中看到源代码。
- advanced-custom-fields-zh_CN.mo 是已编译的 Advanced Custom Fields 程序语言文件,可以被 WordPress 系统识别,也就是您网站语言显示所用的文件。
3、.po 和 .mo 都需要上传吗?
在 Advanced Custom Fields 中真正生效的语言文件是 advanced-custom-fields-zh_CN.mo,而 .po 为可编辑文件是否上传由您自行决定, WPfanyi.com 均有提供。
4、我可以用中英文双语吗?
当然可以,要切换语言,只需要在 WordPress 后台 => 设置 => 常规 =>站点语言,进行选择即可。已上传的语言包不会影响所有系统语言,仅在您当前网站设置为【简体中文】时生效。
5、Advanced Custom Fields 语言包会过时吗?
肯定会过时,每当 Advanced Custom Fields 有版本更新都会需要进行新的翻译工作,所以请了解这是需要长期维护和进行的工作,如果 wpfanyi.com 对您有用,请协助推广我们!
项目说明
由于近年来 WordPress 中文语系的翻译进程缓慢,同时包括 Advanced Custom Fields 在内的一大批优秀的主题、插件都没有提供中文版本,这对中国区用户造成了很多不便。
WordPress 翻译(WPfanyi.com)就是为了解决这一基本需求而存在。我们的目的是以中国人最熟悉的方式组建一个 WordPress 本地化翻译团队。
加入我们
WP翻译团队加入仅凭个人兴趣爱好,没有任何金钱实质回报。但我们会不定期为成员分发一些由薇晓朵及赞助商提供的如教育资料、产品优惠券等资源。您可以通过以下方式加入:
本站的账号体系与 Weixiaoduo.com 互通,若已有账号请直接【登录】或【免费注册】。
1、【加入团队】若您有一定的英语基础,和充足的空闲时间,请发送邮件到 wpfanyi#feibisi.com (将#替换为@) 告知想要加入 Advanced Custom Fields 中文翻译项目;
2、【分享翻译】若您已经对最新版的 Advanced Custom Fields 做了翻译及校对,请通过 Advanced Custom Fields 翻译系统导入语言包,以便志愿者和编辑进行审阅校正。
3、【成为管理】通过【加入我们】表单提交申请可成为 Advanced Custom Fields 翻译系统的翻译编辑;
数据同步
除了 WPfanyi.com 你还可以通过 WP.org 翻译系统(英文,国内访问较慢)对 —— Advanced Custom Fields 进行 zh_CN 中文翻译;
工作流程:
1、先在 wpfanyi.com 上完成翻译和校对工作,然后导出语言包;
2、导入至 translate.wordpress.org 系统做审批;
3、审批通过自动释放语言包,对所有 Advanced Custom Fields 中文用户分发;
4、您在网站后台接收到翻译更新。
翻译质量
注意:对于仅为机器翻译没有做过任何校对和错误纠正的语言包请不要导入到翻译系统中,WordPress 中文翻译的原则是求精不求多。
我们希望可以通过这几年的努力,让 WordPress 中文生态可以变得更加繁荣。
中文支持
在使用 Advanced Custom Fields 的过程中如果遇到问题需要帮助,请到薇晓朵 Advanced Custom Fields 中文支持论坛发帖获取帮助,会有专业技术人员回复。
做为国内领先的 WordPress 综合服务平台,薇晓朵构建了一系列的基础设施以便为中国的 Advanced Custom Fields 用户提供服务,在提供免费支持的同时也有更多商业服务可选。
官方支持
薇晓朵官方提供了一个全局搜索功能,涵盖了超过 100 多个 WordPress 中文资源及教学站点,您可以执行 Advanced Custom Fields 全局搜索获得更多信息;
因为大部分的 WordPress 产品均为国外作者创建,所以您也可通过 Advanced Custom Fields 官方支持论坛(英语)获取帮助或者访问 Delicious Brains 开发商了解更多信息。
网站维护
本站由薇晓朵云平台接入维护,提供长期稳定的 WordPress 技术支持。
赞助广告
如果您想要将自己公司信息或者商业广告显示在此页,请考虑捐赠和赞助 WPfanyi.com ,以便让我们可以有更充足的资源和资金来做这些免费但有意义的事情。
最新赞助商
以下为 2019 年度赞助商,欢迎访问相关站点获取更多信息。
往期赞助商
暂无
常见问题
1、Advanced Custom Fields 中文翻译是免费的吗?
完全免费,从现在到以后都是,只要这款源程序存在于 WordPress.org 上,那么 WPfanyi.com 提供的 Advanced Custom Fields 中文语言包都是免费的。
2、为什么要赞助 WordPress 中文翻译?
Advanced Custom Fields 是开源软件,您的公司、团队可以无限制的应用在商业项目上,既可以帮您盈利现在还能有更好的中文体验,这是互利共生的良性关系。
3、我可以投放广告吗?
为了让 WPfanyi.com 能够长期健康的发展,我们接受商业赞助和关联性广告投放,广告内容应与 WordPress 或网站、互联网相关,积极健康符合《中华人民共和国广告法》相关标准。
接受商业赞助是为了更好的为所有中文用户服务,但宁缺毋滥欢迎优质广告商联系。
日志说明
产品更新日志一般会包括 Advanced Custom Fields 安全更新和问题修复,如果不清楚您目前所用的版本包含哪些新功能和 bug 修复,可在此处查询。
5.12.3
Release Date 14th July 2022
- Security Fix – Inputs for basic file uploads are now nonced to prevent an issue which could allow arbitrary file uploads to forms with ACF fields (Thanks to James Golovich from Pritect, Inc.)
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
Release Date – 08 July 2021
- Fix – Fixed bug causing multiple image fields to not validate files properly
- Fix – Fixed bug preventing case-sensitive HTML tags from working in blocks
- Fix – Fixed bug causing JSX-enabled blocks to improperly remove whitespace in preview
- Fix – Fixed bug causing text fields to remove HTML entities when editing saved fields
- Fix – Fixed deprecated jQuery notices on “Add Field Group” page
5.9.7
Release Date – 22 June 2021
- Fix – Fixed PHP warnings logged due to incorrect parameter type for
add_menu_page()
/add_submenu_page()
- Fix – Fixed bug causing WYSIWYG field to not keep line breaks
- Fix – Fixed bug causing Email field to incorrectly invalidate emails with unicode characters
- Fix – Fixed bug causing file type validation to fail in some cases
- Fix – Fixed bug where newly uploaded or selected images do not contain custom preview size data
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