Changeset 48779 for branches/5.5/src/wp-includes/meta.php

Timestamp:

08/10/2020 03:52:01 PM (5 years ago)

Author:

SergeyBiryukov

Message:

Options, Meta APIs: Update the docs around default metadata values.

Add a missing @since value for 5.5 and potential default filter names.

Props johnbillion.
Reviewed by whyisjake, SergeyBiryukov.
Merges [48777] and [48778] to the 5.5 branch.
Fixes #50891.

Location:

branches/5.5

Files:

• . (modified) (1 prop)
• src/wp-includes/meta.php (modified) (4 diffs)

branches/5.5/src/wp-includes/meta.php

@@ -544 +544 @@
      * Returning a non-null value will effectively short-circuit the function.
      *
+     * Possible filter names include:
+     *
+     *  - `get_post_metadata`
+     *  - `get_comment_metadata`
+     *  - `get_term_metadata`
+     *  - `get_user_metadata`
+     *
      * @since 3.1.0
      * @since 5.5.0 Added the `$meta_type` parameter.
@@ -591 +598 @@
 
 /**
- * Retrieves default metadata value for the specified object.
+ * Retrieves default metadata value for the specified meta key and object.
  *
  * By default, an empty string is returned if `$single` is true, or an empty array
@@ -614 +621 @@
 
     /**
-     * Filter the default value for a specified object.
+     * Filters the default metadata value for a specified meta key and object.
      *
      * The dynamic portion of the hook, `$meta_type`, refers to the meta object type
      * (post, comment, term, user, or any other type with an associated meta table).
+     *
+     * Possible filter names include:
+     *
+     *  - `default_post_metadata`
+     *  - `default_comment_metadata`
+     *  - `default_term_metadata`
+     *  - `default_user_metadata`
      *
      * @since 5.5.0
@@ -1228 +1242 @@
  * @since 4.9.8 The `$object_subtype` argument was added to the arguments array.
  * @since 5.3.0 Valid meta types expanded to include "array" and "object".
+ * @since 5.5.0 The `$default` argument was added to the arguments array.
  *
  * @param string       $object_type Type of object metadata is for. Accepts 'post', 'comment', 'term', 'user',