Описание
Фильтрует текст, отображаемый для каждой записи в поле Relationship.
Журнал изменений
- Добавлено в версии 4.1.2
Параметры
apply_filters( 'acf/fields/relationship/result', $text, $post, $field, $post_id );
$text(строка) Текст, отображаемый для этой записи (заголовок записи).$post(WP_Post) Поле Relationship.$field(массив) Массив поля, содержащий все настройки.$post_id(int|string) Текущий ID записи, которую редактируют.
Модификаторы
Этот фильтр предоставляет модификаторы для работы с конкретными полями. Доступны следующие имена фильтров:
– acf/fields/relationship/result Применяется ко всем полям.
– acf/fields/relationship/result/name={$name} Применяется ко всем полям с указанным именем.
– acf/fields/relationship/result/key={$key} Применяется ко всем полям с указанным ключом.
Примеры
Этот пример показывает, как добавить значение произвольного поля из каждой записи к отображаемому тексту.
functions.php
<?php
add_filter('acf/fields/relationship/result', 'my_acf_fields_relationship_result', 10, 4);
function my_acf_fields_relationship_result( $text, $post, $field, $post_id ) {
$page_views = get_field( 'page_views', $post->ID );
if( $page_views ) {
$text .= ' ' . sprintf( '(%s просмотров)', $page_views );
}
return $text;
}
Этот пример показывает, как выводить ID заказа для заказов WooCommerce в поле Relationship.
functions.php
<?php
add_filter('acf/fields/relationship/result', 'my_acf_fields_relationship_result_woocommerce_orders', 10, 4);
function my_acf_fields_relationship_result_woocommerce_orders( $text, $post, $field, $post_id ) {
if ( $post->post_type !== 'shop_order' ) {
return $text;
}
return str_replace( 'Заказ', 'Заказ ' . $post->ID, $text );
}
Обновлено: 02.06.2026