From d6df5b55c9ace6c9dee374ec11741e7289d98c80 Mon Sep 17 00:00:00 2001 From: westi Date: Wed, 18 Mar 2009 21:56:03 +0000 Subject: [PATCH] Add relational links to next/prev/parent posts. See #8703 props sivel. git-svn-id: http://svn.automattic.com/wordpress/trunk@10815 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/default-filters.php | 4 + wp-includes/link-template.php | 236 ++++++++++++++++++++++++++++++++ 2 files changed, 240 insertions(+) diff --git a/wp-includes/default-filters.php b/wp-includes/default-filters.php index 65b3097bd6..6247e3124e 100644 --- a/wp-includes/default-filters.php +++ b/wp-includes/default-filters.php @@ -168,6 +168,10 @@ add_action('wp_head', 'wp_enqueue_scripts', 1); 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); diff --git a/wp-includes/link-template.php b/wp-includes/link-template.php index 2d172fab6b..9ca939a926 100644 --- a/wp-includes/link-template.php +++ b/wp-includes/link-template.php @@ -908,6 +908,242 @@ function get_adjacent_post($in_same_cat = false, $excluded_categories = '', $pre return $wpdb->get_row("SELECT p.* FROM $wpdb->posts AS p $join $where $sort"); } +/** + * 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 ? "\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; + + $cat_array = array(); + $excluded_categories = array(); + if ( !empty($in_same_cat) || !empty($excluded_categories) ) { + if ( !empty($in_same_cat) ) { + $cat_array = wp_get_object_terms($post->ID, 'category', 'fields=ids'); + } + + if ( !empty($excluded_categories) ) { + $excluded_categories = array_map('intval', explode(',', $excluded_categories)); + + if ( !empty($cat_array) ) { + $excluded_categories = array_diff($excluded_categories, $cat_array); + } + + $inverse_cats = array(); + foreach ( $excluded_categories as $excluded_category) { + $inverse_cats[] = $excluded_category * -1; + } + $excluded_categories = $inverse_cats; + } + } + + $categories = array_merge($cat_array, $excluded_categories); + + $order = $start ? 'ASC' : 'DESC'; + + return get_posts("numberposts=1&order=$order&orderby=ID&category=$categories"); +} + +/** + * 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) { + $posts = get_boundary_post($in_same_cat,$excluded_categories,$start); + // Even though we limited get_posts to return only 1 item it still returns an array of objects. + $post = $posts[0]; + + 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 ? "\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 = "\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 = "\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. *