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

Описание

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

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

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

Параметры

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

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

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

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

Пример

В этом примере показано, как изменить некоторые параметры запроса поля Relationship.

functions.php

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

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

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

    return $args;
}

Обновлено: 02.06.2026