描述
使用 Advanced Custom Fields 插件便能完全控制 WordPress 网站的编辑画面及自定义字段数据。
依据需求添加字段。插件的字段产生器能让网站管理员快速轻松地在几个点击操作后,将字段添加至 WordPress 网站的编辑画面。
将字段添加至任何位置。可将自定义字段添加至 WordPress 网站的任意位置,包含文章、用户、各式分类法、媒体、留言,甚至是自定义设置页面。
在任何位置显示自定义字段。使用插件内的免开发经验友善功能,便可在任何布景主题范本文件内加载并显示自定义字段及其字段值。
插件特色
- 使用方式简单直觉
- 功能强大
- 超过 30 种自定义字段类型
- 完整的在线说明文档
- 超过百万的爱用者
相关链接
付费 PRO 版
Advanced Custom Fields 插件同时也提供内置更多自定义字段、更多功能、也更加弹性的付费 Pro 版本。进一步了解 Pro 版
安装
从 WordPress 网站管理后台进行安装
- 造访 [插件] > [安装插件] 页面。
- 搜索「Advanced Custom Fields」。
- 在 [插件] 页面中激活 Advanced Custom Fields。
- 点击 管理后台左侧菜单上的 [自定义字段],并创建第一个自定义字段群组。
- 阅读在线说明文档以便开始使用。
常见问题
-
插件开发者能为用户提供的技术支持有哪些?
-
支持中心:如需技术支持,可通过我们的电子邮件技术支持中心取得。用户提出的问题一般来说都会在 24 小时内得到答复,但不包含周末六日及假日。我们会回答与 ACF 有关的问题、ACF 的使用方式及简单的客制化指南。我们不保证会回答关于自定义布景主题代码、或其他第三方插件所造成的冲突及兼容性问题。提出技术支持需求
支持论坛:插件的官方社群论坛为搜索及寻找已回答过的技术支持问题提供了良好的资源。免费版用户可以在技术支持论坛上创建新主题,但不保证会收到官方技术支持团队的回复。这里更像是开发人员相互交流、发布想法、插件及提供基本协助的地方。查看技术支持论坛内容
评价
贡献者及开发者
更新日志
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