Ticket #39062: 39062.diff

src/wp-includes/revision.php

@@ -457 +457 @@
 }
 
 /**
+ * Get the url for viewing and potentially restoring revisions of a given post.
+ *
+ * @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 we were passed in 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.
  *
  * @since 3.6.0

tests/phpunit/tests/post/revisions.php

@@ -382 +382 @@
 
                 $this->assertEquals( $revision_ids, array_values( wp_list_pluck( $revisions, 'ID' ) ) );
         }
+
+        /**
+         * Test fetching the revision urls of a given post.
+         */
+        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 ) );
+        }
 }