get_object_terms

Filter Hook

Description

Filters the terms for a given object or objects.

Hook Information

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

Hook Parameters

Type	Name	Description
`WP_Term[]\|int[]\|string[]\|string`	`$terms`	Array of terms or a count thereof as a numeric string.
`int[]`	`$object_ids`	Array of object IDs for which terms were retrieved.
`string[]`	`$taxonomies`	Array 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 get_object_terms
add_filter('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:2349 - How this hook is used in WordPress core

<?php
2344  	 * @param int[]                           $object_ids Array of object IDs for which terms were retrieved.
2345  	 * @param string[]                        $taxonomies Array of taxonomy names from which terms were retrieved.
2346  	 * @param array                           $args       Array of arguments for retrieving terms for the given
2347  	 *                                                    object(s). See wp_get_object_terms() for details.
2348  	 */
2349  	$terms = apply_filters( 'get_object_terms', $terms, $object_ids, $taxonomies, $args );
2350  
2351  	$object_ids = implode( ',', $object_ids );
2352  	$taxonomies = "'" . implode( "', '", array_map( 'esc_sql', $taxonomies ) ) . "'";
2353  
2354  	/**

PHP Documentation

<?php
/**
	 * Filters the terms for a given object or objects.
	 *
	 * @since 4.2.0
	 *
	 * @param WP_Term[]|int[]|string[]|string $terms      Array of terms or a count thereof as a numeric string.
	 * @param int[]                           $object_ids Array of object IDs for which terms were retrieved.
	 * @param string[]                        $taxonomies Array 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

Links

WordPress Docs View Source Code Search Examples

Related Hooks

Related hooks will be displayed here in future updates.