get_boundary_post_rel_link( string $title = '%title', bool $in_same_cat = false, string $excluded_categories = '', bool $start = true )
This function has been deprecated.
Get boundary post relational link.
Description
Can either be start or end post relational link.
Parameters
- $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
Return
(string)
Source
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 ); }
Changelog
Version | Description |
---|---|
3.3.0 | This function has been deprecated. |
2.8.0 | Introduced. |
© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_boundary_post_rel_link