Фильтр acf/fields/user/query

Описание

Фильтрует аргументы запроса $args, используемые WP_Query для вывода текста для каждого пользователя.

Параметры

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

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

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

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

Пример

В этом примере показано, как изменить некоторые аргументы запроса поля User. Возвращаемые $args передаются в WP_User_Query. Полный список поддерживаемых параметров см. в документации WP_User_Query.

functions.php

<?php
add_filter('acf/fields/user/query', 'my_acf_fields_user_query', 10, 3);
function my_acf_fields_user_query( $args, $field, $post_id ) {

    // Показать 40 пользователей за один AJAX-запрос
    $args['number'] = 40;

    return $args;
}

Обновлено: 02.06.2026