Changeset 61057 for trunk/src/wp-includes/author-template.php

Timestamp:

10/24/2025 04:02:03 AM (6 weeks ago)

Author:

westonruter

Message:

Posts, Post Types: Update get_the_modified_author() to handle missing global $post and add (missing) $post arg.

The addition of the $post argument (which defaults to the global post) brings get_the_modified_author() in line with other similar functions, including get_the_modified_date() and get_the_modified_time().

Props Cornwell, jdahir0789, dhruvang21, Presskopp, mindctrl, samirmalpande, audrasjb, johnbillion, SergeyBiryukov, desrosj, costdev, mukesh27, westonruter.
Fixes #64104, #55978.

File:

• trunk/src/wp-includes/author-template.php (modified) (1 diff)

trunk/src/wp-includes/author-template.php

@@ -87 +87 @@
  *
  * @since 2.8.0
- *
- * @return string|void The author's display name, empty string if unknown.
- */
-function get_the_modified_author() {
-    $last_id = get_post_meta( get_post()->ID, '_edit_last', true );
-
-    if ( $last_id ) {
-        $last_user = get_userdata( $last_id );
-
-        /**
-         * Filters the display name of the author who last edited the current post.
-         *
-         * @since 2.8.0
-         *
-         * @param string $display_name The author's display name, empty string if unknown.
-         */
-        return apply_filters( 'the_modified_author', $last_user ? $last_user->display_name : '' );
-    }
+ * @since 6.9.0 Added the `$post` parameter. Unknown return value is now explicitly null instead of void.
+ *
+ * @param int|WP_Post|null $post Optional. Post ID or post object. Default is global `$post` object.
+ * @return string|null The author's display name. Empty string if user is unavailable. Null if there was no last editor or the post is invalid.
+ */
+function get_the_modified_author( $post = null ) {
+    $post = get_post( $post );
+    if ( ! $post ) {
+        return null;
+    }
+
+    $last_id = get_post_meta( $post->ID, '_edit_last', true );
+    if ( ! $last_id ) {
+        return null;
+    }
+    $last_user = get_userdata( $last_id );
+
+    /**
+     * Filters the display name of the author who last edited the current post.
+     *
+     * @since 2.8.0
+     *
+     * @param string $display_name The author's display name, empty string if user is unavailable.
+     */
+    return apply_filters( 'the_modified_author', $last_user ? $last_user->display_name : '' );
 }