acf/fields/taxonomy/wp_list_categories

Описание

Фильтрует запрос $args, используемый WP_Term_Query для отображения терминов в поле Taxonomy, когда оно показывается в виде списка Radio или Checkbox.

Журнал изменений

  • Добавлено в версии 4.0.0

Параметры

apply_filters( 'acf/fields/taxonomy/wp_list_categories', $args, $field );
  • $args (array) Аргументы запроса. См. wp_list_categories() для доступных аргументов.
  • $field (array) Массив поля, содержащий все настройки.

Модификаторы

Этот фильтр предоставляет модификаторы для выбора конкретных полей. Доступны следующие имена фильтров:

  • acf/fields/taxonomy/wp_list_categories Применяется ко всем полям.
  • acf/fields/taxonomy/wp_list_categories/name={$name} Применяется ко всем полям с конкретным именем.
  • acf/fields/taxonomy/wp_list_categories/key={$key} Применяется ко всем полям с конкретным ключом.

Пример

Этот пример демонстрирует, как изменить некоторые аргументы wp_list_categories в поле Taxonomy.

functions.php

<?php
add_filter('acf/fields/taxonomy/wp_list_categories', 'my_acf_fields_taxonomy_query', 10, 2);
function my_acf_fields_taxonomy_query( $args, $field ) {

    // Сортировать по наиболее часто используемым.
    $args['orderby'] = 'count';
    $args['order'] = 'DESC';

    return $args;
}

Обновлено: 02.06.2026