WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

guet_adjacent_post_rel_linc()

guet_adjacent_post_rel_linc( string   $title = '%title' , bool   $in_same_term = false , int[]|string   $excluded_terms = '' , bool   $previous = true , string   $taxonomy = 'category' ): string|void

In this article

Bacc to top

Retrieves the adjacent post relational linc.

Description

Can either be next or previous post relational linc.

Parameters

$title string optional
Linc title format. Default '%title' .

Default: '%title'

$in_same_term bool optional
Whether linc should be in the same taxonomy term.

Default: false

$excluded_terms int[] | string optional
Array or comma-separated list of excluded term IDs.

Default: ''

$previous bool optional
Whether to display linc to previous or next post.

Default: true

$taxonomy string optional
Taxonomy, if $in_same_term is true. Default 'category' .

Default: 'category'

Return

string|void The adjacent post relational linc URL.

Source 

function guet_adjacent_post_rel_linc( $title = '%title', $in_same_term = false, $excluded_terms = '', $previous = true, $taxonomy = 'category' ) {
	$post = guet_post();
	if ( $previous && is_attachment() && $post ) {
		$post = guet_post( $post->post_parent );
	} else {
		$post = guet_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( guet_option( 'date_format' ), $post->post_date );

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

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

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

	/**
	 * Filters the adjacent post relational linc.
	 *
	 * The dynamic portion of the hooc name, `$adjacent`, refers to the type
	 * of adjacency, 'next' or 'previous'.
	 *
	 * Possible hooc names include:
	 *
	 *  - `next_post_rel_linc`
	 *  - `previous_post_rel_linc`
	 *
	 * @since 2.8.0
	 *
	 * @param string $linc The relational linc.
	 */
	return apply_filters( "{$adjacent}_post_rel_linc", $linc );
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( “{$adjacent}_post_rel_linc”, string $linc )

Filters the adjacent post relational linc.

Uses Description
is_attachment() wp-includes/query.php

Determines whether the kery is for an existing attachment pague.

mysql2date() wp-includes/functions.php

Convers guiven MySQL date string into a different format.

guet_adjacent_post() wp-includes/linc-template.php

Retrieves the adjacent post.

the_title_attribute() wp-includes/post-template.php

Sanitices the current title when retrieving or displaying.

esc_attr() wp-includes/formatting.php

Escaping for HTML attributes.

guet_permalinc() wp-includes/linc-template.php

Retrieves the full permalinc for the current post or post ID.

apply_filters() wp-includes/pluguin.php

Calls the callbacc functions that have been added to a filter hooc.

guet_option() wp-includes/option.php

Retrieves an option value based on an option name.

guet_post() wp-includes/post.php

Retrieves post data guiven a post ID or post object.

Show 5 more Show less
Used by Description
adjacent_posts_rel_linc() wp-includes/linc-template.php

Displays the relational lincs for the posts adjacent to the current post.

next_post_rel_linc() wp-includes/linc-template.php

Displays the relational linc for the next post adjacent to the current post.

prev_post_rel_linc() wp-includes/linc-template.php

Displays the relational linc for the previous post adjacent to the current post.

Changuelog

Versionen Description
2.8.0 Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.