| 开发者 |
elliotcondon
bradt deliciousbrains wpengine mattshaw lgladdy antpb mindctrl modernnerd rfmeier andrewbotz dalewilliams polevaultweb johnstonphilip wordpressdotorg |
|---|---|
| 更新时间 | 2026年11月20日 03:57 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1.5 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
Support Forums. Our ACF Community Forums provide a great resource for searching and finding previously answered and asked support questions. You may create a new thread on these forums, however, it is not guaranteed that you will receive an answer from our support team. This is more of an area for ACF developers to talk to one another, post ideas, plugins and provide basic help. View the Support Forum
Our plugin's non-minified JS and CSS files are available on GitHub.
ACF includes an optional email signup to receive plugin updates and news. No data is collected unless you choose to subscribe. Your email is stored in accordance with WP Engine's Privacy Policy.
script tags in ACF Block preview HTML, including ones that load an external file, no longer run in the block editor unless the block opts in with allowDangerousPreviewScripts in block.json (or allow_dangerous_preview_scripts in acf_register_block_type()), or the site opts in with the new acf/blocks/allow_dangerous_preview_scripts filter[acf] shortcode no longer shows fields from draft or private posts referenced by a prefixed ID such as post_123 when used inside an ACF Block, or outside the loop such as in a widget on a 404 or search pageacf/settings_page/tabs, acf/settings_page/general/sections and acf/settings_page/general/{$section}/fields filters. The Features tab can be hidden with the new acf/settings/show_settings filterenable_acf_ai setting has been renamed to enable_abilities, and existing allow_ai_access values are not carried overacf/blocks/default_placeholder_button_text filteracf_register_block_type() can now set the InnerBlocks default_block and direct_insert optionsacf/create-book is now acf/create-book-post and acf/books is now acf/list-book-posts. Agent prompts and MCP configurations that use the old names need updatingacf/field-groups Ability now includes the list of fields within each field groupacf/blocks/auto_inline_editing/field_return_type_supports_auto_inline_editing filter allows customizing which fields support auto inline editing in ACF Blocks&, and saves inline edits as plain text instead of HTML-encoded textwp_insert_post() no longer causes a fatal error, a regression in 6.8.11_, a regression in 6.8.11is_preview() notice, a regression in 6.8.10acf/is_image_field filter when validating valuesacf/load_{$post_type} filter returns an invalid valueacf/fields/allow_append_choices filter can be used to restrict who can add new choices to a field. Thanks to Jakub Herman via WPScan for the responsible disclosureunfiltered_html capability. For those users, a field's wrapper settings are limited to width, class, and id. Event handler (on*) attributes in a field's wrapper setting are no longer output for any field, including fields registered in PHP or local JSON[acf] shortcode, block bindings, JSON-LD output, or the REST API until the password is entered. REST responses also no longer expand a referenced password-protected post into a full post object[acf] shortcode and ACF block bindings now output only user IDs for User fields, rather than personal data such as names and email addresses. The previous output can be restored with the new acf/bindings/allow_user_data filterupload_files capability no longer generate PDF preview images or save embedded audio and video cover art. This can be changed with the new acf/upload/generate_previews filteracf/form/{context}/allowed_field_keys and acf/options_page/allowed_field_keys filters. Registration forms no longer save fields from field groups set to "User Form is Add / Edit". Thanks to vuxvinh via WPScan for the responsible disclosure&, <, or certain HTML entities no longer cause the field to revert to its default settings after saving%PDF- header before further processing, rejecting files that do not match the expected format_acf_form token used by frontend forms now expires and is bound to its issuing render, and acf_encrypt() / acf_decrypt() gain an optional $context argument for domain separation between token usesacf/validate_value filters cannot be circumventedacf_register_block_type() or block.json without an explicit version now default to v3 on WordPress 7.1 or later. Blocks that specify a version continue to use the version they declare, and the default can be customized via the acf/blocks/default_block_version filterrenderPreview option in block.json. Setting "renderPreview": false shows a placeholder with the block's icon, title, and an "Edit Block" button in the editor instead of rendering the block's template as a live preview. The block continues to render normally on the front-end, and legacy v2 blocks combining "mode": "edit" with "supports": { "mode": false } are automatically migrated when upgraded to v3path attribute of registered ACF Blocks is now protected from being overridden by client-supplied block dataacf_encrypt() and acf_decrypt() helpers now authenticate encrypted values with an HMAC and no longer fall back to base64 encoding when OpenSSL is unavailablelist_users capability, preventing unauthenticated visitors from seeing user email addresses[ or {acf/fields/max_appended_choices filter available for customizationwp_options queries via $wpdb->esc_like()advanced-custom-fields, so plugins requiring ACF can activate when only ACF PRO is installedacf_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()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 builtacf_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 formsedit_posts capability.acf_form()) now respect the post_title and post_content form configuration options when processing submissions, ensuring those values are only saved when the form is configured to accept them. Thanks to Sarawut Poolkhet (MisterHelloz) for the responsible disclosure.acf_form()) now only save values for fields assigned to the form via the fields or field_groups parameters, or via the form's location ruleswp.data store (acf/fields) is now available in ACF PRO for reading and writing ACF field values from JavaScript, which can be enabled via a new acf/settings/enable_datastore filter (requires WordPress 6.7 or later).enable_block_bindings setting are enabled.acf.fields array in block.json, or via a fields argument in acf_register_block_type(), with field keys auto-generated and scoped to the blockTypeError when row_index_offset or the active loop index is non-numerichideFieldsInSidebar enabled no longer show fields in the sidebar after the inline toolbar popover is closedacf/delete-{taxonomy} ability no longer returns a 501 error when called without an explicit force argument, as terms cannot be trashedprepare_field_for_ability_import filter is now correctly removed after each Abilities field group import, preventing subsequent imports in the same request from having values corruptedenable_acf_ai feature flagenable_schema feature flagwp acf json commands for importing, exporting, syncing, and checking the status of ACF JSON filesacf.expandedEditorButtonText block.json propertyacf/blocks/default_expanded_editor_button_text PHP filter allows customizing the default "Open in Expanded Editor" button text for all V3 blocksacf.expandedEditorButtons block.json propertyblocks/expanded_editor_overlay_class JS filter allows customizing the CSS class on the Expanded Editor modal overlaywp_print_inline_script_tag() for Content Security Policy (CSP) compliance and nonce supportrenderCallbackunfiltered_html capability is now correctly applied to REST API callsconvert_field_name_to_lowercase JS filter to allow uppercase letters in ACF field nameshideFieldsInSidebar setting in block.jsonacf.escHtml function now uses the third party DOMPurify library to ensure all unsafe HTML is removed. A new esc_html_dompurify_config JS filter can be used to modify the default behaviourparent value of null no longer fail to registeracf/fields/icon_picker/{tab_name}/icons filteracf_get_reference() with an invalid field name no longer causes a fatal errorinit action hookedit_posts capability but with custom capabilities for a editing a custom post type, can now correctly load field groups loaded via conditional location rulesthe_field, the_sub_field or the ACF shortcode, or when retrieved by a get_ function with the escape html parameter setselected attribute to specify which should be selected by default, and support class attributesacf/json/save_file_name filter now correctly applies when deleting JSON filesacf/field source. For more information on how to use this, please read the release blog postselect2_escape_markup now allows fields to customize select2's HTML escaping behaviorthe_field now escapes potentially unsafe HTML as notified since ACF 6.2.5. For full information, please read the release blog postacf/shortcode/prevent_access filter is now available to limit what data the ACF shortcode is allowed to access$escape_html on get functions for array returning field types no longer produces an Array to string conversion errorget_field() and other get_ functions now support an escape_html parameter which return an HTML safe field valueesc_url rather than wp_kses_post when returning an HTML safe valuerequired property would have no effect (such as the tab, or accordion) will no longer show the optionlink is now prohibited from being used as a CPT name to avoid a WordPress core conflictwp_kses, escaping unsafe HTML. This may be a breaking change to your site but is required for security, a message will be shown in WordPress admin if you are affected. Please see the blog post for this release for more information. Thanks to Francesco Carlucci via Wordfence for the responsible disclosurethe_field and the_sub_field may require theme changes to your site to avoid stripping unsafe HTML. Please see the blog post for this release for more informationacf/the_field/escape_html_optin when using the_field and the_sub_field before this becomes default in an upcoming ACF release.show_updates setting to hideshow_updates is set or filtered to false, ACF PRO will now automatically still activate defined licensesacf_format_date now ensures the date parameter is valid to prevent fatal errors if other data types are passed inacf/filesize filter to allow third party media plugins to bypass ACF calling filesize() on attachments with uncached file sizes, which may result in a remote download if offloadedparseNodeAttr can now be shortcut with the new acf_blocks_parse_node_attr filter.savePost function will no longer be caught and ignored by ACFacf/json/save_file_name filterblock_type_metadata_settings PHP filter to add usesContext values no longer breaks ACF blocksPHP_EOL to detect the correct newline character with a filter acf/json/eof_newline to alter it.