wordpress函数get_adjacent_post_rel_link()用法示例

get_adjacent_post_rel_link( string $title = '%title',  bool $in_same_term = false,  array|string $excluded_terms = '',  bool $previous = true,  string $taxonomy = 'category' )

Retrieves the adjacent post relational link.

描述

Can either be next or previous post relational link.

参数

$title

(string)
(Optional)
Link title format.

Default value: ‘%title’

$in_same_term

(bool)
(Optional)
Whether link should be in a same taxonomy term.

Default value: false

$excluded_terms

(array|string)
(Optional)
Array or comma-separated list of excluded term IDs.

Default value: ”

$previous

(bool)
(Optional)
Whether to display link to previous or next post.

Default value: true

$taxonomy

(string)
(Optional)
Taxonomy, if $in_same_term is true.

Default value: ‘category’

返回值

(string|void) The adjacent post relational link URL.

源代码

File: wp-includes/link-template.php

function get_adjacent_post_rel_link( $title = '%title', $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) {
	if ( $previous && is_attachment() && $post = get_post() )
		$post = get_post( $post->post_parent );
	else
		$post = get_adjacent_post( $in_same_term, $excluded_terms, $previous, $taxonomy );

	if ( empty( $post ) )
		return;

	$post_title = the_title_attribute( array( 'echo' => false, 'post' => $post ) );

	if ( empty( $post_title ) )
		$post_title = $previous ? __( 'Previous Post' ) : __( 'Next Post' );

	$date = mysql2date( get_option( 'date_format' ), $post->post_date );

	$title = str_replace( '%title', $post_title, $title );
	$title = str_replace( '%date', $date, $title );

	$link = $previous ? "<link rel='prev' title='" : "<link rel='next' title='";
	$link .= esc_attr( $title );
	$link .= "' href='" . get_permalink( $post ) . "' />\n";

	$adjacent = $previous ? 'previous' : 'next';

	/**
	 * Filters the adjacent post relational link.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, 'next' or 'previous'.
	 *
	 * @since 2.8.0
	 *
	 * @param string $link The relational link.
	 */
	return apply_filters( "{$adjacent}_post_rel_link", $link );
}

更新日志

相关函数

Uses

• wp-includes/l10n.php:
  __()
• wp-includes/formatting.php:
  esc_attr()
• wp-includes/query.php:
  is_attachment()
• wp-includes/functions.php:
  mysql2date()
• wp-includes/link-template.php:
  get_adjacent_post()
• wp-includes/link-template.php:
  {$adjacent}_post_rel_link
• wp-includes/link-template.php:
  get_permalink()
• wp-includes/plugin.php:
  apply_filters()
• wp-includes/option.php:
  get_option()
• wp-includes/post-template.php:
  the_title_attribute()
• wp-includes/post.php:
  get_post()

Show 6 more uses

Used By

• wp-includes/link-template.php:
  adjacent_posts_rel_link()
• wp-includes/link-template.php:
  next_post_rel_link()
• wp-includes/link-template.php:
  prev_post_rel_link()