wp_get_object_terms
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[]|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.
*
* @return WP_Term[]|int[]|string[]|string
*/
function wp_kama_get_object_terms_filter( $terms, $object_ids, $taxonomies, $args ){
// filter...
return $terms;
}
- $terms(WP_Term[]|int[]|string[]|строка)
- Array of terms or a count thereof as a numeric string.
- $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-includes/taxonomy.php 2374
return apply_filters( 'wp_get_object_terms', $terms, $object_ids, $taxonomies, $args );
Где используется хук в WordPress
wp-includes/default-filters.php 585
add_filter( 'wp_get_object_terms', '_post_format_wp_get_object_terms' );