readme.txt 45 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732
  1. === Advanced Custom Fields Pro ===
  2. Contributors: elliotcondon
  3. Tags: acf, fields, custom fields, meta, repeater
  4. Requires at least: 4.7
  5. Tested up to: 6.1.1
  6. Requires PHP: 5.6
  7. Stable tag: 6.0.6
  8. License: GPLv2 or later
  9. License URI: https://www.gnu.org/licenses/gpl-2.0.html
  10. Customize WordPress with powerful, professional and intuitive fields. Proudly powering over 2 million websites, Advanced Custom Fields is the plugin WordPress developers love.
  11. == Description ==
  12. Advanced Custom Fields turns WordPress sites into a fully-fledged content management system by giving you all the tools to do more with your data.
  13. Use the Advanced Custom Fields plugin to take full control of your WordPress edit screens & custom field data.
  14. **Add fields on demand.** Our field builder allows you to quickly and easily add fields to WP edit screens with only the click of a few buttons!
  15. **Add them anywhere.** Fields can be added all over WP including posts, users, taxonomy terms, media, comments and even custom options pages!
  16. **Show them everywhere.** Load and display your custom field values in any theme template file with our hassle free developer friendly functions!
  17. = Features =
  18. * Simple & Intuitive
  19. * Powerful Functions
  20. * Over 30 Field Types
  21. * Extensive Documentation
  22. * Millions of Users
  23. = Links =
  24. * [Website](https://advancedcustomfields.com/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Website)
  25. * [Documentation](https://advancedcustomfields.com/resources/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Website)
  26. * [Support](https://support.advancedcustomfields.com)
  27. * [ACF PRO](https://advancedcustomfields.com/pro/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Pro%20Upgrade)
  28. = PRO =
  29. The Advanced Custom Fields plugin is also available in a professional version which includes more fields, more functionality, and more flexibility!
  30. * The [Repeater Field](https://www.advancedcustomfields.com/resources/repeater/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Pro%20Upgrade) allows you to create a set of sub fields which can be repeated again, and again, and again.
  31. * [ACF Blocks](https://www.advancedcustomfields.com/resources/blocks/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Pro%20Upgrade), a powerful PHP-based framework for developing custom block types for the WordPress Block Editor (aka Gutenberg).
  32. * Define, create, and manage content with the [Flexible Content Field](https://www.advancedcustomfields.com/resources/flexible-content/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Pro%20Upgrade), which provides for multiple layout and sub field options
  33. * Use the [Options Page](https://www.advancedcustomfields.com/resources/options-page/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Pro%20Upgrade) feature to add custom admin pages to edit ACF fields.
  34. * Build fully customisable image galleries with the [Gallery Field](https://www.advancedcustomfields.com/resources/gallery/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Pro%20Upgrade)
  35. * Unlock a more efficient workflow for managing field settings by reusing existing fields and field groups on demand with the [Clone Field](https://www.advancedcustomfields.com/resources/clone/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Pro%20Upgrade)
  36. [Upgrade to Pro](https://advancedcustomfields.com/pro/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Pro%20Upgrade)
  37. == Installation ==
  38. From your WordPress dashboard
  39. 1. **Visit** Plugins > Add New
  40. 2. **Search** for "Advanced Custom Fields"
  41. 3. **Install and Activate** Advanced Custom Fields from your Plugins page
  42. 4. **Click** on the new menu item "Custom Fields" and create your first Custom Field Group!
  43. 5. **Read** the documentation to [get started](https://advancedcustomfields.com/resources/getting-started-with-acf/?utm_source=wordpress.org&utm_medium=free%20plugin%20listing&utm_campaign=ACF%20Website)
  44. == Frequently Asked Questions ==
  45. = What kind of support do you provide? =
  46. **Support Forums.** Our 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 developers to talk to one another, post ideas, plugins and provide basic help. [View the Support Forum](https://support.advancedcustomfields.com/)
  47. == Screenshots ==
  48. 1. Simple & Intuitive
  49. 2. Made for developers
  50. 3. All about fields
  51. == Changelog ==
  52. = 6.0.6 =
  53. *Release Date 13th December 2022*
  54. * [View Release Post](https://www.advancedcustomfields.com/blog/acf-6-0-6-release-flexible-content-field-layout-improvement/)
  55. * New - Flexible Content field now has a new admin user experience when editing layouts
  56. * New - Tabs for field settings in the field group editor can now be disabled via a new “Field Settings Tabs” screen option or with the new [`acf/field_group/disable_field_settings_tabs`](https://www.advancedcustomfields.com/resources/acf-field_group-disable_field_settings_tabs) filter
  57. * Improvement - General field settings tab now selected by default when a field is opened
  58. * Fix - Sub fields are no longer initialized by their parent, resolving performance issues when field groups contain many nested sub fields
  59. * Fix - Frontend forms now disable the submit button after click to prevent multiple submissions
  60. * Fix - Unknown field types no longer display broken HTML in the field group editor
  61. * Fix - Returning an empty string via the `acf/blocks/no_fields_assigned_message` filter will no longer result in blocks without fields assigned having an extra wrapping div
  62. * Fix - Sites with WPML enabled no longer experience failed ACF updates due to license errors
  63. * Fix - Buttons featuring icons no longer have display issues when using RTL languages
  64. = 6.0.5 =
  65. *Release Date 18th November 2022*
  66. * Fix - Uploading multiple files nested in a subfield no longer causes a fatal error when using basic uploader (props @JoKolov)
  67. = 6.0.4 =
  68. *Release Date 8th November 2022*
  69. * Improvement - JavaScript initialization performance while editing large field groups has been improved, especially in Safari
  70. * Improvement - Tooltips for field settings are now shown as inline instructions
  71. * Improvement - Saving a field group is now disabled until a field group title has been entered
  72. * Improvement - Additional sanitization across various internal parts of the plugin
  73. * Fix - Dragging and dropping a field in no longer opens the field settings in Firefox
  74. * Fix - Copying the field name or key to the clipboard now works as expected for new or reordered fields, and subfields
  75. * Fix - Saving a field group will now temporarily disable the "Save Changes" button while saving
  76. * Fix - Block templates that include html comments as the first DOM element no longer crash the block editor on edit
  77. * Fix - Block templates that include InnerBlocks on the DOM’s first level no longer trigger JS warnings
  78. * Fix - Block templates that render other blocks now correctly render their InnerBlocks
  79. * Fix - Legacy block attribute values are no longer overwritten by blank defaults of new versions
  80. * Fix - Paginated Repeater fields now work with non-paginated Repeaters as subfields
  81. * Fix - Repeater pagination is now properly disabled while inside blocks
  82. * Fix - REST API no longer causes a PHP warning if `$_SERVER['REQUEST_METHOD']` is not defined
  83. * Fix - REST API now supports integer keys for the Select field
  84. * Fix - REST API now supports passing `null` to Image and File fields
  85. * Fix - Invalid ACF meta keys no longer cause a fatal error when retrieved with `get_fields()`
  86. * a11y - The Relationship field is now fully accessible for keyboard navigation
  87. * i18n - Select dropdown arrow is now aligned correctly in RTL languages
  88. * i18n - Radio buttons are now aligned correctly in RTL languages
  89. = 6.0.3 =
  90. *Release Date 18th October 2022*
  91. * Security Fix - ACF shortcode security fixes detailed [here](https://www.advancedcustomfields.com/blog/acf-6-0-3-release-security-changes-to-the-acf-shortcode-and-ui-improvements/#acf-shortcode)
  92. * Improvement - Field names and keys now copy to clipboard on click, and do not open a field
  93. * Fix - The field type input now has default focus when adding a new field
  94. * Fix - ACF no longer publishes `h1`, `h2` or `h3` CSS classes outside of the ACF admin screens
  95. * Fix - Conditional field settings now work correctly across different tabs
  96. * Fix - The field list for sub fields are now full width
  97. * Fix - ACF admin notices now display with correct margin
  98. * Fix - Admin CSS improvements when using ACF in an RTL language
  99. * Fix - Clone fields now have the presentation tab for setting wrapper properties when in group display mode
  100. * Fix - Appended labels on field settings will now be displayed in the correct place
  101. * Accessibility - The move field modal is now keyboard and screen reader accessible
  102. = 6.0.2 =
  103. *Release Date 29th September 2022*
  104. * Improvement - Field group and field rows no longer animate on hover to reveal the action links
  105. * Fix - Field order is now saved correctly when fields are reordered
  106. * Fix - WordPress notice styles outside of ACF's admin screens are no longer affected by the plugin's CSS
  107. = 6.0.1 =
  108. *Release Date 28th September 2022*
  109. * Improvement - ACF's header bar inside our admin pages is no longer sticky
  110. * Improvement - ACF's admin pages no longer use a custom font
  111. * Fix - Duplicating flexible content layouts now works correctly
  112. * Fix - ACF CSS classes no longer target translated class names for sub pages, resolving issues when using ACF in a language other than English
  113. * Fix - ACF no longer reactivates when using WPML with different domains per language
  114. * Fix - i18n - Labels for some field settings no longer break onto multiple lines in languages other than English
  115. * Fix - Radio field types no longer generate a warning in logs due to invalid parameter counts
  116. * Fix - True/False field focus states no longer apply outside ACF admin screens
  117. * Fix - Focus states for many field types no longer show when interacting with a mouse input
  118. * Fix - ACF 6’s new Tab background colors no longer apply outside ACF admin screens, increasing readability
  119. * Fix - User fields named “name” no longer have a different label presentation view
  120. * Fix - Changing field types with subfields no longer removes those fields when switching field type and back
  121. * Fix - Resolved a potential fatal error if a third party plugin sets the global `$post_type` something other than a string
  122. * Fix - Tooltip alignment is no longer incorrect inside subfields
  123. * Fix - Resolved a potential JS error when third party plugins modify the metabox sort order
  124. = 6.0.0 =
  125. *Release Date 21st September 2022*
  126. * New - ACF now has a new refreshed UI with improved UX for editing field groups, including a new tabbed settings layout for fields. Third party ACF extension plugin developers can read more about the optional changes they can make to support the new tabs in [our release announcement post](https://www.advancedcustomfields.com/blog/acf-6-0-released/#new-ui)
  127. * New - Repeaters now have an optional "Pagination" setting which can be used to control the number of rows displayed at once. More details can be found on our [Repeater field documentation](https://www.advancedcustomfields.com/resources/repeater/#pagination)
  128. * New - ACF Blocks now have a versioning system allowing developers to opt in to new features
  129. * New - ACF Blocks now support version 2, enabling block.json support, reduced wrapper markup and significant other new features. Full details and examples of this can be found in [What's new with ACF Blocks in ACF 6](https://www.advancedcustomfields.com/resources/whats-new-with-acf-blocks-in-acf-6/)
  130. * New - ACF Blocks no longer use Block IDs saved in the block comment. See [What's new with ACF Blocks in ACF 6](https://www.advancedcustomfields.com/resources/whats-new-with-acf-blocks-in-acf-6/#block-id) for more information.
  131. * Enhancement - Bulk actions for field groups now include "Activate" and "Deactivate" options
  132. * Fix - ACF will no longer perform a multisite database upgrade check on every admin load once each upgrade has been performed
  133. * Fix - ACF Blocks preloading now works for blocks saved in edit mode
  134. * Fix - ACF Blocks edit forms now behave correctly if they are not visible when loaded
  135. * Fix - ACF Blocks now always fire `render_block_preview` events when a block preview is displayed or redisplayed
  136. * Fix - ACF Blocks with no fields now display advisory text and are selectable in the block editor. This message is filterable with the acf/blocks/no_fields_assigned_message filter, providing both the message to be displayed and the block name it's being displayed against
  137. * Fix - Accordions inside ACF Blocks now match the current native block styling
  138. * Fix - ACF Blocks which contain no fields now preload correctly
  139. * Fix - Changes to an ACF Block's context now trigger a re-render
  140. * Fix - A rare warning inside `wp_post_revision_field` will no longer be possible
  141. * Fix - The field “move” option now no longer displays for fields when only one field group exists
  142. * Fix - Language for field group activation state now standardized to "active" and "inactive"
  143. * Fix - SVGs containing `foreignObject` tags now correctly render in JSX rendered ACF Blocks
  144. * Fix - Server errors during ACF updates or version checks are now cached for 5 minutes rather than 24 hours
  145. * Accessibility - The new ACF UI has significantly improved accessibility for screen readers and alternative input options
  146. * i18n - All strings inside ACF are now translatable
  147. * i18n - Accented term names in taxonomy fields are no longer corrupted at output
  148. * i18n - ACF translations are now synced with contributions from translation.wordpress.org at each release, increasing ACF's supported languages and updating many other translations. PRO strings should still be submitted as pull requests on GitHub (Additional thanks to maximebj, emreerkan and Timothée Moulin for their contributions which are included here)
  149. = 5.12.4 =
  150. *Release Date 18th October 2022*
  151. * Security Fix - ACF shortcode security fixes from the ACF 6.0.3 release. See the [6.0.3 release post](https://www.advancedcustomfields.com/blog/acf-6-0-3-release-security-changes-to-the-acf-shortcode-and-ui-improvements/#acf-shortcode) for more information
  152. = 5.12.3 =
  153. *Release Date 14th July 2022*
  154. * 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.)
  155. = 5.12.2 =
  156. *Release Date 6th April 2022*
  157. * Fix - Cloned fields in custom named options pages now behave correctly
  158. * Fix - Default values and the `acf/load_value` filter are now applied if a field value load [fails security validation](https://www.advancedcustomfields.com/resources/acf-field-functions/#non-acf-data)
  159. * Fix - The ACF field is no longer present in REST responses if the ACF REST API setting is disabled
  160. * Fix - Duplicating a flexible content layout or repeater row now also replaces the field ID in `for` attributes
  161. = 5.12.1 =
  162. *Release Date 23rd March 2022*
  163. * New - REST API now supports the comment route for displaying ACF fields.
  164. * Fix - ACF now validates access to option page field values when accessing via field keys the same way as field names. [View More](https://www.advancedcustomfields.com/resources/acf-field-functions/#non-acf-data)
  165. * Fix - REST API now correctly validates fields for POST update requests
  166. * Fix - Fixed an issue where invalid field types caused an error during REST API requests
  167. * Fix - Fixed a PHP warning when duplicating an empty field group
  168. * 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
  169. * Fix - Fixed a bug where the `acf-block-preview` wrapper might not appear around a block if it was saved in edit mode
  170. * i18n - Updated several translations from user contributions (Thanks to Dariusz Zielonka, Mikko Kekki and Alberto!)
  171. = 5.12 =
  172. *Release Date 23rd February 2022*
  173. * [View Release Post](https://www.advancedcustomfields.com/blog/acf-5-12-released/)
  174. * New - ACF blocks now support the new Full Site Editor included in WordPress 5.9
  175. * New - ACF blocks now support the WordPress Query Loop block
  176. * New - Added block caching system to reduce the number of AJAX calls in the block editor
  177. * Enhancement - Block preloading can now be disabled by using "acf_update_setting( 'preload_blocks', false );" in the "acf/init" action hook
  178. * Enhancement - ACF and ACF PRO will now detect if each other are active and deactivate the other plugin on plugin activation
  179. * Fix - Fixed an issue with the media library not working correctly in ACF Blocks in WordPress 5.9.1
  180. * Fix - Fixed an issue where anchors weren't working correctly in WordPress 5.9
  181. * Fix - Fixed an issue where the "unfiltered_html" capability wasn't being used by ACF blocks
  182. * Fix - Fixed an issue where it was impossible to update an ACF block inside the widget block editor
  183. * Fix - Fixed an issue where ACF fields might not appear in REST API calls made via internal WordPress functions
  184. * Fix - Warnings and PHP 8.1 deprecation notices in REST API
  185. * Fix - Better support for double byte characters in "acf_get_truncated()" (props @cabradb)
  186. * i18n - Broken link in the Croatian translation
  187. * i18n - Automated building of acf.pot for translators in each release
  188. = 5.11.4 =
  189. *Release Date - 2nd December 2021*
  190. * Fix - Fixed several Select2.js conflicts with other plugins
  191. * Fix - Fixed an issue where block name sanitization could change valid block names containing double hyphens
  192. * Fix - Fixed an issue where blocks with integer IDs could fail to load example field data
  193. = 5.11.3 =
  194. *Release Date - 24th November 2021*
  195. * Fix - Fixed a bug when accessing field values for options pages registered with a custom post_id
  196. = 5.11.2 =
  197. *Release Date - 24th November 2021*
  198. * Fix - Previously implemented data access changes for get_field() and the_field() are now limited to the ACF shortcode only. [Learn more](https://www.advancedcustomfields.com/resources/acf-field-functions/)
  199. * 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
  200. * Fix - get_field() and the_field() functions now are only able to access site options which are ACF fields
  201. * 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
  202. * Fix - User fields failed to load values when using the legacy select2 v3 option
  203. * Fix - acf_slugify() now correctly supports special characters which solves issues with block names or field group names (during imports) containing those characters
  204. * Fix - PHP Notice generated while processing a field group’s postbox classes
  205. = 5.11.1 =
  206. *Release Date - 18 November 2021*
  207. * Enhancement - Added "acf/admin/license_key_constant_message" filter to allow changing of the "Your license key is defined in wp-config.php" message
  208. * Fix - Added warning for when get_field() or similar functions are called before ACF has initialized. [Learn more](https://www.advancedcustomfields.com/resources/acf-field-functions/)
  209. * Fix - Fixed fields not appearing on user REST API endpoints if their field group location was set to a user form other than "all"
  210. * Fix - Fixed warning in REST API if a custom field type did not have the "show_in_rest" property
  211. * Fix - Fixed an error that could occur if value of WYSIWYG field was not a string
  212. = 5.11 =
  213. *Release Date - 10 November 2021*
  214. * [View Release Post](https://www.advancedcustomfields.com/blog/acf-5-11-release-rest-api/)
  215. * New - Fields can now be viewed and updated with the WordPress REST API (props @mishterk)
  216. * New - License key can now be defined in code with the "ACF_PRO_LICENSE" constant
  217. * Enhancement - Improved error handling for expired or deactivated licenses
  218. * Enhancement - Improved support for various block editor features, such as block styles and padding/spacing
  219. * Enhancement - Added support for using WordPress "Screen Options" to hide field groups in Classic Editor
  220. * Enhancement - Support filters adding custom classes on date and time field inputs
  221. * Enhancement - Support filtering ACF shortcode attributes (with the "shortcode_atts_acf" filter)
  222. * Fix - Removed usages of PHP "extract()" function
  223. * Fix - Fixed a security issue with user field
  224. * Fix - Fixed a security issue with "acf_get_value()"
  225. * Fix - Correctly set ".acf-block-preview" wrapper when previewing a block in auto mode
  226. * Fix - Resolved an issue with select2 rendering for nav menu fields
  227. * Fix - Fixed an issue with file validation that occurred when removing a file that failed validation
  228. * Fix - Fixed a notice in "acf_prepare_field()"
  229. * Fix - Prevented an issue where setting an empty string for the return format of date and time fields would cause JS errors
  230. * Fix - Fix issues with conditional logic for multi-select fields (props @bhujagendra-ishaya)
  231. * Fix - Added support for Google Maps schema change which prevented Google Maps fields from correctly saving the city for some areas
  232. * Fix - Fixed an issue where removing the collapsed property of a repeater prevents viewing previously collapsed rows
  233. * i18n - Updated Polish Translations (props @webnatural)
  234. * Dev - Formatted JavaScript to WordPress code standards
  235. = 5.10.2 =
  236. *Release Date - 31 August 2021*
  237. * Fix - Fixed block duplication issues which created blocks with duplicate block IDs
  238. * Fix - Fixed an issue with ACF errors displaying in the media library outside of ACF fields
  239. * Fix - Changed label of "Enable Opacity?" to "Allow transparency" in the colour picker
  240. * Fix - Revert "style" attributes of ACF Blocks to 5.9.x behaviour for template compatibility
  241. * Fix - Allow safe HTML inside select2 field labels
  242. * Fix - Don't render the "acf-block-preview" div when preloading blocks in edit mode
  243. = 5.10.1 =
  244. *Release Date - 26 August 2021*
  245. * Fix - Fixed conflict with WooCommerce loading SelectWoo which is not directly compatible with Select2.
  246. = 5.10 =
  247. *Release Date - 25 August 2021*
  248. * [View Release Post](https://www.advancedcustomfields.com/blog/acf-5-10-release-html-escaping-blocks-api-v2-block-preloading-and-more/)
  249. * Enhancement - Improved security by running all user-generated content through `wp_kses()` by default
  250. * Enhancement - New ACF Blocks features
  251. * Switched to v2 of the Blocks API for WordPress 5.6+
  252. * Block preloading now enabled by default
  253. * Block preloading now supports blocks set to "Edit" mode
  254. * Add support for full height alignment setting
  255. * Enhancement - Added setting to color picker field to enable an opacity slider
  256. * Enhancement - Allow deletion of first field group location rule if multiple rules have been added thanks to Arthur Shlain
  257. * Fix - Fixed vulnerability with `acf_shortcode()` where users with subscriber role could view arbitrary ACF data, thanks to Keitaro Yamazaki
  258. * Fix - Fixed vulnerability where users with subscriber role could move fields and view field groups, thanks to Keitaro Yamazaki
  259. * Fix - Fixed issue where fields in legacy widgets weren't saving in new widget block editor
  260. * Fix - Fixed issue with custom field validation in scheduled posts
  261. * Fix - Fixed warnings thrown by clone field if the cloned field group is empty
  262. * Fix - Fixed issue where Select2 search input wouldn't have focus in WordPress 5.8+
  263. * Fix - Fixed issue with Select2 value sorting when Yoast SEO is installed
  264. * Fix - Fixed deprecation warnings in block editor in WordPress 5.6+
  265. * i18n - Updated Swedish translation thanks to Erik Betshammar
  266. = 5.9.9 =
  267. *Release Date - 20 July 2021*
  268. * Fix - Fixed warning when deleting fields which don't exist
  269. * Fix - Fixed issues with older browsers and the blocks JavaScript
  270. * Fix - Fixed file size & file type validation for front end forms using the basic uploader
  271. = 5.9.8 =
  272. *Release Date - 08 July 2021*
  273. * Fix - Fixed bug causing multiple image fields to not validate files properly
  274. * Fix - Fixed bug preventing case-sensitive HTML tags from working in blocks
  275. * Fix - Fixed bug causing JSX-enabled blocks to improperly remove whitespace in preview
  276. * Fix - Fixed bug causing text fields to remove HTML entities when editing saved fields
  277. * Fix - Fixed deprecated jQuery notices on "Add Field Group" page
  278. = 5.9.7 =
  279. *Release Date - 22 June 2021*
  280. * Fix - Fixed PHP warnings logged due to incorrect parameter type for `add_menu_page()`/`add_submenu_page()`
  281. * Fix - Fixed bug causing WYSIWYG field to not keep line breaks
  282. * Fix - Fixed bug causing Email field to incorrectly invalidate emails with unicode characters
  283. * Fix - Fixed bug causing file type validation to fail in some cases
  284. * Fix - Fixed bug where newly uploaded or selected images do not contain custom preview size data
  285. = 5.9.6 =
  286. *Release Date - 20 May 2021*
  287. * Enhancement - Added 'position' setting compatibility for Options Page submenus.
  288. * Enhancement - Visually highlight "High" metabox area when dragging metaboxes.
  289. * Fix - Fixed compatibility issue between Block matrix alignment setting and the latest version of Gutenberg (10.6).
  290. * Fix - Fixed bug breaking WYSIWYG field after reordering a child block via the block's toolbar up/down buttons.
  291. * Fix - Added missing "readonly" and "disabled" attributes to DateTime and Time picker fields.
  292. * Fix - Fixed bug incorrectly validating Email field values containing special characters.
  293. * Fix - Fixed missing "dashicons" asset dependency from front-end forms.
  294. * Fix - Fixed bug causing Review JSON diff modal to appear with narrow column since WP 5.7.
  295. * Dev - Added label elements to Repeater, Flexible Content and Clone field's table header titles.
  296. * Dev - Added new `ACF_EXPERIMENTAL_ESC_HTML` constant. [Read more](https://github.com/AdvancedCustomFields/acf/issues/500)
  297. = 5.9.5 =
  298. *Release Date - 11 February 2021*
  299. * Fix - Fixed regression preventing blocks from loading correctly within the editor in WordPress 5.5.
  300. * Fix - Fixed bug causing incorrect post_status properties when restoring a Field Group from trash in WordPress 5.6.
  301. * Fix - Fixed edge case bug where a taxonomy named "options" could interfere with saving and loading option values.
  302. * Fix - Fixed additional PHP 8.0 warnings.
  303. * i18n - Updated Finnish translation thanks to Mikko Kekki
  304. = 5.9.4 =
  305. *Release Date - 14 January 2021*
  306. * Enhancement - Added PHP validation for the Email field (previously relied solely on browser validation).
  307. * Fix - Added support for PHP 8.0 (fixed logged warnings).
  308. * Fix - Added support for jQuery 3.5 (fixed logged warnings).
  309. * Fix - Fixed bug causing WYSIWYG field to appear unresponsive within the Gutenberg editor.
  310. * Fix - Fixed regression preventing "blog_%d" and "site_%d" as valid `$post_id` values for custom Taxonomy terms.
  311. * Fix - Fixed bug causing Radio field label to select first choice.
  312. * Fix - Fixed bug preventing preloading blocks that contain multiple parent DOM elements.
  313. * i18n - Updated Japanese translation thanks to Ryo Takahashi.
  314. * i18n - Updated Portuguese translation thanks to Pedro Mendonça.
  315. = 5.9.3 =
  316. *Release Date - 3 November 2020*
  317. * Fix - Fixed bug causing Revision meta to incorrectly update the parent Post meta.
  318. * Fix - Fixed bug breaking "Filter by Post Type" and "Filter by Taxonomy" Field settings.
  319. = 5.9.2 =
  320. *Release Date - 29 October 2020*
  321. * Enhancement - Added experiment for preloading block HTML and reducing AJAX requests on page load.
  322. * Fix - Added boolean attribute value detection to JSX parser (fixes issue with templateLock="false").
  323. * Fix - Added "dateTime" attribute to JSX parser ruleset.
  324. * Fix - Fixed unresponsive Select2 instances after duplicating a row or layout.
  325. * Fix - Added missing Color Picker script translations for previous WordPress versions.
  326. * Fix - Fixed bug in Clone Field causing potential PHP error if cloning a Field Group that no longer exists.
  327. * Fix - Fixed PHP warning logged when comparing a revision that contains values for a Field that no longer exist.
  328. * Dev - Added `$wp_block` parameter to block render_callback and render_template (unavailable during AJAX preview requests).
  329. * Dev - Deprecated `acf_get_term_post_id()` function.
  330. = 5.9.1 =
  331. *Release Date - 8 September 2020*
  332. * Fix - Fixed guten-bug causing "Preview Post" button to publish changes.
  333. * Fix - Fixed guten-bug causing JS errors when editing with Elementor or Beaver Builder.
  334. * Fix - Fixed bug in Color Picker field causing JS error on front-end forms.
  335. * Fix - Fixed bug in Post Taxonomy location rule causing incomplete list of rule choices.
  336. * Fix - Reverted Local JSON "save to source path" enhancement due to DX feedback.
  337. * i18n - Updated Indonesian translations thanks to Rio Bahtiar.
  338. * i18n - Updated Turkish translation thanks to Emre Erkan.
  339. = 5.9.0 =
  340. *Release Date - 17 August 2020*
  341. * Enhancement - New Field Groups admin.
  342. * Added toolbar across all ACF admin pages.
  343. * Added new table columns: Description, Key, Location, Local JSON.
  344. * Added popup modal to review Local JSON changes before sync.
  345. * Added visual representation of where Field Groups will appear.
  346. * Added new help tab.
  347. * Simplified layout.
  348. * Enhancement - New ACF Blocks features.
  349. * Added support for Inner Blocks.
  350. * Added new "jsx" setting.
  351. * Added new "align_text" settings.
  352. * Added new "align_content" settings.
  353. * Enhancement - Added duplicate functionality for Repeater and Flexible Content fields.
  354. * Enhancement - Added PHP validation support for Gutenberg.
  355. * Enhancement - Added ability to bypass confirmation tooltips (just hold shift).
  356. * Enhancement - Local JSON files now save back to their loaded source path (not "save_json" setting).
  357. * Tweak - Replaced all custom icons with dashicons.
  358. * Tweak - Changed custom post status label from "Inactive" to "Disabled".
  359. * Tweak - Improved styling of metaboxes positioned in the block editor sidebar.
  360. * Fix - Improved AJAX request efficiency when editing block className or anchor attributes.
  361. * Fix - Fixed bug causing unresponsive WYSIWYG fields after moving a block via the up/down arrows.
  362. * Fix - Fixed bug causing HTML to jump between multiple instances of the same Reusable Block.
  363. * Fix - Fixed bug sometimes displaying validation errors when saving a draft.
  364. * Fix - Fixed bug breaking Image field UI when displaying a scaled portrait attachment.
  365. * Fix - Fixed bug in Link field incorrectly treating the "Cancel" button as "Submit".
  366. * Fix - Fixed bug where a sub field within a collapsed Repeater row did not grow to the full available width.
  367. * Fix - Ensured all archive URLs shown in the Page Link field dropdown are unique.
  368. * Fix - Fixed bug causing incorrect conditional logic settings on nested fields when duplicating a Field Group.
  369. * Fix - Fixed bug causing license activation issues with some password management browser extensions.
  370. * Dev - Major improvements to `ACF_Location` class.
  371. * Dev - Refactored all location classes to optimize performance.
  372. * Dev - Extracted core JavaScript from "acf-input.js" into a separate "acf.js" file.
  373. * Dev - Field Group export now shows "active" attribute as bool instead of int.
  374. * Dev - Added filter "acf/get_object_type" to customize WP object information such as "label" and "icon".
  375. * Dev - Added action "acf/admin_print_uploader_scripts" fired when printing uploader (WP media) scripts in the footer.
  376. * Dev - Added filters "acf/pre_load_attachment" and "acf/load_attachment" to customize attachment details.
  377. * Dev - Added filter "acf/admin/toolbar" to customize the admin toolbar items.
  378. * Dev - Added new JS actions "duplicate_fields" and "duplicate_field" fired when duplicating a row.
  379. * i18n - Changed Croatian locale code from "hr_HR to "hr".
  380. * i18n - Updated Portuguese translation thanks to Pedro Mendonça.
  381. * i18n - Updated French Canadian translation thanks to Bérenger Zyla.
  382. * i18n - Updated French translation thanks to Maxime Bernard-Jacquet.
  383. * i18n - Updated German translations thanks to Ralf Koller.
  384. = 5.8.14 =
  385. *Release Date - 13 August 2020*
  386. * Fix - Fixed bug breaking ACF Block `$is_preview` parameter in WordPress 5.5.
  387. * Fix - Fixed bug breaking seamless postbox style in WordPress 5.5.
  388. = 5.8.13 =
  389. *Release Date - 10 August 2020*
  390. * Tweak - Added styling compatibility for WordPress 5.5.
  391. * Fix - Implemented new `wp_filter_content_tags()` function in "acf_the_content" filter.
  392. * i18n - Updated Arabic translation thanks to Karim Ramadan.
  393. = 5.8.12 =
  394. *Release Date - 10 June 2020*
  395. * Fix - Improved string escaping in Select2 drop-downs to address XSS concerns.
  396. * Fix - Fixed bug causing PHP error when updating the settings of a Checkbox field.
  397. * Fix - Fixed bug causing WYSIWYG field to hide when toggling between Document and Block tabs within the Block editor.
  398. * Fix - Fixed bug incorrectly validating the length of Text and Textarea field values that contained HTML entities.
  399. = 5.8.11 =
  400. *Release Date - 12 May 2020*
  401. * Fix - Fixed bug in ACF Blocks where "inserter examples" and "block templates" did not load the defined "data".
  402. * Fix - Reverted "fix" in 5.8.9 regarding Taxonomy fields saving terms to non "post" objects.
  403. * Fix - Fixed bug allowing the Image field to save the value of a deleted attachment.
  404. * Fix - Improved Select field `format_value()` behaviour to correctly cast value types depending on the "multiple" setting.
  405. * Tweak - Changed language fallback for "zh_HK" to "zh_TW".
  406. * Tweak - Changed Time Picker field settings to display in a localized format via `date_i18n()`.
  407. * Tweak - Improved CSS styling of menu item fields.
  408. * i18n - Updated Finnish translation thanks to Mikko Kekki
  409. * i18n - Updated French translation thanks to Maxime Bernard-Jacquet.
  410. * i18n - Updated Turkish translation thanks to Emre Erkan.
  411. = 5.8.10 =
  412. *Release Date - 12 May 2020*
  413. * See hotfix version 5.8.11 for release notes.
  414. = 5.8.9 =
  415. *Release Date - 26 March 2020*
  416. * Fix - Fixed bug in ACF Blocks causing default "align" property to be ignored.
  417. * Fix - Fixed bug allowing Taxonomy field to save terms to a non "post" object.
  418. * Tweak - Improved User field AJAX query performance.
  419. * Tweak - Improved logic that determines width of Range field input.
  420. * Tweak - Improved styling of ACF Blocks components.
  421. * Dev - Added new "acf/register_block_type_args" filter.
  422. * Dev - Added new generic ACF_Ajax_Query and ACF_Ajax_Query_Users classes.
  423. * i18n - Updated French Canadian translation thanks to Bérenger Zyla.
  424. * i18n - Updated Traditional Chinese translation thanks to Audi Lu.
  425. * i18n - Updated German translation thanks to Ralf Koller.
  426. * i18n - Updated Portuguese translation thanks to Pedro Mendonça.
  427. = 5.8.8 =
  428. *Release Date - 4 March 2020*
  429. * Fix - Fixed bug in `have_rows()` function causing a PHP warning when no value is found.
  430. * Fix - Fixed bug in Google Maps field causing marker to snap to nearest address.
  431. * Fix - Avoid Nav Menu items displaying twice in WordPress 5.4.
  432. * Tweak - Added place name data to Google Maps field value.
  433. * Tweak - Improved performance of PHP registered fields.
  434. * Dev - Added new "acf/prepare_field_group_for_import" filter.
  435. * i18n - Added Traditional Chinese translation thanks to Audi Lu.
  436. * i18n - Added Catalan translation thanks to Jordi Tarrida.
  437. * i18n - Updated French translation thanks to Maxime Bernard-Jacquet & Bérenger Zyla.
  438. = 5.8.7 =
  439. *Release Date - 12 November 2019*
  440. * New - Updated admin CSS for new WordPress 5.3 styling.
  441. * Fix - Fixed various issues affecting dynamic metaboxes in the block editor (requires WordPress 5.3)
  442. * Fix - Fixed performance issue when checking network sites for upgrades.
  443. * Fix - Fixed Select2 clones appearing after duplicating a Relationship field.
  444. * Tweak - Repeater field "Add row" icons will now hide when maximum rows are reached.
  445. * Tweak - Removed ACF Blocks keyword limit for later versions of Gutenberg.
  446. = 5.8.6 =
  447. *Release Date - 24 October 2019*
  448. * New - Added more data to Google Maps field value including place_id, street_name, country and more.
  449. * Fix - Fixed bug in Gallery field incorrectly displaying .pdf attachments as icons.
  450. * Fix - Fixed bug in Checkbox field missing "selected" class after "Toggle All".
  451. * Dev - Added compatibility for Attachments in the Post Taxonomy location rule.
  452. * Dev - Added missing return statement from `acf_get_form()` function.
  453. * Dev - Added "google_map_result" JS filter.
  454. = 5.8.5 =
  455. *Release Date - 8 October 2019*
  456. * New - Added new choice "Add" to the User Form location rule.
  457. * New - Optimized `acf_form()` logic when used in combination with `acf_register_form()`.
  458. * Fix - Fixed bug causing incorrect field order after sync.
  459. * Fix - Fixed bug reverting the first field type to Text in Firefox version 69.0.1.
  460. * Fix - Fixed bug causing tinymce issues when changing between block modes.
  461. * Fix - Fixed bug preventing block registration when category does not exist.
  462. * Fix - Fixed bug preventing block registration when no icon is declared.
  463. * Dev - Added RegExp compatibility for innerBlocks.
  464. = 5.8.4 =
  465. *Release Date - 3 September 2019*
  466. * New - Optimized Relationship field by delaying AJAX call until UI is visible.
  467. * Fix - Fixed bug incorrectly escaping HTML in the Link field title.
  468. * Fix - Fixed bug showing Discussion and Comment metaboxes for newly imported field groups.
  469. * Fix - Fixed PHP warning when loading meta from Post 0.
  470. * Dev - Ensure Checkbox field value is an array even when empty.
  471. * Dev - Added new `ACF_MAJOR_VERSION` constant.
  472. = 5.8.3 =
  473. *Release Date - 7 August 2019*
  474. * Tweak - Changed Options Page location rules to show "page_title" instead of "menu_title".
  475. * Fix - Fixed bug causing Textarea field to incorrectly validate maxlength.
  476. * Fix - Fixed bug allowing Range field values outside of the min and max settings.
  477. * Fix - Fixed bug in block RegExp causing some blocks to miss the "acf/pre_save_block" filter.
  478. * Dev - Added `$block_type` parameter to block settings "enqueue_assets" callback.
  479. * i18n - Added French Canadian language thanks to Bérenger Zyla.
  480. * i18n - Updated French language thanks to Bérenger Zyla.
  481. = 5.8.2 =
  482. *Release Date - 15 July 2019*
  483. * Fix - Fixed bug where validation did not prevent new user registration.
  484. * Fix - Fixed bug causing some "reordered" metaboxes to not appear in the Gutenberg editor.
  485. * Fix - Fixed bug causing WYSIWYG field with delayed initialization to appear blank.
  486. * Fix - Fixed bug when editing a post and adding a new tag did not refresh metaboxes.
  487. * Dev - Added missing `$value` parameter in "acf/pre_format_value" filter.
  488. = 5.8.1 =
  489. *Release Date - 3 June 2019*
  490. * New - Added "Preview Size" and "Return Format" settings to the Gallery field.
  491. * Tweak - Improved metabox styling for Gutenberg.
  492. * Tweak - Changed default "Preview Size" to medium for the Image field.
  493. * Fix - Fixed bug in media modal causing the primary button text to disappear after editing an image.
  494. * Fix - Fixed bug preventing the TinyMCE Advanced plugin from adding `< p >` tags.
  495. * Fix - Fixed bug where HTML choices were not visible in conditional logic dropdown.
  496. * Fix - Fixed bug causing incorrect order of imported/synced flexible content sub fields.
  497. * i18n - Updated German translation thanks to Ralf Koller.
  498. * i18n - Updated Persian translation thanks to Majix.
  499. = 5.8.0 =
  500. *Release Date - 8 May 2019*
  501. * New - Added ACF Blocks feature for ACF PRO.
  502. * Fix - Fixed bug causing duplicate "save metabox" AJAX requests in the Gutenberg editor.
  503. * Fix - Fixed bug causing incorrect Repeater field value order in AJAX requests.
  504. * Dev - Added JS filter `'relationship_ajax_data'` to customize Relationship field AJAX data.
  505. * Dev - Added `$field_group` parameter to `'acf/location/match_rule'` filter.
  506. * Dev - Bumped minimum supported PHP version to 5.4.0.
  507. * Dev - Bumped minimum supported WP version to 4.7.0.
  508. * i18n - Updated German translation thanks to Ralf Koller.
  509. * i18n - Updated Portuguese language thanks to Pedro Mendonça.
  510. = 5.7.13 =
  511. *Release Date - 6 March 2019*
  512. * Fix - Fixed bug causing issues with registered fields during `switch_to_blog()`.
  513. * Fix - Fixed bug preventing sub fields from being reused across multiple parents.
  514. * Fix - Fixed bug causing the `get_sub_field()` function to fail if a tab field exists with the same name as the selected field.
  515. * Fix - Fixed bug corrupting field settings since WP 5.1 when instructions contain `< a target="" >`.
  516. * Fix - Fixed bug in Gutenberg where custom metabox location (acf_after_title) did not show on initial page load.
  517. * Fix - Fixed bug causing issues when importing/syncing multiple field groups which contain a clone field.
  518. * Fix - Fixed bug preventing the AMP plugin preview from working.
  519. * Dev - Added new 'pre' filters to get, update and delete meta functions.
  520. * i18n - Update Turkish translation thanks to Emre Erkan.
  521. = 5.7.12 =
  522. *Release Date - 15 February 2019*
  523. * Fix - Added missing function `register_field_group()`.
  524. * Fix - Fixed PHP 5.4 error "Can't use function return value in write context".
  525. * Fix - Fixed bug causing wp_options values to be slashed incorrectly.
  526. * Fix - Fixed bug where "sync" feature imported field groups without fields.
  527. * Fix - Fixed bug preventing `get_field_object()` working with a field key.
  528. * Fix - Fixed bug causing incorrect results in `get_sub_field()`.
  529. * Fix - Fixed bug causing draft and preview issues with serialized values.
  530. * Fix - Fixed bug causing reversed field group metabox order.
  531. * Fix - Fixed bug causing incorrect character count when validating values.
  532. * Fix - Fixed bug showing incorrect choices for post_template location rule.
  533. * Fix - Fixed bug causing incorrect value retrieval after `switch_to_blog()`.
  534. * i18n - Updated Persian translation thanks to Majix.
  535. = 5.7.11 =
  536. *Release Date - 11 February 2019*
  537. * New - Added support for persistent object caching.
  538. * Fix - Fixed PHP error in `determine_locale()` affecting AJAX requests.
  539. * Fix - Fixed bug affecting dynamic metabox check when selecting "default" page template.
  540. * Fix - Fixed bug where tab fields did not render correctly within a dynamic metabox.
  541. * Tweak - Removed language fallback from "zh_TW" to "zh_CN".
  542. * Dev - Refactored various core functions.
  543. * Dev - Added new hook variation functions `acf_add_filter_variations()` and `acf_add_action_variations()`.
  544. * i18n - Updated Portuguese language thanks to Pedro Mendonça.
  545. * i18n - Updated German translation thanks to Ralf Koller.
  546. * i18n - Updated Swiss German translation thanks to Raphael Hüni.
  547. = 5.7.10 =
  548. *Release Date - 16 January 2019*
  549. * Fix - Fixed bug preventing metaboxes from saving if validation fails within Gutenberg.
  550. * Fix - Fixed bug causing unload prompt to show incorrectly within Gutenberg.
  551. * Fix - Fixed JS error when selecting taxonomy terms within Gutenberg.
  552. * Fix - Fixed bug causing jQuery sortable issues within other plugins.
  553. * Tweak - Improved loading translations by adding fallback from region to country when .mo file does not exit.
  554. * Tweak - Improved punctuation throughout admin notices.
  555. * Tweak - Improved performance and accuracy when loading a user field value.
  556. * Dev - Added filter 'acf/get_locale' to customize the locale used to load translations.
  557. * Dev - Added filter 'acf/allow_unfiltered_html' to customize if current user can save unfiltered HTML.
  558. * Dev - Added new data storage functions `acf_register_store()` and `acf_get_store()`.
  559. * Dev - Moved from .less to .scss and minified all css.
  560. * i18n - Updated French translation thanks to Maxime Bernard-Jacquet.
  561. * i18n - Updated Czech translation thanks to David Rychly.
  562. = 5.7.9 =
  563. *Release Date - 17 December 2018*
  564. * Fix - Added custom metabox location (acf_after_title) compatibility with Gutenberg.
  565. * Fix - Added dynamic metabox check compatibility with Gutenberg.
  566. * Fix - Fixed bug causing required date picker fields to prevent form submit.
  567. * Fix - Fixed bug preventing multi-input values from saving correctly within media modals.
  568. * Fix - Fixed bug where `acf_form()` redirects to an incorrect URL for sub-sites.
  569. * Fix - Fixed bug where breaking out of a sub `have_rows()` loop could produce undesired results.
  570. * Dev - Added filter 'acf/connect_attachment_to_post' to prevent connecting attachments to posts.
  571. * Dev - Added JS filter 'google_map_autocomplete_args' to customize Google Maps autocomplete settings.
  572. = 5.7.8 =
  573. *Release Date - 7 December 2018*
  574. * Fix - Fixed vulnerability allowing author role to save unfiltered HTML values.
  575. * Fix - Fixed all metaboxes appearing when editing a post in WP 5.0.
  576. * i18n - Updated Polish translation thanks to Dariusz Zielonka.
  577. * i18n - Updated Czech translation thanks to Veronika Hanzlíková.
  578. * i18n - Update Turkish translation thanks to Emre Erkan.
  579. * i18n - Updated Portuguese language thanks to Pedro Mendonça.
  580. = 5.7.7 =
  581. *Release Date - 1 October 2018*
  582. * Fix - Fixed various plugin update issues.
  583. * Tweak - Added 'language' to Google Maps API url.
  584. * Dev - Major improvements to the `acf.models.Postbox` model.
  585. * Dev - Added JS filter 'check_screen_args'.
  586. * Dev - Added JS action 'check_screen_complete'.
  587. * Dev - Added action 'acf/options_page/submitbox_before_major_actions'.
  588. * Dev - Added action 'acf/options_page/submitbox_major_actions'.
  589. * i18n - Updated Portuguese language thanks to Pedro Mendonça
  590. = 5.7.6 =
  591. *Release Date - 12 September 2018*
  592. * Fix - Fixed unload prompt not working.
  593. * Dev - Reduced number of queries needed to populate the relationship field taxonomy filter.
  594. * Dev - Added 'nav_menu_item_id' and 'nav_menu_item_depth' to get_field_groups() query.
  595. * Dev - Reordered various actions and filters for more usefulness.
  596. * i18n - Updated Polish language thanks to Dariusz Zielonka
  597. [View the full changelog](https://www.advancedcustomfields.com/changelog/)
  598. == Upgrade Notice ==