Build assets, documentation, and translations

Author: kraftbj

composer.json

@@ -11,27 +11,27 @@
 	"require": {
 		"php": ">=7.4"
 	},
-	"autoload": {
-		"psr-4": {
-			"SCF\\Forms\\": "includes/forms/",
-			"SCF\\Meta\\": "includes/Meta/",
-			"ACF\\Blocks\\": "includes/Blocks/"
-		}
-	},
 	"require-dev": {
 		"automattic/wordbless": "^0.5.0",
 		"dealerdirect/phpcodesniffer-composer-installer": "^1.0",
 		"ergebnis/composer-normalize": "^2.45",
 		"nikic/php-parser": "^4.0",
+		"php-stubs/woocommerce-stubs": "^9.8",
 		"phpcompatibility/phpcompatibility-wp": "^2.1.3",
 		"phpstan/extension-installer": "^1.4",
 		"phpunit/phpunit": "^9.6",
 		"sirbrillig/phpcs-changed": "^2.11",
 		"symfony/finder": "^5.0 || ^6.0",
 		"szepeviktor/phpstan-wordpress": "^2.0",
 		"wp-coding-standards/wpcs": "^3.0",
-		"yoast/phpunit-polyfills": "^1.1.0",
-		"php-stubs/woocommerce-stubs": "^9.8"
+		"yoast/phpunit-polyfills": "^1.1.0"
+	},
+	"autoload": {
+		"psr-4": {
+			"ACF\\Blocks\\": "includes/Blocks/",
+			"SCF\\Forms\\": "includes/forms/",
+			"SCF\\Meta\\": "includes/Meta/"
+		}
 	},
 	"config": {
 		"allow-plugins": {

composer.lock

@@ -259,6 +259,11 @@
         "parent": "welcome",
         "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/welcome/quick-start.md"
     },
+    "code-reference/admin/admin-commands-file": {
+        "slug": "admin-commands-file",
+        "parent": "admin",
+        "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/code-reference/admin/admin-commands-file.md"
+    },
     "code-reference/admin/admin-notices-file": {
         "slug": "admin-notices-file",
         "parent": "admin",
@@ -269,6 +274,11 @@
         "parent": "admin",
         "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/code-reference/admin/admin-tools-file.md"
     },
+    "code-reference/admin/beta-features-file": {
+        "slug": "beta-features-file",
+        "parent": "admin",
+        "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/code-reference/admin/beta-features-file.md"
+    },
     "code-reference/api/api-helpers-file": {
         "slug": "api-helpers-file",
         "parent": "api",
@@ -314,6 +324,11 @@
         "parent": "rest-api",
         "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/code-reference/rest-api/class-acf-rest-request-file.md"
     },
+    "code-reference/rest-api/class-acf-rest-types-endpoint-file": {
+        "slug": "class-acf-rest-types-endpoint-file",
+        "parent": "rest-api",
+        "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/code-reference/rest-api/class-acf-rest-types-endpoint-file.md"
+    },
     "features/field/accordion": {
         "slug": "accordion",
         "parent": "field",
@@ -399,6 +414,11 @@
         "parent": "field",
         "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/features/field/message/index.md"
     },
+    "features/field/nav_menu": {
+        "slug": "nav_menu",
+        "parent": "field",
+        "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/features/field/nav_menu/index.md"
+    },
     "features/field/number": {
         "slug": "number",
         "parent": "field",
@@ -579,6 +599,11 @@
         "parent": "message",
         "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/features/field/message/tutorial.md"
     },
+    "features/field/nav_menu/tutorial": {
+        "slug": "nav_menu-tutorial",
+        "parent": "nav_menu",
+        "markdown_source": "https://github.com/wordpress/secure-custom-fields/blob/trunk/docs/features/field/nav_menu/tutorial.md"
+    },
     "features/field/number/tutorial": {
         "slug": "number-tutorial",
         "parent": "number",

docs/bin/manifest.json

@@ -75,8 +75,11 @@ This file tracks code elements that need documentation.
 
 - `acf/load_meta`
 - `acf/pre_delete_metadata`
+- `acf/pre_delete_metadata`
 - `acf/pre_load_meta`
 - `acf/pre_load_metadata`
+- `acf/pre_load_metadata`
+- `acf/pre_update_metadata`
 - `acf/pre_update_metadata`
 
 ## acf-user-functions.php
@@ -94,6 +97,7 @@ This file tracks code elements that need documentation.
 - `acf/load_reference`
 - `acf/load_value`
 - `acf/pre_format_value`
+- `acf/pre_load_metadata`
 - `acf/pre_load_reference`
 - `acf/pre_load_value`
 - `acf/pre_update_value`
@@ -135,6 +139,12 @@ This file tracks code elements that need documentation.
 - `acf/admin/prevent_escaped_html_notice`
 - `acf/in_admin_header`
 
+## admin/beta-features.php
+
+### Hooks
+
+- `scf/include_admin_beta_features`
+
 ## admin/class-acf-admin-options-page.php
 
 ### Hooks
@@ -324,6 +334,7 @@ This file tracks code elements that need documentation.
 - `acf/shortcode/allow_in_block_themes_outside_content`
 - `acf/shortcode/allow_unsafe_html`
 - `acf/shortcode/disabled_message`
+- `acf/shortcode/display_admin_errors`
 - `acf/shortcode/field_not_allowed_message`
 - `acf/shortcode/field_not_supported_message`
 - `acf/shortcode/post_not_public_message`
@@ -414,6 +425,12 @@ This file tracks code elements that need documentation.
 - `acf/fields/icon_picker/dashicons`
 - `acf/fields/icon_picker/tabs`
 
+## fields/class-acf-field-nav-menu.php
+
+### Hooks
+
+- `wp_nav_menu_container_allowed_tags`
+
 ## fields/class-acf-field-page_link.php
 
 ### Hooks
@@ -472,6 +489,12 @@ This file tracks code elements that need documentation.
 - `media_buttons`
 - `teeny_mce_buttons`
 
+## forms/WC_Order.php
+
+### Hooks
+
+- `acf/input/meta_box_priority`
+
 ## forms/form-front.php
 
 ### Functions

docs/code-reference/META.md

@@ -9,6 +9,7 @@ Process updating bidirectional fields.
 * @param integer|string $post_id         The ACF encoded origin post, user or term ID.
 * @param array          $field           The field being updated on the origin post, user or term ID.
 * @param string|false   $target_prefix   The ACF prefix for a post, user or term ID required for the update_field call for this field type.
+* @return void
 
 ## `acf_get_valid_bidirectional_target_types()`
 
@@ -41,6 +42,7 @@ Renders the field settings required for bidirectional fields
 
 * @since ACF 6.2
 * @param array $field The field object passed into field setting functions.
+* @return void
 
 ## `acf_get_bidirectional_field_settings_instruction_text()`
 

docs/code-reference/acf-bidirectional-functions-file.md

@@ -114,7 +114,7 @@ acf_set_filters
 * @date    14/7/16
 * @since ACF 5.4.0
 * @param   array $filters An Array of modifiers.
-* @return array
+* @return void
 
 ## `acf_disable_filters()`
 

docs/code-reference/acf-helper-functions-file.md

@@ -46,7 +46,7 @@ acf_hidden_input
 * @date    3/02/2014
 * @since ACF 5.0.0
 * @param   array $attrs The array of attrs.
-* @return string
+* @return void echos out value.
 
 ## `acf_get_hidden_input()`
 
@@ -66,7 +66,7 @@ acf_text_input
 * @date    3/02/2014
 * @since ACF 5.0.0
 * @param   array $attrs The array of attrs.
-* @return string
+* @return void echos out value.
 
 ## `acf_get_text_input()`
 
@@ -86,7 +86,7 @@ acf_file_input
 * @date    3/02/2014
 * @since ACF 5.0.0
 * @param   array $attrs The array of attrs.
-* @return string
+* @return void echos out value.
 
 ## `acf_get_file_input()`
 
@@ -106,7 +106,7 @@ acf_textarea_input
 * @date    3/02/2014
 * @since ACF 5.0.0
 * @param   array $attrs The array of attrs.
-* @return string
+* @return void echos out value.
 
 ## `acf_get_textarea_input()`
 
@@ -126,7 +126,7 @@ acf_checkbox_input
 * @date    3/02/2014
 * @since ACF 5.0.0
 * @param   array $attrs The array of attrs.
-* @return string
+* @return void echos out value.
 
 ## `acf_get_checkbox_input()`
 
@@ -146,7 +146,7 @@ acf_radio_input
 * @date    3/02/2014
 * @since ACF 5.0.0
 * @param   array $attrs The array of attrs.
-* @return string
+* @return void echos out value.
 
 ## `acf_get_radio_input()`
 
@@ -166,7 +166,7 @@ acf_select_input
 * @date    3/02/2014
 * @since ACF 5.0.0
 * @param   array $attrs The array of attrs.
-* @return string
+* @return void
 
 ## `acf_get_select_input()`
 

docs/code-reference/acf-input-functions-file.md

@@ -55,13 +55,11 @@ Deletes metadata from the database.
 
 ## `acf_copy_metadata()`
 
-acf_copy_postmeta
+Copies meta from one post to another. Useful for saving and restoring revisions.
 
-* Copies meta from one post to another. Useful for saving and restoring revisions.
-* @date    25/06/2016
 * @since ACF 5.3.8
-* @param   (int|string) $from_post_id The post id to copy from.
-* @param (int|string) $to_post_id   The post id to paste to.
+* @param integer|string $from_post_id The post id to copy from.
+* @param integer|string $to_post_id   The post id to paste to.
 * @return void
 
 ## `acf_copy_postmeta()`
@@ -112,4 +110,43 @@ acf_update_metaref
 * @param array                                          $references An array of references.
 * @return (int|bool) Meta ID if the key didn't exist, true on successful update, false on failure.
 
+## `acf_get_meta_instance()`
+
+Retrieves an ACF meta instance for the provided meta type.
+
+* @since 6.5
+* @param string $type The meta type as decoded from the post ID.
+* @return object|null
+
+## `acf_get_metadata_by_field()`
+
+Gets metadata from the database.
+
+* @since 6.5
+* @param integer|string $post_id The post id.
+* @param array          $field   The field array.
+* @param boolean        $hidden  True if we should return the reference key.
+* @return mixed
+
+## `acf_update_metadata_by_field()`
+
+Updates metadata in the database.
+
+* @since 6.5
+* @param integer|string $post_id The post id.
+* @param array          $field   The field array.
+* @param mixed          $value   The meta value.
+* @param boolean        $hidden  True if we should update the reference key.
+* @return integer|boolean Meta ID if the key didn't exist, true on successful update, false on failure.
+
+## `acf_delete_metadata_by_field()`
+
+Deletes metadata from the database.
+
+* @since 6.5
+* @param integer|string $post_id The post id.
+* @param array          $field   The field array.
+* @param boolean        $hidden  True if we should update the reference key.
+* @return boolean
+
 ---

docs/code-reference/acf-meta-functions-file.md

@@ -32,11 +32,9 @@ acf_get_user_role_labels
 
 ## `acf_allow_unfiltered_html()`
 
-acf_allow_unfiltered_html
+Returns true if the current user is allowed to save unfiltered HTML.
 
-* Returns true if the current user is allowed to save unfiltered HTML.
-* @date    9/1/19
-* @since ACF 5.7.10
+* @since   ACF 5.7.10
 * @return  boolean
 
 ---

docs/code-reference/acf-user-functions-file.md

@@ -0,0 +1,20 @@
+# Admin Commands Global Functions
+
+## `acf_commands_init()`
+
+Initializes SCF commands integration
+
+* This function handles the integration with WordPress Commands (Cmd+K / Ctrl+K),
+providing navigation commands for SCF admin pages and custom post types.
+* The implementation follows these principles:
+
+1. Only loads in screens where WordPress commands are available.
+2. Performs capability checks to ensure users only see commands they can access.
+3. Core administrative commands are only shown to users with SCF admin capabilities.
+4. Custom post type commands are conditionally shown based on edit_posts capability
+for each specific post type.
+5. Post types must have UI enabled (show_ui setting) to appear in commands.
+
+* @since SCF 6.5.0
+
+---