Prepare 6.8.5 Release

docs/bin/manifest.json

@@ -134,6 +134,11 @@
         "parent": "code-reference",
         "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/code-reference/compatibility-file.md"
     },
+    "code-reference/datastore-file": {
+        "slug": "datastore-file",
+        "parent": "code-reference",
+        "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/code-reference/datastore-file.md"
+    },
     "code-reference/deprecated-file": {
         "slug": "deprecated-file",
         "parent": "code-reference",

docs/code-reference/META.md

@@ -10,6 +10,17 @@ This file tracks code elements that need documentation.
 - `acf/bindings/field_not_supported_message`
 - `acf/blocks/binding_value`
 
+## Datastore/Localization.php
+
+### Hooks
+
+- `acf/prepare_field`
+- `acf/prepare_field`
+- `acf/prepare_field`
+- `acf/prepare_field`
+- `acf/prepare_field`
+- `acf/prepare_field`
+
 ## abilities/class-scf-field-abilities.php
 
 ### Hooks
@@ -279,6 +290,12 @@ This file tracks code elements that need documentation.
 
 - `acf/admin/toolbar`
 
+## ajax/class-acf-ajax-check-screen.php
+
+### Hooks
+
+- `acf/ajax/check_screen/response`
+
 ## ajax/class-acf-ajax-query-users.php
 
 ### Hooks
@@ -412,6 +429,12 @@ This file tracks code elements that need documentation.
 - `acf/field_group/disable_field_settings_tabs`
 - `acf/field_group/enable_field_browser`
 
+## datastore.php
+
+### Hooks
+
+- `acf/settings/enable_datastore`
+
 ## fields.php
 
 ### Hooks
@@ -547,6 +570,7 @@ This file tracks code elements that need documentation.
 
 ### Hooks
 
+- `acf/form-post/skip_save`
 - `acf/input/meta_box_priority`
 
 ## l10n.php
@@ -654,6 +678,13 @@ This file tracks code elements that need documentation.
 
 - `initialize`
 
+## revisions.php
+
+### Hooks
+
+- `acf/revisions/skip_legacy_metabox_handling`
+- `acf/revisions/skip_legacy_metabox_handling`
+
 ## upgrades.php
 
 ### Hooks

docs/code-reference/blocks-file.md

@@ -25,6 +25,30 @@ Check if a block.json block is an SCF block.
 * @param array $metadata The raw block metadata array.
 * @return boolean
 
+## `acf_block_json_process_fields()`
+
+Recursively ensures every field in a set of block-inlined fields has a key,
+generating `field_{block_slug}_{parent_path}_{name}` for any that don't.
+
+* @since ACF 6.8.1
+* @param array  $fields      The fields to process.
+* @param string $block_slug  The sanitized block slug used to build keys.
+* @param string $block_name  The original block name (used for error messages).
+* @param string $parent_path Internal. Underscore-joined ancestor names for the current nesting level.
+* @return array The processed fields, with keys filled in and invalid entries removed.
+
+## `acf_register_block_field_group_from_fields()`
+
+Registers a local field group for a block from an inline fields array,
+as used by `acf.fields` in block.json and `fields` in acf_register_block_type().
+
+* @since ACF 6.8.1
+* @param string $block_name        The full block name (e.g. 'acf/my-block').
+* @param string $block_title       The block's display title, used in the default group title.
+* @param array  $fields            The fields defined inline on the block.
+* @param string $field_group_title Optional. Overrides the auto-generated "Block: {title}" group title.
+* @return boolean True if the field group was registered, false otherwise.
+
 ## `acf_register_block_type()`
 
 Registers a block type.

docs/code-reference/datastore-file.md

@@ -0,0 +1,12 @@
+# Datastore Global Functions
+
+## `acf_is_using_datastore()`
+
+Whether the SCF datastore is enabled.
+
+* The datastore requires WordPress 6.7+ and can be enabled via the
+`acf/settings/enable_datastore` filter.
+* @since ACF 6.8.1
+* @return boolean
+
+---

docs/code-reference/index.md

@@ -21,6 +21,7 @@
 - [Assets](assets-file)
 - [Blocks](blocks-file)
 - [Compatibility](compatibility-file)
+- [Datastore](datastore-file)
 - [Deprecated](deprecated-file)
 - [Fields](fields-file)
 - [L10n](l10n-file)