Changeset 34170 for trunk/src/wp-includes/link-template.php

Timestamp:

09/15/2015 04:14:23 AM (9 years ago)

Author:

wonderboymusic

Message:

Create a function, get_preview_post_link(), to DRY the logic for applying the 'preview_post_link' filter to a URL.

Props TomHarrigan, wonderboymusic.
Fixes #24345.

File:

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

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

@@ -1160 +1160 @@
 
 /**
+ * Retrieve preview post link.
+ *
+ * Get the preview post URL. Allow any number of query args to be appended.
+ *
+ * @since 4.4.0
+ *
+ * @param int    $post         Optional. Post ID or WP_Post object. Defaults to global post.
+ * @param array  $query_args   Optional. If preview query arg should be added. Or array of query args to be added.
+ * @param string $preview_link Optional. If a link other than the permalink should be used. Used by _wp_link_page.
+ * @return string
+ */
+function get_preview_post_link( $post = null, $query_args = array(), $preview_link = '' ) {
+    $post = get_post( $post );
+    if ( ! $post ) {
+        return;
+    }
+
+    $post_type_object = get_post_type_object( $post->post_type );
+    if ( is_post_type_viewable( $post_type_object ) ) {
+        if ( ! $preview_link ) {
+            $preview_link = get_permalink( $post );
+        }
+
+        $query_args['preview'] = true;
+        $preview_link = add_query_arg( $query_args, $preview_link );
+    }
+
+    /**
+     * Filter the URI of a post preview in the post submit box.
+     *
+     * @since 2.0.5
+     * @since 4.4.0 $post parameter was added.
+     *
+     * @param string  $preview_link URI the user will be directed to for a post preview.
+     * @param WP_Post $post         Post object.
+     */
+    return apply_filters( 'preview_post_link', $preview_link, $post );
+}
+
+/**
  * Retrieve edit posts link for post.
  *