Question

Warning: This function has been deprecated.

get_boundary_post_rel_link( string $title = '%title',  bool $in_same_cat = false,  string $excluded_categories = '',  bool $start = true )

Get boundary post relational link.

---

description

Can either be start or end post relational link.

---

参数

$title

(string) (Optional) Link title format.

Default value: '%title'

$in_same_cat

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

Default value: false

$excluded_categories

(string) (Optional) Excluded categories IDs.

Default value: ''

$start

(bool) (Optional) Whether to display link to first or last post.

Default value: true

---

返回值

(string)

---

源代码

File: wp-includes/deprecated.php

function get_boundary_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $start = true) {
	_deprecated_function( __FUNCTION__, '3.3.0' );

	$posts = get_boundary_post($in_same_cat, $excluded_categories, $start);
	// If there is no post stop.
	if ( empty($posts) )
		return;

	// Even though we limited get_posts to return only 1 item it still returns an array of objects.
	$post = $posts[0];

	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->ID);

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

	$boundary = $start ? 'start' : 'end';
	return apply_filters( "{$boundary}_post_rel_link", $link );
}

---

更新日志

Version	description
3.3.0	This function has been deprecated.
2.8.0	Introduced.

---

相关函数

Uses

• wp-includes/l10n.php: __()
• wp-includes/formatting.php: esc_attr()
• wp-includes/functions.php: _deprecated_function()
• wp-includes/functions.php: mysql2date()
• wp-includes/link-template.php: get_boundary_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
Show 4 more uses Hide more uses

---

Used By

• wp-includes/deprecated.php: start_post_rel_link()

---

User Contributed Notes