acf/fields/post_object/query — фильтр запросов Post Object

Описание

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

История изменений

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

Параметры

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

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

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

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

Пример

В этом примере показано, как изменить некоторые аргументы запроса Post Object.

functions.php

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

    // Показывать 40 записей за AJAX-запрос.
    $args['posts_per_page'] = 40;

    // Ограничить результаты только дочерними элементами текущей записи.
    $args['post_parent'] = $post_id;

    return $args;
}

Обновлено: 02.06.2026