检索相邻的帖子关系链接。

原型

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

描述

可以是下一个或上一个帖子关系链接。

参数

$title (string) (Optional)  链接标题格式。

$in_same_term (bool) (Optional)  链接是否应该在同一分类术语中。

$excluded_terms (array|string) (Optional)  排除的术语ID的数组或逗号分隔列表。

$previous (bool) (Optional)  是否显示上一篇或下一篇文章的链接。

$taxonomy (string) (Optional)  分类法,如果$ in_same_term为真。

返回值

(string|void)  相邻的帖子关系链接URL。

源文件

路径:wp-includes/link-template.php

<?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 );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/get_adjacent_post_rel_link/