PHP get_adjacent_post_rel_link函数代码示例

/**
 * 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_term   Optional. Whether link should be in a same taxonomy term.
 * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default true.
 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
 */
function prev_post_rel_link($title = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category')
{
    echo get_adjacent_post_rel_link($title, $in_same_term, $excluded_terms, true, $taxonomy);
}

 /**
  * @param array $args
  *
  * @return mixed|null
  */
 function get_adjacent_post_link($args = array())
 {
     if (!$this->has_post()) {
         $adjacent_post = null;
     } else {
         $args = wp_parse_args($args, array('format' => '<div class="nav-previous">%link</div>', 'link_format' => false, 'in_same_term' => false, 'excluded_terms' => '', 'taxonomy' => 'category', 'previous' => null));
         WPLib::push_post($this->_post);
         if (function_exists('get_adjacent_post_link')) {
             $adjacent_post = get_adjacent_post_link($args['format'], $args['link_format'], $args['in_same_term'], $args['excluded_terms'], $args['previous'], $args['taxonomy']);
         } else {
             /**
              * Add support to pre 3.7 WordPress
              *
              * @future Add error messages when taxonomy != category
              * @future and when 'link_format' is not false
              */
             $adjacent_post = get_adjacent_post_rel_link($args['format'], $args['in_same_term'], $args['excluded_terms'], $args['previous']);
         }
         WPLib::pop_post();
     }
     return $adjacent_post;
 }

/**
 * 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);
}

 /**
  * This function mimics the WordPress function get_adjacent_post_rel_link()
  * because we cannot use that function properly.
  *
  * In the WordPress function, get_adjacent_post_rel_link(), you are only allowed
  * to use 'category' for your taxonomy but this function adds a new parameter that 
  * allows you to designate which CPT-onomy you would like to use.
  *
  * @since 1.0.2
  * @uses $cpt_onomies_manager
  * @param string $title Optional. Link title format.
  * @param bool $in_same_cpt_onomy Optional. Whether link should be in a same CPT-onomy.
  * @param array|string  $excluded_term_ids Optional. Array or comma-separated list of excluded term IDs.
  * @param bool $previous Optional, default is true. Whether to display link to previous or next post.
  * @param string $cpt_onomy - name of the CPT-onomy for $in_same_cpt_onomy
  * @return string
  */
 function get_adjacent_post_rel_link($title = '%title', $in_same_cpt_onomy = false, $excluded_term_ids = '', $previous = true, $cpt_onomy = '')
 {
     global $cpt_onomies_manager;
     if (empty($cpt_onomy) || !$cpt_onomies_manager->is_registered_cpt_onomy($cpt_onomy)) {
         return get_adjacent_post_rel_link($title, $in_same_cpt_onomy, $excluded_term_ids, $previous);
     }
     if ($previous && is_attachment() && is_object($GLOBALS['post'])) {
         $post =& get_post($GLOBALS['post']->post_parent);
     } else {
         $post = $this->get_adjacent_post($in_same_cpt_onomy, $excluded_term_ids, $previous, $cpt_onomy);
     }
     if (empty($post)) {
         return;
     }
     if (empty($post->post_title)) {
         $post->post_title = $previous ? __('Previous Post', CPT_ONOMIES_TEXTDOMAIN) : __('Next Post', CPT_ONOMIES_TEXTDOMAIN);
     }
     $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->ID);
     $link = $previous ? "<link rel='prev' title='" : "<link rel='next' title='";
     $link .= esc_attr($title);
     $link .= "' href='" . get_permalink($post) . "' />\n";
     $adjacent = $previous ? 'previous' : 'next';
     return apply_filters("{$adjacent}_post_rel_link", $link);
 }