Описание
Фильтрует запрос $args, используемый WP_Term_Query для отображения терминов в поле Taxonomy, когда оно выводится как выпадающий список Select или Multiselect.
Изменения
- Добавлено в версии 5.0.0
Параметры
apply_filters( 'acf/fields/taxonomy/query', $args, $field, $post_id );$args(array) Аргументы запроса. См. WP_Term_Query для доступных аргументов.$field(array) Массив поля, содержащий все настройки.$post_id(int|string) Текущий редактируемый ID записи.
Модификаторы
Этот фильтр предоставляет модификаторы для выбора конкретных полей. Доступны следующие имена фильтров:
acf/fields/taxonomy/queryПрименяется ко всем полям.acf/fields/taxonomy/query/name={$name}Применяется ко всем полям с определённым именем.acf/fields/taxonomy/query/key={$key}Применяется ко всем полям с определённым ключом.
Пример
В этом примере показано, как изменить некоторые аргументы запроса поля Taxonomy.
functions.php
<?php
add_filter('acf/fields/taxonomy/query', 'my_acf_fields_taxonomy_query', 10, 3);
function my_acf_fields_taxonomy_query( $args, $field, $post_id ) {
// Показывать 40 терминов за AJAX-запрос.
$args['number'] = 40;
// Сортировать по количеству использования.
$args['orderby'] = 'count';
$args['order'] = 'DESC';
return $args;
}Обновлено: 02.06.2026