acf/fields/relationship/queryхук-фильтрACF 1.0

Позволяет изменить аргументы, используемые в WP_Query для отображения записей в поле Relationship (Записи).

Этот фильтр срабатывает для всех полей этого типа. У него есть модификаторы:

Использование

add_filter( 'acf/fields/relationship/query', 'wp_kama_acf_fields_relationship_query_filter', 10, 3 );

/**
 * Function for `acf/fields/relationship/query` filter-hook.
 * 
 * @param  $args            
 * @param  $field           
 * @param  $options_post_id 
 *
 * @return 
 */
function wp_kama_acf_fields_relationship_query_filter( $args, $field, $options_post_id ){

	// filter...
	return $args;
}
$args(массив)

Массив аргументов для WP_Query(). Например:

Array(
	[posts_per_page] => 20
	[paged] => 1
	[post_type] => Array(
		[0] => school
	)
)
$field(массив)

Конфигурация поля. Например:

Array (
	[ID] => 0
	[key] => field_62f6cd251592b
	[label] => Школы
	[name] => course_schools
	[aria-label] =>
	[prefix] => acf
	[type] => relationship
	[value] =>
	[menu_order] => 1
	[instructions] =>
	[required] => 1
	[id] =>
	[class] =>
	[conditional_logic] => 0
	[parent] => group_course_single_settings
	[wrapper] => Array (
					[width] =>
					[class] =>
					[id] =>
				 )

	[post_type] => Array (
					  [0] => school
					)

	[taxonomy] =>
	[filters] => Array (
					[0] => search
				 )

	[elements] =>
	[min] =>
	[max] =>
	[return_format] => id
	[_name] => course_schools
	[_valid] => 1
)
$post_id(число/строка)
ID текущей редактируемой записи.

Примеры

0

#1 Изменения параметров

По умолчанию поле "Записи" отображает лишь 20 материалов. Изменим это значение до 40 для всех полей типа "Записи".

add_filter('acf/fields/relationship/query', 'my_acf_fields_relationship_query', 10, 3);

function my_acf_fields_relationship_query( $args, $field, $post_id ) {
	$args['posts_per_page'] = 40;

	return $args;
}

Где вызывается хук

acf_field_relationship::get_ajax_query()
acf/fields/relationship/query
acf/includes/fields/class-acf-field-relationship.php 210
$args = apply_filters( 'acf/fields/relationship/query', $args, $field, $options['post_id'] );

Где используется хук в Advanced Custom Fields PRO

Использование не найдено.