安全自定义字段

更新日志

6.8.9

Release Date 15th June 2026

Security

• Hardened the escaping of wp_options LIKE queries used when loading option-page meta and during taxonomy term cleanup, switching to esc_like() so option-name prefixes are always matched as literals rather than as patterns.

Fixes

• The URL, text, textarea, and select-style fields no longer raise PHP errors when a non-scalar value (such as an array) is submitted; such input is now treated as invalid.

6.8.8

Release Date 11th June 2026

Security

• AJAX field handlers now validate that the request nonce was created for the expected field type, so a nonce minted for one field type can no longer be replayed against another field type’s AJAX handler. The gallery field was also aligned with the typed nonce scheme used by all other AJAX fields.
• acf_decrypt() now treats malformed payloads as a decrypt failure and returns false instead of emitting PHP 8 warnings.

Enhancements

• acf_inline_toolbar_editing_attrs() now accepts a return_array argument that returns the attributes as an escaped array suitable for use with wp_get_attachment_image().

Fixes

• acf_form() with 'post_id' => 'new_post' and a fields list of field names no longer fatal errors when acf_form_head() runs before WordPress’s main query is built.
• Multiple acf_form() calls wrapped inside a single outer form tag with one submit button no longer silently drop field values, post_title, or post_content from the non-last forms. A new acf/form/meta_ttl filter controls how long per-form metadata remains valid.
• Duplicating a V3 block with identical attributes no longer displays corrupted preview content in the duplicate.
• Switching between tabs containing WYSIWYG fields no longer leaves the admin menu pinned against a shorter page, which could lock page scroll.

6.8.7

Release Date 8th June 2026

Fixes

• SCF’s Abilities API integration for its internal post types no longer triggers PHP warnings, notices, or a fatal error (500) on block editor and REST API requests when another active plugin builds the WordPress abilities registry earlier in the request; registration is skipped cleanly in that case and normal abilities behavior is otherwise unchanged.

6.8.6

Release Date 27th May 2026

Security

• Hardened the oEmbed field’s AJAX preview handling by restricting provider discovery for visitors and users without content-authoring capability while preserving previews from WordPress’s registered oEmbed providers.
• Hardened front-end acf_form() submission processing so the post_title and post_content form options are respected on save, and the save pipeline only accepts values for fields the rendered form exposed. A new acf/form/allowed_field_keys filter is available for sites that legitimately extend a form at runtime.

6.8.5

Release Date 19th May 2026

功能

Backports 6.8.1 feature work into SCF.

6.8.4

Release Date 30th April 2026

功能

• Backports 6.8.0 and 6.8.0.1 feature work into SCF.
• AI integration: SCF now integrates with the WordPress Abilities API, allowing external consumers, including AI tools, to manage field groups, post types, and taxonomies when explicitly enabled via the enable_acf_ai feature flag.
• Structured data: SCF can now generate JSON-LD structured data fields when explicitly enabled via the enable_schema feature flag.
• WP-CLI: Added wp scf json and backward-compatible wp acf json commands for importing, exporting, syncing, and checking the status of SCF JSON files.
• Post types: SCF custom post types now support the WordPress 6.9+ Notes editor feature via a new Notes checkbox in the Supports settings.
• JSON Schemas: Added v1 schemas for supported field types and updated field group, post type, and taxonomy schemas.

Enhancements

• Blocks V3: The Open in Expanded Editor button text can now be customized via a new acf.expandedEditorButtonText block.json property.
• Blocks V3: Added an acf/blocks/default_expanded_editor_button_text PHP filter to customize the default Open in Expanded Editor button text.
• Blocks V3: The edit and Open in Expanded Editor buttons can now be hidden via a new acf.expandedEditorButtons block.json property.
• Blocks V3: Added a blocks/expanded_editor_overlay_class JavaScript filter for customizing the Expanded Editor modal overlay class.
• Blocks V3: The block form HTML is now preloaded alongside the preview, eliminating an extra AJAX call on mount.
• Blocks V3: Expanded Editor buttons are now hidden for V3 blocks that have no fields assigned.
• SCF inline script tags now use wp_print_inline_script_tag() for Content Security Policy (CSP) compliance and nonce support.

Fixes

