get_(adjacent)_post_excluded_terms filter-hookWP 4.4.0

Filters the IDs of terms excluded from adjacent post queries.

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

Possible hook names include:

Usage

add_filter( 'get_(adjacent)_post_excluded_terms', 'wp_kama_get_adjacent_post_excluded_terms_filter' );

/**
 * Function for `get_(adjacent)_post_excluded_terms` filter-hook.
 * 
 * @param array|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.
 *
 * @return array|string
 */
function wp_kama_get_adjacent_post_excluded_terms_filter( $excluded_terms ){

	// filter...
	return $excluded_terms;
}
$excluded_terms(array|string)
Array of excluded term IDs. Empty string if none were provided.

Changelog

Since 4.4.0 Introduced.

Where the hook is called

get_adjacent_post()
get_(adjacent)_post_excluded_terms
wp-includes/link-template.php 1836
$excluded_terms = apply_filters( "get_{$adjacent}_post_excluded_terms", $excluded_terms );

Where the hook is used in WordPress

Usage not found.