Ticket #19652: 19652-patch.diff

wp-includes/link-template.php

@@ -1310 +1310 @@
  * @param array|string $excluded_categories Optional. Array or comma-separated list of excluded category IDs.
  */
 function previous_post_link($format='« %link', $link='%title', $in_same_cat = false, $excluded_categories = '') {
-        adjacent_post_link($format, $link, $in_same_cat, $excluded_categories, true);
+        echo get_previous_post_link( $format, $link, $in_same_cat, $excluded_categories );
 }
 
 /**
+ * needs-docs if accepted...
+ */
+function get_previous_post_link($format='« %link', $link='%title', $in_same_cat = false, $excluded_categories = '') {
+        return adjacent_post_link( $format, $link, $in_same_cat, $excluded_categories, true, true );
+}
+
+/**
  * Display next post link that is adjacent to the current post.
  *
  * @since 1.5.0
@@ -1324 +1331 @@
  * @param array|string $excluded_categories Optional. Array or comma-separated list of excluded category IDs.
  */
 function next_post_link($format='%link »', $link='%title', $in_same_cat = false, $excluded_categories = '') {
-        adjacent_post_link($format, $link, $in_same_cat, $excluded_categories, false);
+        echo get_next_post_link( $format, $link, $in_same_cat, $excluded_categories );
 }
 
 /**
+ * needs-docs if accepted...
+ */
+function get_next_post_link($format='%link »', $link='%title', $in_same_cat = false, $excluded_categories = '') {
+        return adjacent_post_link( $format, $link, $in_same_cat, $excluded_categories, false, true );
+}
+
+/**
  * Display adjacent post link.
  *
  * Can be either next post link or previous.
@@ -1339 +1353 @@
  * @param bool $in_same_cat Optional. Whether link should be in a same category.
  * @param array|string $excluded_categories Optional. Array or comma-separated list of excluded category IDs.
  * @param bool $previous Optional, default is true. Whether to display link to previous or next post.
+ * @param bool $return Optional, default is false. Whether to return the link or echo it.
  */
-function adjacent_post_link($format, $link, $in_same_cat = false, $excluded_categories = '', $previous = true) {
+function adjacent_post_link($format, $link, $in_same_cat = false, $excluded_categories = '', $previous = true, $return = false) {
         if ( $previous && is_attachment() )
                 $post = & get_post($GLOBALS['post']->post_parent);
         else
@@ -1366 +1381 @@
         $format = str_replace('%link', $link, $format);
 
         $adjacent = $previous ? 'previous' : 'next';
-        echo apply_filters( "{$adjacent}_post_link", $format, $link );
+        
+        if ( $return )
+                return apply_filters( "{$adjacent}_post_link", $format, $link );
+        else
+                echo apply_filters( "{$adjacent}_post_link", $format, $link );
 }
 
 /**