• V3 blocks with WYSIWYG fields no longer enqueue TinyMCE editor assets on the frontend.
• V3 blocks with identical attributes and different InnerBlocks content no longer return cached output from the first block on the frontend.
• Flexible Content fields now properly clean up nested postmeta when a parent layout containing nested Flexible Content fields is deleted.
• The Expanded Editor Done button now stays disabled until the AJAX save completes, preventing data loss.
• Pressing Escape while the Expanded Editor is saving will no longer close the modal, preventing data loss.
• InnerBlocks content containing backslashes or dollar signs now renders correctly.
• Auto Inline Editing now only applies to SCF Blocks V3, resolving incorrect hover/focus borders appearing on V2 blocks.
• Auto Inline Editing blocks now receive block context variables in render templates.
• Auto Inline Editing now works with blocks using renderCallback.
• Validation errors in the V3 Expanded Editor no longer cause a dead-end state.
• Icon Picker selections in Repeater fields no longer disappear.
• Range field number input now syncs to the slider and correctly updates V3 block previews.
• Message field Name and Instructions settings are no longer shown in the field group editor.
• Image field no longer crashes in WordPress 7.0 release candidates.
• V3 blocks registered via PHP now correctly show the Open in Expanded Editor button.
• Flexible Content disabled layouts now work correctly in Blocks V3.

6.8.3

Release Date 22th April 2026

Fixes

• Fix command palette type error on wp-admin.
• Plugins requiring ACF are also validated for SCF.
• REST API calls now honor the user’s unfiltered_html capability.
• Block Preview rendering now verifies the user can edit the target post.
• Paginated Repeater fields now verify the user can edit the target post.
• Flexible Content layout title AJAX requests now validate a security nonce.
• Clone field AJAX endpoints now enforce SCF admin permissions on field group listings.

6.8.2

Release Date 24th March 2026

Fixes

• AJAX Handlers: Prefix field-specific nonces to resolve an issue where third-party nonces could be treated as valid for AJAX calls.
• Block Preview: Verify that user has access to post specified via block context.
• Repeater Field: Verify that user has access to specified post.
• REST API: Apply KSES sanitization to field content saved by users without unfiltered_html capabilities.
• REST API: Respect show_in_rest setting for field groups in /types endpoint.

6.8.1

Release Date 11th March 2026

Backports from 6.7.1

• Security – User field AJAX queries now enforce field-configured role restrictions and validate search permissions.
• Security – Post Object, Relationship, and Page Link field AJAX queries now enforce field-configured restrictions for post status, post type, and taxonomy.
• Site Health – Track blocks using auto inline editing.

6.8.0

Release Date 30 Dec 2025

功能

• Abilities integration: addded field abilities for Field Groups.
• Abilities integration: added trash/untrash abilities for internal post types.
• All backports up to 6.7.0.2.
• JSON Schemas: Added several fields schemas.
• WooCommerce HPOS: Added support for custom fields on any WooCommerce Order Types.
• Added PHPUnit tests.

Fixes

• Hide duplicated Command Palette Commands on WP 6.9+.
• Fix field schema validation for WP Rest API.
• Fix checkbox toggle functionality.

6.7.0

6.7.1

Release Date 10 Dec 2025

功能

• JSON Schemas: Added Options Pages schema.

Fixes

• Fixed too-early validation of schemas causing a fatal error.
• Fix block validation on WordPress 6.2.

6.7.0

Release Date 3 Dec 2025

功能

• Tested compatibility up to WordPress 6.9.
• Abilities support. Taxonomy abilities.
• JSON schemas. Taxonomy schema.

6.6.0

Release Date 19 Nov 2025

功能

• Backported features up to 6.6.0.
• Abilities API integration. Post Type abilities.
• JSON schemas validation infrastructure.

Fixes

• Fixed Function in network.php
• SCF label in “More” menu.
• Get the formatted_value from the original field value.
• Blocks V3: Fix flexible content not working in sidebar – modal.
• Use specific entity prefixes for key generation when duplicating entities.

6.5.7

Release Date 28 Aug 2025

功能

