Filter hook 'wp_get_object_terms'

in WP Core File wp-includes/taxonomy.php at line 2368

View Source

wp_get_object_terms

Filter Hook
Description
Filters the terms for a given object or objects. The `$taxonomies` parameter passed to this filter is formatted as a SQL fragment. The {@see 'get_object_terms'} filter is recommended as an alternative.

Hook Information

File Location wp-includes/taxonomy.php View on GitHub
Hook Type Filter
Line Number 2368

Hook Parameters

Type Name Description
WP_Term[]|int[]|string[]|string $terms Array of terms or a count thereof as a numeric string.
string $object_ids Comma separated list of object IDs for which terms were retrieved.
string $taxonomies SQL fragment of taxonomy names from which terms were retrieved.
array $args Array of arguments for retrieving terms for the given object(s). See wp_get_object_terms() for details.

Usage Examples

Basic Usage
<?php
// Hook into wp_get_object_terms
add_filter('wp_get_object_terms', 'my_custom_filter', 10, 4);

function my_custom_filter($terms, $object_ids, $taxonomies, $args) {
    // Your custom filtering logic here
    return $terms;
}

Source Code Context

wp-includes/taxonomy.php:2368 - How this hook is used in WordPress core
<?php
2363  	 * @param string                          $object_ids Comma separated list of object IDs for which terms were retrieved.
2364  	 * @param string                          $taxonomies SQL fragment of taxonomy names from which terms were retrieved.
2365  	 * @param array                           $args       Array of arguments for retrieving terms for the given
2366  	 *                                                    object(s). See wp_get_object_terms() for details.
2367  	 */
2368  	return apply_filters( 'wp_get_object_terms', $terms, $object_ids, $taxonomies, $args );
2369  }
2370  
2371  /**
2372   * Adds a new term to the database.
2373   *

PHP Documentation

<?php
/**
	 * Filters the terms for a given object or objects.
	 *
	 * The `$taxonomies` parameter passed to this filter is formatted as a SQL fragment. The
	 * {@see 'get_object_terms'} filter is recommended as an alternative.
	 *
	 * @since 2.8.0
	 *
	 * @param WP_Term[]|int[]|string[]|string $terms      Array of terms or a count thereof as a numeric string.
	 * @param string                          $object_ids Comma separated list of object IDs for which terms were retrieved.
	 * @param string                          $taxonomies SQL fragment of taxonomy names from which terms were retrieved.
	 * @param array                           $args       Array of arguments for retrieving terms for the given
	 *                                                    object(s). See wp_get_object_terms() for details.
	 */
Quick Info
  • Hook Type: Filter
  • Parameters: 4
  • File: wp-includes/taxonomy.php
Related Hooks

Related hooks will be displayed here in future updates.