Ticket #39062: 39062.1.diff

src/wp-includes/revision.php

@@ -516 +516 @@
         return $revisions;
 }
 
+/**
+ * Returns the url for viewing and potentially restoring revisions of a given post.
+ *
+ * @since 5.9.0
+ *
+ * @param int $post_id The Post ID that you'd like to get a revision for. If omitted, will use the global post.
+ * @return null|string The URL for editing revisions on the given post. Returns null if none found.
+ */
+function wp_get_post_revisions_url( $post_id = 0 ) {
+        $post = get_post( $post_id );
+
+        if ( ! $post instanceof WP_Post ) {
+                return null;
+        }
+
+        // If the post is a revision, return early.
+        if ( 'revision' === $post->post_type ) {
+                return get_edit_post_link( $post );
+        }
+
+        if ( ! wp_revisions_enabled( $post ) ) {
+                return null;
+        }
+
+        $revisions = wp_get_post_revisions( $post->ID, array( 'posts_per_page' => 1 ) );
+
+        if ( 0 === sizeof( $revisions ) ) {
+                return null;
+        }
+
+        $revision = reset( $revisions );
+        return get_edit_post_link( $revision );
+}
+
 /**
  * Determine if revisions are enabled for a given post.
  *

tests/phpunit/tests/post/revisions.php

@@ -654 +654 @@
 
                 $this->assertWPError( $revision );
         }
+
+        /**
+         * Verifies that trying to create a revision with an invalid ID returns a WP_Error.
+         *
+         * @ticket 39062
+         */
+        public function test_wp_get_post_revisions_url() {
+                $u = self::factory()->user->create( array(
+                        'role' => 'administrator',
+                ) );
+                wp_set_current_user( $u );
+
+                $post = self::factory()->post->create_and_get( array(
+                        'post_title' => 'Some Post',
+                ) );
+
+                wp_update_post( array(
+                        'ID' => $post->ID,
+                        'post_title' => 'Some Post 2',
+                ) );
+
+                $latest_revision_id = key( wp_get_post_revisions( $post, array( 'posts_per_page' => 1 ) ) );
+                $this->assertEquals( admin_url( 'revision.php?revision=' . $latest_revision_id ), wp_get_post_revisions_url( $post ) );
+
+                wp_update_post( array(
+                        'ID' => $post->ID,
+                        'post_title' => 'Some Post 3',
+                ) );
+
+                $latest_revision_id = key( wp_get_post_revisions( $post, array( 'posts_per_page' => 1 ) ) );
+                $this->assertEquals( admin_url( 'revision.php?revision=' . $latest_revision_id ), wp_get_post_revisions_url( $post ) );
+                $this->assertEquals( admin_url( 'revision.php?revision=' . $latest_revision_id ), wp_get_post_revisions_url( $latest_revision_id ) );
+        }
 }