Changeset 58717

Timestamp:

07/15/2024 01:57:22 AM (3 months ago)

Author:

SergeyBiryukov

Message:

Docs: Correct documentation for _wp_preview_meta_filter().

The $single parameter is passed via the get_post_metadata filter and has no default value.

Includes minor code layout fixes for consistency with the formatting of other long conditionals in core.

Follow-up to [56714].

Props rodrigosprimo.
Fixes #61645.

File:

• trunk/src/wp-includes/revision.php (modified) (3 diffs)

trunk/src/wp-includes/revision.php

@@ -1108 +1108 @@
  * @param int    $object_id Object ID.
  * @param string $meta_key  Meta key to filter a value for.
- * @param bool   $single    Whether to return a single value. Default false.
+ * @param bool   $single    Whether to return a single value.
  * @return mixed Original meta value if the meta key isn't revisioned, the object doesn't exist,
  *               the post type is a revision or the post ID doesn't match the object ID.
@@ -1114 +1114 @@
  */
 function _wp_preview_meta_filter( $value, $object_id, $meta_key, $single ) {
-
     $post = get_post();
-    if (
-        empty( $post ) ||
-        $post->ID !== $object_id ||
-        ! in_array( $meta_key, wp_post_revision_meta_keys( $post->post_type ), true ) ||
-        'revision' === $post->post_type
+
+    if ( empty( $post )
+        || $post->ID !== $object_id
+        || ! in_array( $meta_key, wp_post_revision_meta_keys( $post->post_type ), true )
+        || 'revision' === $post->post_type
     ) {
         return $value;
@@ -1126 +1125 @@
 
     $preview = wp_get_post_autosave( $post->ID );
+
     if ( false === $preview ) {
         return $value;