• 灵活的内容布局现在可以在帖子编辑器中重命名，使内容编辑器在管理布局时更加清晰。
• 现在可以禁用灵活的内容布局，使其无法在前端呈现，而无需删除其数据。
• 灵活的内容布局现在可以批量折叠和展开，以加快内容编辑速度。
• Editing a Flexible Content layout now highlights the layout being edited, making it easier to identify.
• 日期和日期时间选择器字段现在可以配置为默认为当前日期。
• 在 ACF 块内使用自定义图标选取器选项卡时，现在可以正确工作。
• 使用俄语翻译时，复制字段组不再会导致致命错误。
• ACF 类不再使用动态类属性，从而提高了与 PHP 8.2+ 的兼容性。
• Field group metabox collapse and expand buttons are no longer misaligned in the post editor.
• HTML 现在可从字段验证错误和工具提示中转义。
• 为 /wp/v2/types REST API 端点添加了一个新的源参数，允许按来源过滤帖子类型：核心（WordPress 内置）、SCF（SCF 管理的类型）或其他 CPT。

Security

– 对于有条件加载的字段组，字段组标签中的不安全 HTML 现在可正确转义，从而解决了经典编辑器中的一个 JS 执行漏洞。
– 在 ACF 管理器中输出时，字段组标签中的 HTML 现在已转义。
– 双向和条件逻辑 Select2 元素不再在字段标签或帖子标题中呈现 HTML。
– acf.escHtml 函数现在使用第三方 DOMPurify 库来确保删除所有不安全的 HTML。新的 esc_html_dompurify_config JS 过滤器可用于修改默认行为。
– 现在，只要是由 ACF 代码输出的文章标题，都会正确转义。感谢 LAC Co., Ltd. 的 Shogo Kumamaru 负责信息披露。
– 在使用第 3 版 Select2 库时，现在会显示管理通知，因为该库已被弃用，转而使用第 4 版。

6.5.6

因 SVN 错误而放弃发布。

6.5.5

Release Date 31 Jul 2025

功能

• Connect block attributes with custom fields via UI.
• Remove the word ‘New’ from default add-new* label values.

Bug Fixes

• Bug fix: Prevent fatal if class does not exist on Beta Features.

6.5.4

Release Date 30 Jul 2025

Revert from 6.5.2.

6.5.2

Release Date 30 Jul 2025

功能

• Connect block attributes with custom fields via UI.
• Remove the word ‘New’ from default add-new* label values.

6.5.1

Release Date 2 Jul 2025

Bug Fixes

• Command Palette: Use @wordpress\icons instead of Dashicons.

6.5.0

Release Date 23 Jun 2025

Enhancements & Features

• 已添加命令调色板支持。
• 为 acf-field 源代码添加了编辑器预览。
• 添加了一个端点，用于检索帖子类型的自定义字段。
• 添加了导航菜单作为字段类型。
• Added compatibility with Woo HPOS for order fields and subscriptions. ( Ported from ACF )
• Create new options when editing a fields value on Selector. ( Ported from ACF )
• The “Escaped HTML” warning notice is now disabled by default. ( Ported from ACF )
• Added new acf/fields/icon_picker/{tab_name}/icons filter ( Ported from ACF )

Bug Fixes

• Update initialization of the acfL10n object to ensure it’s available globally.
• SCF Blocks are now forced into preview mode when editing a synced pattern. ( Ported from ACF )
• SCF no longer causes an infinite loop in bbPress when editing replies. ( Ported from ACF )
• Changing a field type no longer enables the “Allow Access to Value in Editor UI” setting. ( Ported from ACF )
• Blocks registered via acf_register_block_type() with a parent value of null no longer fail to register. ( Ported from ACF )
• Fix AJAX repeater pagination. ( Ported from ACF )
• Paginated Repeater fields no longer save duplicate values when saving to a WooCommerce Order with HPOS disabled ( Ported from ACF )

Testing

• 添加了第一批 e2e 测试。

6.4.2

Release Date 14 Apr 2025

• 解决了简码翻译无法正确解析的问题。
• 改进字段管理中的 URL 验证。

6.4.1

Release Date 7 Mar 2025

• 从 Advanced Custom Fields® 分叉
• 对编码标准进行各种更新。
• 已更新为依靠 WordPress.org 翻译包来翻译所有字符串。

6.3.9

发布日期 2024 年 10 月 22 日

• 版本更新发布

6.3.6.3

发布日期 2024年10月15日

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

6.3.6.2

发布日期 2024年10月12日

• 安全性 – 6.3.6.1 中的加固修复也涵盖 $_REQUEST。
• 分叉 – 将插件更名为安全自定义字段。

6.3.6.1

发布日期 2024 年 10 月 7 日

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