Описание list_terms_exclusions
— Filter
Хук list_terms_exclusions позволяет изменять массив исключённых терминов для текущего запроса терминов в WordPress. Он срабатывает при выполнении запросов для получения терминов, таких как категории или теги, и позволяет управлять тем, какие термины будут исключены из результатов
Примеры использования
Пример исключения термина с ID 12 из выборки категорий:
add_filter('list_terms_exclusions', function($exclusions) {
$exclusions[] = 12;
return $exclusions;
});
В этом примере мы добавляем идентификатор термина 12 в массив исключений
Пример исключения нескольких терминов из выборки тегов:
add_filter('list_terms_exclusions', function($exclusions) {
$exclusions[] = 5;
$exclusions[] = 7;
return $exclusions;
});
Здесь мы исключаем термины с ID 5 и 7 из выборки тегов
Пример условного исключения термина, если это категория ‘Новости’:
add_filter('list_terms_exclusions', function($exclusions) {
if ('news' === get_query_var('taxonomy')) {
$exclusions[] = 15;
}
return $exclusions;
});
Мы исключаем термин с ID 15 только если текущая таксономия — это ‘news’
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо динамически управлять исключениями терминов в зависимости от контекста запроса
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только выборки данных
– Предупреждения
Будьте осторожны с логикой исключений, чтобы не нарушить логику вывода терминов на сайте
Альтернативы
Тип: function
Используйте get_terms с параметром ‘exclude’, чтобы явно исключить термины из выборки
Если вам нужно контролировать исключения терминов без использования хуков
