WordPress filter hook · part of WordPress core

list_terms_exclusions

A WordPress core filter that 3 plugins also fire themselves, running on 40K+ sites between them.

How to use list_terms_exclusions

It's a filter: your callback receives the value and 1 more argument, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'list_terms_exclusions', function( $exclusions, $args ) {
	// Change $exclusions here.
	return $exclusions;
}, 10, 2 );

Argument names come from PublishPress Taxonomies's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

This hook is fired by WordPress core too. Official reference on developer.wordpress.org →

3 plugins that fire list_terms_exclusions

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. PublishPress Taxonomies icon PublishPress Taxonomies40,000+ installs apply_filters( 'list_terms_exclusions', $exclusions, $args ) inc/class.client.tagcloud.php:1094
  2. Random Tags Cloud Widget icon Random Tags Cloud Widget200+ installs apply_filters( 'list_terms_exclusions', $exclusions, $args ) random-tags-cloud.php:191
  3. Sitewide Tag Suggestion icon Sitewide Tag SuggestionFewer than 10 installs apply_filters( 'list_terms_exclusions', $exclusions, $args ) sitewide-tag-suggestion.php:203

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.