高级自定义字段（ACF）

更新日志

6.4.2

Release Date 20th May 2025

• New – In ACF PRO, fields can now be added to WooCommerce Subscriptions when using HPOS
• Security – Changing a field type no longer enables the “Allow Access to Value in Editor UI” setting
• Fix – Paginated Repeater fields no longer save duplicate values when saving to a WooCommerce Order with HPOS disabled
• Fix – Blocks registered via acf_register_block_type() with a parent value of null no longer fail to register

6.4.1

Release Date 8th May 2025

• New – Select fields can now be configured to allow creating new options when editing the field’s value (requires the “Stylized UI” and “Multiple” field settings to be enabled)
• Enhancement – The “Escaped HTML” warning notice introduced in ACF 6.2.5 is now disabled by default
• Enhancement – The Icon Picker field now supports supplying an array of icons to a custom tab via a new acf/fields/icon_picker/{tab_name}/icons filter
• Fix – ACF Blocks are now forced into preview mode when editing a synced pattern
• Fix – The free ACF plugin once again works with the Classic Widgets plugin and the legacy ACF Options Page addon
• Fix – ACF no longer causes an infinite loop in bbPress when editing replies

6.4.0.1

Release Date 8th April 2025

• Fix – Calling acf_get_reference() with an invalid field name no longer causes a fatal error

6.4.0

Release Date 7th April 2025

• New – In ACF PRO, fields can now be added to WooCommerce orders when using HPOS
• Enhancement – ACF now uses Composer to autoload some classes
• Fix – Repeater pagination now works when the Repeater is inside a Group field
• Fix – Various translations are no longer called before the WordPress init action hook
• Security – Link field no longer has a minor local XSS vulnerability
• i18n – Various British English translation strings no longer have a quoting issue breaking links
• i18n – Added Dutch (formal) translations (props @toineenzo)

6.3.12

发布日期 2025年1月21日

• 增强 – 当现场验证失败时发生的错误消息现在不足的安全性nonce现在有其他上下文
• 修复 – 重复的ACF块在启用块预加载后初始保存后不再丢失其现场值
• 修复 – 启用React Strictmode时，包含复杂字段类型的ACF块现在正确行为

6.3.11

发布日期 2024 年 11 月 12 日

• 增强功能 – 点击后可复制字段组键值
• 修复 – 通过条件逻辑隐藏字段的中继表现在可正确呈现
• 修复 – ACF 块现在可在 React StrictMode 中正确运行
• 修复：WordPress 块应用程序接口版本为 3 的 ACF 块不再提供编辑模式，因为 iframe 中不支持字段编辑。

6.3.10.2

发布日期 2024 年 10 月 29 日
仅免费发布

• 修复 – 当任何不支持的传统 ACF 附加组件处于活动状态时，ACF Free 不再导致致命错误

6.3.10.1

发布日期 2024 年 10 月 29 日
仅免费发布

• 修复 – 当 WPML 处于活动状态时，ACF Free 不再导致致命错误

6.3.10

发布日期 2024 年 10 月 29 日

• 安全性 – 现在，为自定义文章类型和分类法设置元宝回调需要管理员身份，多站点安装则需要超级管理员身份
• 安全性 – 字段特定的 ACF nonces 现在有了前缀，解决了第三方 nonces 在 AJAX 调用中可能被视为有效的问题
• 增强功能 – 在编辑字段组时，新增了「关闭并添加字段」选项，可在编辑字段后插入一个新字段
• 增强功能 – ACF 和 ACF PRO 现在共享相同的插件更新程序，以提高可靠性和性能
• 修复 – 导出包含元框回调的文章类型和分类法现在可正确导出用户定义的回调

6.3.9

发布日期 2024年10月15日

• 安全性 – 在字段组编辑器中编辑 ACF 字段不再执行存储的 XSS 漏洞。感谢来自 Viettel Cyber Security 的 Duc Luong Tran (janlele91) 负责披露
• 安全性–文章类型和分类元方框回调不再能够访问任何超全局值，从而进一步加强了 6.3.8 中的原始修复。
• 修复–在块编辑器中使用并附加到侧边栏的 ACF 字段现在可正确验证。

