(adjacent)_post_link │ filter-hook │ WP 2.6.0

Filters the adjacent post link.

The dynamic portion of the hook name, $adjacent, refers to the type of adjacency, 'next' or 'previous'.

Possible hook names include:

• next_post_link
• previous_post_link

Usage

add_filter( '(adjacent)_post_link', 'wp_kama_adjacent_post_link_filter', 10, 5 );

/**
 * Function for `(adjacent)_post_link` filter-hook.
 * 
 * @param string         $output   The adjacent post link.
 * @param string         $format   Link anchor format.
 * @param string         $link     Link permalink format.
 * @param WP_Post|string $post     The adjacent post. Empty string if no corresponding post exists.
 * @param string         $adjacent Whether the post is previous or next.
 *
 * @return string
 */
function wp_kama_adjacent_post_link_filter( $output, $format, $link, $post, $adjacent ){

	// filter...
	return $output;
}

$output(string)

The adjacent post link.

$format(string)

Link anchor format.

$link(string)

Link permalink format.

$post(WP_Post|string)

The adjacent post. Empty string if no corresponding post exists.

$adjacent(string)

Whether the post is previous or next.

Changelog

Where the hook is called

return apply_filters( "{$adjacent}_post_link", $output, $format, $link, $post, $adjacent );

Where the hook is used in WordPress

add_filter( 'get_edit_post_link', '__return_empty_string' );