wp_get_object_terms хук-фильтрWP 2.8.0

Filters the terms for a given object or objects.

The $taxonomies parameter passed to this filter is formatted as a SQL fragment. The get_object_terms filter is recommended as an alternative.

Использование

add_filter( 'wp_get_object_terms', 'wp_kama_get_object_terms_filter', 10, 4 );

/**
 * Function for `wp_get_object_terms` filter-hook.
 * 
 * @param WP_Term[] $terms      Array of terms for the given object or objects.
 * @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.
 *
 * @return WP_Term[]
 */
function wp_kama_get_object_terms_filter( $terms, $object_ids, $taxonomies, $args ){

	// filter...
	return $terms;
}
$terms(WP_Term[])
Array of terms for the given object or objects.
$object_ids(строка)
Comma separated list of object IDs for which terms were retrieved.
$taxonomies(строка)
SQL fragment of taxonomy names from which terms were retrieved.
$args(массив)
Array of arguments for retrieving terms for the given object(s). See wp_get_object_terms() for details.

Список изменений

С версии 2.8.0 Введена.

Где вызывается хук

wp_get_object_terms()
wp_get_object_terms
wp-includes/taxonomy.php 2288
return apply_filters( 'wp_get_object_terms', $terms, $object_ids, $taxonomies, $args );

Где используется хук в WordPress

wp-includes/default-filters.php 547
add_filter( 'wp_get_object_terms', '_post_format_wp_get_object_terms' );