Описание get_terms
— Filter
Хук get_terms позволяет изменить параметры запроса терминов таксономий в WordPress. Он срабатывает перед выполнением запроса к базе данных для получения терминов, позволяя изменять условия выборки и возвращаемые данные
Примеры использования
Пример изменения списка возвращаемых терминов:
add_filter('get_terms', function($terms, $taxonomies, $args) {
if (in_array('category', $taxonomies)) {
// Удаляем термин с ID 5
$terms = array_filter($terms, function($term) {
return $term->term_id !== 5;
});
}
return $terms;
});
В этом примере мы удаляем термин с ID 5 из списка категорий
Пример изменения аргументов запроса при получении терминов:
add_filter('get_terms', function($terms, $taxonomies, $args) {
if (in_array('post_tag', $taxonomies)) {
$args['orderby'] = 'count';
$args['order'] = 'DESC';
}
return $terms;
});
Здесь мы изменяем порядок сортировки терминов для меток на основе их количества
Пример добавления пользовательского термина в результат:
add_filter('get_terms', function($terms, $taxonomies, $args) {
if (in_array('category', $taxonomies)) {
$terms[] = (object) array('term_id' => 999, 'name' => 'Новый термин', 'taxonomy' => 'category');
}
return $terms;
});
Мы добавляем новый термин с ID 999 в список категорий
— Лучшие практики
– Использование
Используйте этот хук, когда нужно изменить список терминов или параметры запроса к ним
– Производительность
Старайтесь избегать сложных операций в фильтре, чтобы не замедлять запросы
– Предупреждения
Обратите внимание, что изменения могут повлиять на другие части сайта, если они используются в различных контекстах
Альтернативы
Тип: filter
Этот хук позволяет изменять только аргументы запроса терминов, без изменения самих терминов
Используйте его, если нужно только настроить параметры выборки, не изменяя сами термины