6.3.8

发布日期 2024 年 10 月 7 日

• 安全性 – ACF 定义的「文章类型」和「分类法元框」回调不再能够访问 $_POST 数据。(感谢 Automattic 安全团队的披露）

6.3.7

发布日期 2024 年 10 月 2 日

• 安全性 – ACF现在使用WP发动机服务器中自己的更新机制

6.3.6

发布日期 2024 年 8 月 28 日

• 安全性 – 新添加的字段现在必须明确设置为允许在内容编辑器中访问（使用 ACF 短代码或块绑定时），以提高字段权限的安全性。更多详情请参见发布说明。
• 安全修复 – 在字段组编辑器中呈现字段标签时，现在会正确转义，以防止潜在的 XSS 问题。感谢 Mitsui Bussan Secure Directions, Inc.
• 修复 – 验证和阻止 AJAX 请求的非ces 不再被第三方插件覆盖
• 修复 – 检测第三方 select2 库时现在默认使用 v4 而不是 v3
• 修复 – 如果未找到渲染模板 PHP 文件，区块预览现在会显示错误

6.3.5

发布日期 2024 年 8 月 1 日

• 修复 – ACF 快捷代码现在可正确输出以逗号分隔的数组值列表
• 修复 – 在自动模式下渲染的 ACF 块现在可在编辑字段后正确重新渲染其预览效果
• 修复 – 如果 HTML 在呈现时会自动选择第一个值，ACF 块验证将不再引发必填验证信息
• 修复 – 如果默认值将呈现为字段值，ACF 块验证不再引发必填验证信息
• 修复 – 添加新块时，ACF 块验证不再为条件逻辑隐藏的字段引发必填验证信息

6.3.4

发布日期 2024 年 7 月 18 日

• 安全修复 – ACF 简码现在默认防止访问来自不同私人文章的字段。查看 发布说明 了解更多信息
• 修复 – 没有 edit_posts 功能但具有编辑自定义文章类型自定义功能的用户，现在可以正确加载通过条件位置规则加载的字段组
• 修复 – 块验证不再在页面加载时验证字段的子字段，仅在编辑时验证。这解决了页面加载时或首次添加块时不一致的验证错误问题。
• 修复 – 即使服务器调用失败，停用 ACF PRO 许可证现在也会删除许可证密钥
• 修复：通过the_field、the_sub_field或 ACF 短代码输出时，或通过设置了 escape html 参数的 get_ 函数检索时，返回对象的字段类型不再导致 PHP 警告和错误。
• 修复：块渲染过程中出现服务器端错误时，编辑器会优雅地显示错误信息

6.3.3

发布日期 2024 年 6 月 27 日

• 增强功能 – 所有破折号现在都可用于图标选择器字段类型
• 修复 – 在使用风格化用户界面设置时，”真/假 “字段现在能正确显示开关旁的说明信息
• 修复 – 通过 AJAX 加载时，条件逻辑值现在可正确加载选项
• 修复 – ACF PRO 在加载前端页面时不再触发许可证验证调用
• i18n – 修复了选项页面预览中的一个不可翻译字符串

6.3.2.1

发布日期2024年6月24日↵
Pro仅发行

• 修复 – 通过 AJAX 获取 ACF 块时不再触发 JavaScript 错误

6.3.2

发布日期 2024 年 6 月 24 日

• 安全修复 – ACF 现在可为每个启用 AJAX 的字段生成不同的非ces，从而防止订阅者或前端表单用户查询其他字段的结果
• 安全修复 – ACF 现在可正确验证某些仅限编辑器操作的权限，防止订阅者执行这些操作
• 安全修复 – 废弃了传统的私有内部字段类型（输出），以防止其输出不安全的 HTML
• 安全修复 – 改进了对某些 SQL 过滤器和其他内部函数的处理，以确保输出始终正确转义
• 安全修复 – ACF 现在在所有文件夹中包含空白的 index.php 文件，以防止在配置不正确的网络服务器上列出 ACF 插件文件夹的目录。

6.3.1.2

发布日期 2024 年 6 月 6 日
仅限专业版

• 修复 – 部件区域中的 ACF 块在无上下文可用时不再导致致命错误
• 修复 – 未指定字段的 ACF 块不再在侧边栏显示表单的位置出现空隙

6.3.1.1

发布日期 2024 年 6 月 6 日
仅限专业版

• 修复 – 复制或删除包含图标选取器子字段的行时，中继器和灵活内容字段不再出错
• 修复 – 包含灵活内容字段的 ACF 块现在可正确加载其编辑表单
• 修复 – ACF 块不再存在读取数据存储时未初始化的竞赛条件
• 修复 – ACF 块在没有字段和空无字段信息的情况下不再触发 JS 错误
• 修复 – ACF 块预加载现在可正确用于使用自定义块上下文的字段
• 修复 – ACF 块 JavaScript 调试信息现在可在 SCRIPT_DEBUG 为 true 时正确显示

6.3.1

发布日期 2024 年 6 月 4 日

• 增强功能 – 在用户界面中注册的选项页现在可以复制了
• 修复 – ACF 块验证现在可正确验证中继器、组和灵活内容字段
• 修复 – ACF 块验证现在可在字段使用非默认返回类型时正确验证
• 修复 – 在字段组之间移动的字段现在可正确更新两个 JSON 文件
• 修复 – 使用左对齐标签时，图标选取器字段现在可正确呈现
• 修复 – 如果只选择显示一个选项卡，图标选取器字段不再显示选项卡
• 修复 – 如果没有选择显示图标选取器选项卡，图标选取器字段不再会导致文章编辑器崩溃
• 修复 – “真/假 “字段现在能更好地处理较长的 “开/关 “标签
• 修复 – 通过 AJAX 加载的多选分类字段的 Select2 结果不再对 HTML 实体进行双重编码

6.3.0.1

发布日期 2024 年 5 月 22 日

• 修复 – ACF PRO 用户在新的网站健康功能中不再出现可能的致命错误
• 修复 – ACF PRO 用户的 ACF 块中不再出现可能的未定义索引错误

6.3.0

发布日期 2024 年 5 月 22 日

• 新功能 – ACF 现在需要 WordPress 6.0 或更新版本，以及 PHP 7.4 或更新版本。
• 新功能 – ACF 块现在支持字段验证规则。查看 发布说明 了解更多信息
• 新功能 – ACF 块现在支持在 postmeta 表而非文章内容中存储字段数据
• 新功能 – 字段的条件逻辑规则现在支持为文章对象、页面链接、分类标准、关系和用户选择特定值，而无需输入 ID
• 新功能 – ACF 和 ACF PRO 的新图标选取器字段类型
• 新功能–自定义文章类型菜单图标的图标选择
• 新功能 – 为选项页面菜单图标选择图标
• 新功能 – ACF 现在可在 WordPress 网站健康区域显示调试和状态信息
• 新功能 – 逃逸的 html 通知现在可被永久驳回
• 增强功能 – 标签字段现在支持 selected 属性，可指定默认选择哪个标签，并支持类属性
• 修复：区块预载现在可在 WordPress 6.5 或更新版本中可靠运行
• 修复 – 通过 AJAX 加载的文章对象字段的 Select2 结果不再对 HTML 实体进行双重编码
• 修复 – 使用 ACF 注册的自定义文章类型现在将默认启用自定义字段支持，以更好地支持修订
• 修复 – 在经典编辑器中发布文章后的首次预览现在可正确显示 ACF 字段
• 修复 – ACF 字段和 “灵活内容 “布局现在可在拖动时正确定位
• 修复 – 在 “灵活内容 “布局内复制字段标题时，不再为复制值添加空格
• 修复 – 编辑时，”灵活内容 “布局名称不再转换为小写字母
• 修复 – 具有无默认属性的 ACF 块现在可正确注册
• 修复 – 如果生成的非密钥只包含数字，加载结果时用户字段不再触发 404
• 修复 – ACF 项目的描述字段现在仅支持数字字符
• 修复 – 在小屏幕上，字段组标题不再出现在 WordPress 管理菜单上方
• 修复：acf/json/save_file_name过滤器现在可在删除 JSON 文件时正确应用。
• i18n – ACF PRO 许可证或更新检查期间出现的所有错误现在均可翻译
• 其他 – 正如ACF 6.2.7 发布说明中所讨论的，ACF 的新安装默认禁用 ACF 短代码。

6.2.10

发布日期 2024 年 5 月 15 日

• 安全修复 – ACF 块不再允许在块的属性中重写呈现模板、呈现或资产回调。有关详细信息，请阅读发布博文。

6.2.9

发布日期 2024 年 4 月 8 日

• 增强功能 – 在初始化自定义 Select2 时，现在可以重写 Select2 的 escapeMarkup 函数。
• 修复 – 在使用有条件加载的字段组时，”在屏幕上隐藏 “设置现在会正确应用
• 修复 – 编辑名称时，字段名不再转换为小写字母
• 修复 – 字段组标题不再将 HTML 实体转换为其编码形式

6.2.8

发布日期 2024 年 4 月 2 日

• 新功能 – 通过新的 acf/field 源支持 WordPress 6.5 中的块绑定 API。有关如何使用的详细信息，请阅读发布博文。
• 新功能 – 支持在 WordPress 6.5 中提高翻译性能
• 增强功能 – 新的 JS 筛选器 select2_escape_markup 现在允许字段自定义 select2 的 HTML 转义行为
• 修复 – 选项页面无法再设置为其父级页面
• 修复 – 多网站子网站安装上的 ACF PRO 许可证激活现在将使用正确的网站 URL
• 修复 – 当更新页面不可见时，安装在多站点安装上的 ACF PRO 将不再尝试检查更新，从而导致 404 错误
• 修复 – 找不到 ACF JSON 文件夹时，ACF JSON 不再在 Windows 服务器上产生警告
• 修复 – 字段和布局名称现在可以包含有效的非 ASCII 字符
• 其他 – ACF PRO 现在需要激活有效许可证才能使用 PRO 功能。了解更多。

6.2.7

发布日期 2024 年 2 月 27 日

• 安全修复 – 自 ACF 6.2.5 起，the_field 现在可转义可能不安全的 HTML。有关详细信息，请阅读 发布博文。
• 安全修复 – 字段和布局名称现在只能使用字母数字字符，从而解决了潜在的 XSS 问题
• 安全修复 – select2 字段的默认呈现模板不再允许呈现 HTML，从而解决了潜在的 XSS 问题
• 安全性增强 – 现在可使用 acf/shortcode/prevent_access 过滤器来限制允许 ACF 短代码访问的数据。
• 安全性增强 – i18n 翻译字符串现在可在输出时转义
• 增强功能 – ACF 现在普遍使用 WordPress 文件系统函数而不是本机 PHP 函数

6.2.6.1

发布日期：2024年2月7日

• 修复：安装 Yoast 或其他加载块编辑器组件的插件后，在经典编辑器中编辑字段时不再出现致命的 JS 错误
• 修复：在数组返回字段类型的获取函数上使用 $escape_html 不再产生数组到字符串的转换错误

6.2.6

发布日期 – 2024年2月6日

• 增强功能 – get_field() 和其他 get_ 函数现在支持返回 HTML 安全字段值的 escape_html 参数。
• 增强功能 – 在返回 HTML 安全值时，URL 字段将使用 esc_url 而不是 wp_kses_post 转义。
• 修复 – ACF 字段现在可以正确保存到 WordPress 创建的修订版中，解决了 WordPress 6.4 或更新版本中草稿预览的问题。
• 修复 – 在 ACF PRO 许可证允许的情况下，多站点子站点现在将由主站点正确激活，从而隐藏这些子站点上的更新页面
• 修复 – required 属性不起作用的字段类型（如选项卡或手风琴）将不再显示该选项
• 修复 – 复制字段组现在可保持当前显示的字段组页面
• 修复 – 混合主题中处于编辑模式的 ACF 块中的字段现在将使用 ACF 的样式，而不是由主题覆盖某些属性
• 修复 – 某些管理通知中的文字不再与解散按钮重叠
• 修复：现在禁止将 link 用作 CPT 名称，以避免 WordPress 核心冲突
• 修复 – 灵活内容布局的重复次数不再超过其最大数量限制
• 修复 – ACF 管理屏幕外显示的所有 ACF 通知现在都以插件名称为前缀
• 修复 – ACF 不再检查<PHP7 是否需要多补丁，多补丁已被移除

6.2.5

。

发布日期 2024 年 1 月 16 日

• 安全修复 – ACF 短代码现在将通过 wp_kses 运行所有输出，以转义不安全的 HTML。这可能会对您的网站造成影响，但出于安全考虑是必需的，如果您受到影响，WordPress 管理程序中将显示一条信息。更多信息请参阅有关此版本的博文。感谢 Francesco Carlucci 通过 Wordfence 负责任地披露此信息。
• 安全性 – ACF 现在会通过管理员消息发出警告，当即将对 the_field 和 the_sub_field 进行更改时，可能需要对您的网站进行主题更改，以避免剥离不安全的 HTML。有关详细信息，请参阅此版本的博文。
• 安全性 – 在即将发布的 ACF 中，在使用 the_field 和 the_sub_field 时，用户可通过新过滤器 acf/the_field/escape_html_optin 选择自动转义不安全的 HTML。

6.2.4

＜em＞发布日期：2023年11月28日＜/em＞

• 修复 – 自定义文章类型标签现在与 WordPress 6.4 中 “添加新内容 “标签的行为一致
• 修复 – 将文章类型和分类标准导出为 PHP 时，分类标准现在将出现在文章类型之前，与 ACF 注册它们的顺序相匹配。这解决了分类词缀在文章类型永久链接中不起作用的问题。
• 修复 – 分类标准、文章类型或选项页面的高级设置现在在切换为 “打开 “时以正确的顶部填充显示
• 修复 – 当父选项页面设置为 “重定向到子页面 “时，子页面现在将正确显示其父设置
• 修复 – 当作为必须使用的插件激活时，ACF PRO “更新 “页面现在可见。使用现有的 show_updates 设置来隐藏
• 修复 – 当作为必须使用的插件激活时，代码中定义的 ACF PRO 许可证现在可正确激活网站
• 修复 – 当 show_updates 被设置或过滤为 false 时，ACF PRO 现在仍会自动激活已定义的许可证。
• i18n – ACF PRO 激活服务器发送的维护和内部上游消息现在可进行翻译

6.2.3

发布日期 2023 年 11 月 15 日

• 查看发布文章
• 新功能 – ACF 块专用的 block.json JSON 模式现已在 GitHub 上提供。
• 新功能 – 灵活内容字段现在可在布局标题栏中显示布局名称，并支持点击复制
• 新功能 – 复制 “灵活内容 “布局时，现在会在其名称和标签上附加 “复制 “字样，这与字段组复制的行为相匹配
• 增强功能 – 当网站 URL 发生变化（如网站迁移后）时，ACF PRO 现在会自动尝试重新激活许可证。这解决了更新可能失败的问题
• 增强功能–字段组 “高 “位置的演示文稿设置明确说明块编辑器不支持该设置
• 修复：acf_format_date 现在可确保日期参数有效，以防止在传入其他数据类型时出现致命错误。
• 修复 – 带有自定义图标 URL 的 CPT 现在会在字段组屏幕的位置栏中显示文章图标
• 修复 – ACF JSON 导入表单现在将在首次提交时禁用，从而解决了可提交两次表单的问题
• 修复 – 使用嵌套布局时，”灵活内容 “字段中的 “添加行 “按钮现在可正确显示
• 修复 – ACF 管理页面加载时警告和错误提示不再闪烁
• i18n – ACF PRO 许可证激活成功和错误信息现在可翻译

6.2.2

发布日期 2023年10月25日

• 增强功能 – 编辑器尚未初始化的 ACF 块现在可正确呈现
• 增强功能 – 添加了一个新的 acf/filesize 过滤器，允许第三方媒体插件绕过 ACF 在未缓存文件大小的附件上调用 filesize() ，如果卸载，可能会导致远程下载。
• 增强功能 – “更新 “页面现在显示 ACF PRO 许可证状态和订阅到期日期
• 修复 – WooCommerce 8.2 或更新版本的产品页面现在可正确支持字段组位置规则
• 修复 – 现在可在移动设备上删除关系字段项目
• 修复 – 输入 3 个有效十六进制字符后，颜色选择器字段不再立即自动完成
• 修复 – 视口为 100% 以外时，字段设置不再出现错位
• 修复 – 不再向不带 aria-label 的 “选择 “字段发出警告
• 修复：使用 PHP 导出时，带有自定义文本域的 CPT 和分类标准现在可正确导出

6.2.1.1

发布日期 2023 年 9 月 8 日

• 修复 – 禁用用户界面选项页面时，编辑字段组不再产生错误

6.2.1

发布日期 2023 年 9 月 7 日

• 新功能 – 在管理用户界面中创建的选项页面现在可指定为任何顶层菜单项的子页面
• 新功能–为 ACF 文章类型添加 “标题占位符”设置，可在编辑文章时过滤 “添加标题”文本
• 增强功能 – ACF PRO 现在会在因 PHP 版本不兼容而无法更新时发出警告
• 增强功能 – ACF PRO 现在可与 WordPress 自动更新正确配合使用
• 增强功能 – ACF 块模板属性解析器内部函数 parseNodeAttr 现在可通过新的 acf_blocks_parse_node_attr 过滤器快捷使用。
• 增强功能 – 删除支持 WordPress 5.8 以下版本的遗留代码
• 修复 – 子选项页面的 “菜单位置 “设置不再隐藏
• 修复–“文章类型”和 “分类标准”中 “高级”设置的选项卡现在在封装 div 中呈现
• 修复 – 当选项页面设置为顶层页面后，不再作为子页面显示在列表视图中。
• 修复 – 与 Elementor CSS 的冲突导致 ACF PRO 横幅中断
• 修复：ACF 将不再捕获和忽略在块编辑器的 savePost 功能中生成的错误。

6.2.0

发布日期 2023 年 8 月 9 日

• 查看发布文章
• 新功能 – ACF 现在需要 WordPress 5.8 或更新版本，以及 PHP 7.0 或更新版本。查看发布文章了解更多信息
• 新功能：关系、文章对象、用户和分类字段现在支持双向关系。查看发布文章了解更多信息
• 新功能 – 选项页面现在可通过 ACF PRO 中的管理用户界面进行注册和管理
• 新 – 在插件页脚添加了产品反馈板的链接
• 增强功能 – ACF JSON 现在支持多个保存位置（道具 Freddy Leitner）
• 增强功能 – ACF 文章类型和分类法现在可以重复使用
• 增强功能 – 现在可以使用 acf/json/save_file_name 过滤器自定义 JSON 文件的文件名。
• 修复 – 对包含整数或混合键的选择字段进行的 REST 更新现在可正确执行
• 修复–使用 block_type_metadata_settings PHP 过滤器添加 usesContext 值不再会破坏 ACF 块。
• 修复 – 从 CPTUI 导入文章类型/分类标准的通知不再在页面加载时闪烁
• 修复 – 块中字段的各种按钮现在可正确显示
• 修复 – 在字段组编辑器中嵌套在多个字段中时，日期时间字段的设置不再被切断
• 修复：现在，在 JSON 文件末尾添加的换行符将使用 PHP_EOL 来检测正确的换行符，并使用过滤器 acf/json/eof_newline 来更改它。
• i18n – 更新了法语和葡萄牙语翻译（感谢 pedro-mendonca 和 maximebj）

View the full changelog