Question

get_adjacent_post_link( string $format,  string $link,  bool $in_same_term = false,  array|string $excluded_terms = '',  bool $previous = true,  string $taxonomy = 'category' )

Retrieves the adjacent post link.

---

description

Can be either next post link or previous.

---

参数

$format

(string) (Required) Link anchor format.

$link

(string) (Required) Link permalink format.

$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 terms 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) The link URL of the previous or next post in relation to the current post.

---

源代码

File: wp-includes/link-template.php

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

	if ( ! $post ) {
		$output = '';
	} else {
		$title = $post->post_title;

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

		/** This filter is documented in wp-includes/post-template.php */
		$title = apply_filters( 'the_title', $title, $post->ID );

		$date = mysql2date( get_option( 'date_format' ), $post->post_date );
		$rel = $previous ? 'prev' : 'next';

		$string = '<a href="' . get_permalink( $post ) . '" rel="'.$rel.'">';
		$inlink = str_replace( '%title', $title, $link );
		$inlink = str_replace( '%date', $date, $inlink );
		$inlink = $string . $inlink . '</a>';

		$output = str_replace( '%link', $inlink, $format );
	}

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

	/**
	 * Filters the adjacent post link.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, 'next' or 'previous'.
	 *
	 * @since 2.6.0
	 * @since 4.2.0 Added the `$adjacent` parameter.
	 *
	 * @param string  $output   The adjacent post link.
	 * @param string  $format   Link anchor format.
	 * @param string  $link     Link permalink format.
	 * @param WP_Post $post     The adjacent post.
	 * @param string  $adjacent Whether the post is previous or next.
	 */
	return apply_filters( "{$adjacent}_post_link", $output, $format, $link, $post, $adjacent );
}

---

更新日志

Version	description
3.7.0	Introduced.

---

相关函数

Uses

• wp-includes/l10n.php: __()
• wp-includes/query.php: is_attachment()
• wp-includes/functions.php: mysql2date()
• wp-includes/link-template.php: {$adjacent}_post_link
• wp-includes/link-template.php: get_adjacent_post()
• 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
• wp-includes/post.php: get_post()
Show 5 more uses Hide more uses

---

Used By

• wp-includes/link-template.php: adjacent_post_link()
• wp-includes/link-template.php: get_previous_post_link()
• wp-includes/link-template.php: get_next_post_link()

---

User Contributed Notes