Ticket #8703: 8703.5.diff

wp-includes/default-filters.php

@@ -168 +168 @@
 add_action('wp_head', 'feed_links_extra', 3);
 add_action('wp_head', 'rsd_link');
 add_action('wp_head', 'wlwmanifest_link');
+add_action('wp_head', 'index_rel_link');
+add_action('wp_head', 'parent_post_rel_link', 10, 0);
+add_action('wp_head', 'start_post_rel_link', 10, 0);
+add_action('wp_head', 'adjacent_posts_rel_link', 10, 0);
 add_action('wp_head', 'locale_stylesheet');
 add_action('publish_future_post', 'check_and_publish_future_post', 10, 1);
 add_action('wp_head', 'noindex', 1);

wp-includes/link-template.php

@@ -909 +909 @@
 }
 
 /**
+ * Get adjacent post relational link.
+ *
+ * Can either be next or previous post relational link.
+ *
+ * @since 2.8.0
+ *
+ * @param string $title Optional. Link title format.
+ * @param bool $in_same_cat Optional. Whether link should be in same category.
+ * @param string $excluded_categories Optional. Excluded categories IDs.
+ * @param bool $previous Optional, default is true. Whether display link to previous post.
+ * @return string
+ */
+function get_adjacent_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $previous = true) {
+        if ( $previous && is_attachment() )
+                $post = & get_post($GLOBALS['post']->post_parent);
+        else
+                $post = get_adjacent_post($in_same_cat,$excluded_categories,$previous);
+
+        if ( empty($post) )
+                return;
+
+        if ( empty($post->post_title) )
+                $post->post_title = $previous ? __('Previous Post') : __('Next Post');
+
+        $date = mysql2date(get_option('date_format'), $post->post_date);
+        
+        $title = str_replace('%title', $post->post_title, $title);
+        $title = str_replace('%date', $date, $title);
+        $title = apply_filters('the_title', $title, $post);
+
+        $link = $previous ? "<link rel='prev' title='" : "<link rel='next' title='";
+        $link .= $title;
+        $link .= "' href='" . get_permalink($post) . "' />\n";
+
+        $adjacent = $previous ? 'previous' : 'next';
+        return apply_filters( "{$adjacent}_post_rel_link", $link );
+}
+
+/**
+ * Display relational links for the posts adjacent to the current post.
+ *
+ * @since 2.8.0
+ *
+ * @param string $title Optional. Link title format.
+ * @param bool $in_same_cat Optional. Whether link should be in same category.
+ * @param string $excluded_categories Optional. Excluded categories IDs.
+ */
+function adjacent_posts_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') {
+        echo get_adjacent_post_rel_link($title, $in_same_cat, $excluded_categories = '', true);
+        echo get_adjacent_post_rel_link($title, $in_same_cat, $excluded_categories = '', false);
+}
+
+/**
+ * Display relational link for the next post adjacent to the current post.
+ *
+ * @since 2.8.0
+ *
+ * @param string $title Optional. Link title format.
+ * @param bool $in_same_cat Optional. Whether link should be in same category.
+ * @param string $excluded_categories Optional. Excluded categories IDs.
+ */
+function next_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') {
+        echo get_adjacent_post_rel_link($title, $in_same_cat, $excluded_categories = '', false);
+}
+
+/**
+ * Display relational link for the previous post adjacent to the current post.
+ *
+ * @since 2.8.0
+ *
+ * @param string $title Optional. Link title format.
+ * @param bool $in_same_cat Optional. Whether link should be in same category.
+ * @param string $excluded_categories Optional. Excluded categories IDs.
+ */
+function prev_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') {
+        echo get_adjacent_post_rel_link($title, $in_same_cat, $excluded_categories = '', true);
+}
+
+/**
+ * Retrieve boundary post.
+ *
+ * Boundary being either the first or last post by publish date within the contraitns specified
+ * by in same category or excluded categories.
+ *
+ * @since 2.8.0
+ *
+ * @param bool $in_same_cat Optional. Whether returned post should be in same category.
+ * @param string $excluded_categories Optional. Excluded categories IDs.
+ * @param bool $previous Optional. Whether to retrieve first post.
+ * @return object
+ */
+function get_boundary_post($in_same_cat = false, $excluded_categories = '', $start = true) {
+        global $post, $wpdb;
+
+        if( empty($post) || !is_single() || is_attachment() )
+                return null;
+
+        $join = '';
+        $posts_in_ex_cats_sql = '';
+        if ( $in_same_cat || !empty($excluded_categories) ) {
+                $join = " INNER JOIN $wpdb->term_relationships AS tr ON p.ID = tr.object_id INNER JOIN $wpdb->term_taxonomy tt ON tr.term_taxonomy_id = tt.term_taxonomy_id";
+
+                if ( $in_same_cat ) {
+                        $cat_array = wp_get_object_terms($post->ID, 'category', 'fields=ids');
+                        $join .= " AND tt.taxonomy = 'category' AND tt.term_id IN (" . implode(',', $cat_array) . ")";
+                }
+
+                $posts_in_ex_cats_sql = "AND tt.taxonomy = 'category'";
+                if ( !empty($excluded_categories) ) {
+                        $excluded_categories = array_map('intval', explode(' and ', $excluded_categories));
+                        if ( !empty($cat_array) ) {
+                                $excluded_categories = array_diff($excluded_categories, $cat_array);
+                                $posts_in_ex_cats_sql = '';
+                        }
+
+                        if ( !empty($excluded_categories) ) {
+                                $posts_in_ex_cats_sql = " AND tt.taxonomy = 'category' AND tt.term_id NOT IN (" . implode($excluded_categories, ',') . ')';
+                        }
+                }
+        }
+
+        $boundary = $start ? 'start' : 'end';
+        $order = $start ? 'ASC' : 'DESC';
+
+        $join  = apply_filters( "get_{$boundary}_post_join", $join, $in_same_cat, $excluded_categories );
+        $where = apply_filters( "get_{$boundary}_post_where", "WHERE p.post_type = 'post' AND p.post_status = 'publish' $posts_in_ex_cats_sql", $in_same_cat, $excluded_categories );
+        $sort  = apply_filters( "get_{$boundary}_post_sort", "ORDER BY p.post_date $order LIMIT 1" );
+
+        return $wpdb->get_row("SELECT p.* FROM $wpdb->posts AS p $join $where $sort");
+}
+
+/**
+ * Get boundary post relational link.
+ *
+ * Can either be start or end post relational link.
+ *
+ * @since 2.8.0
+ *
+ * @param string $title Optional. Link title format.
+ * @param bool $in_same_cat Optional. Whether link should be in same category.
+ * @param string $excluded_categories Optional. Excluded categories IDs.
+ * @param bool $start Optional, default is true. Whether display link to first post.
+ * @return string
+ */
+function get_boundary_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $start = true) {
+        $post = get_boundary_post($in_same_cat,$excluded_categories,$start);
+
+        if ( empty($post) )
+                return;
+
+        if ( empty($post->post_title) )
+                $post->post_title = $start ? __('First Post') : __('Last Post');
+
+        $date = mysql2date(get_option('date_format'), $post->post_date);
+
+        $title = str_replace('%title', $post->post_title, $title);
+        $title = str_replace('%date', $date, $title);
+        $title = apply_filters('the_title', $title, $post);
+
+        $link = $start ? "<link rel='start' title='" : "<link rel='end' title='";
+        $link .= $title;
+        $link .= "' href='" . get_permalink($post) . "' />\n";
+
+        $boundary = $start ? 'start' : 'end';
+        return apply_filters( "{$boundary}_post_rel_link", $link );
+}
+
+/**
+ * Display relational link for the first post.
+ *
+ * @since 2.8.0
+ *
+ * @param string $title Optional. Link title format.
+ * @param bool $in_same_cat Optional. Whether link should be in same category.
+ * @param string $excluded_categories Optional. Excluded categories IDs.
+ */
+function start_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') {
+        echo get_boundary_post_rel_link($title, $in_same_cat, $excluded_categories, true);
+}
+
+/**
+ * Get site index relational link.
+ *
+ * @since 2.8.0
+ *
+ * @return string
+ */
+function get_index_rel_link() {
+        $link = "<link rel='index' title='" . get_bloginfo('name') . "' href='" . get_bloginfo('siteurl') . "' />\n";
+        return apply_filters( "index_rel_link", $link );
+}
+
+/**
+ * Display relational link for the site index.
+ *
+ * @since 2.8.0
+ */
+function index_rel_link() {
+        echo get_index_rel_link(); 
+}
+
+/**
+ * Get parent post relational link.
+ *
+ * @since 2.8.0
+ *
+ * @param string $title Optional. Link title format.
+ * @return string
+ */
+function get_parent_post_rel_link($title = '%title') {
+        if ( ! empty( $GLOBALS['post'] ) && ! empty( $GLOBALS['post']->post_parent ) )
+                $post = & get_post($GLOBALS['post']->post_parent);
+
+        if ( empty($post) )
+                return;
+
+        $date = mysql2date(get_option('date_format'), $post->post_date);
+
+        $title = str_replace('%title', $post->post_title, $title);
+        $title = str_replace('%date', $date, $title);
+        $title = apply_filters('the_title', $title, $post);
+
+        $link = "<link rel='up' title='";
+        $link .= $title;
+        $link .= "' href='" . get_permalink($post) . "' />\n";
+
+        return apply_filters( "parent_post_rel_link", $link );
+}
+
+/**
+ * Display relational link for parent item
+ *
+ * @since 2.8.0
+ */
+function parent_post_rel_link($title = '%title') {
+        echo get_parent_post_rel_link($title);
+}
+
+/**
  * Display previous post link that is adjacent to the current post.
  *
  * @since 1.5.0