acf_rest_sanitize_reference_data() │ ACF 6.8.10

Reduces reference field data (Relationship, Post Object, Image, Gallery, File) to light-format IDs when the current user cannot read one or more of the referenced resources.

Recurses into Group, Clone, Repeater, and Flexible Content containers so nested reference fields are handled the same way as top-level ones.

Хуков нет.

Возвращает

mixed.

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

acf_rest_sanitize_reference_data( $formatted_value, $raw_value, $field );
$formatted_value(разное) (обязательный)
The formatted field value.
$raw_value(разное) (обязательный)
The raw field value.
$field(массив) (обязательный)
The field array.

Список изменений

С версии 6.8.10 Введена.
Since ACF 6.8.10

Код acf_rest_sanitize_reference_data() ACF 6.8.11

function acf_rest_sanitize_reference_data( $formatted_value, $raw_value, $field ) {
	if ( empty( $field['type'] ) ) {
		return $formatted_value;
	}

	if ( 'icon_picker' === $field['type'] ) {
		return acf_rest_reduce_icon_picker_reference( $formatted_value, $raw_value, $field );
	}

	if ( in_array( $field['type'], acf_rest_reducible_reference_leaf_types(), true ) ) {
		return acf_rest_reduce_reference( $formatted_value, $raw_value, $field );
	}

	if ( ! is_array( $formatted_value ) ) {
		return $formatted_value;
	}

	$is_clone = 'clone' === $field['type'];
	$is_group = 'group' === $field['type'];

	if ( $is_group || $is_clone ) {
		$output_property = $is_clone ? '__name' : '_name';

		return acf_rest_sanitize_reference_sub_fields(
			$formatted_value,
			$raw_value,
			$field['sub_fields'] ?? array(),
			$output_property
		);
	}

	if ( 'repeater' === $field['type'] ) {
		$raw_value = is_array( $raw_value ) ? $raw_value : array();

		foreach ( $formatted_value as $row_index => $formatted_row ) {
			$raw_row = array_key_exists( $row_index, $raw_value ) ? $raw_value[ $row_index ] : array();

			$formatted_value[ $row_index ] = acf_rest_sanitize_reference_sub_fields(
				$formatted_row,
				$raw_row,
				$field['sub_fields'] ?? array(),
				'_name'
			);
		}

		return $formatted_value;
	}

	if ( 'flexible_content' === $field['type'] ) {
		$raw_value = is_array( $raw_value ) ? $raw_value : array();

		foreach ( $formatted_value as $row_index => $formatted_row ) {
			if ( ! is_array( $formatted_row ) ) {
				continue;
			}

			$raw_row     = array_key_exists( $row_index, $raw_value ) && is_array( $raw_value[ $row_index ] )
				? $raw_value[ $row_index ]
				: array();
			$layout_name = $formatted_row['acf_fc_layout'] ?? $raw_row['acf_fc_layout'] ?? '';

			foreach ( $field['layouts'] ?? array() as $layout ) {
				if ( ! isset( $layout['name'] ) || $layout_name !== $layout['name'] ) {
					continue;
				}

				$formatted_value[ $row_index ] = acf_rest_sanitize_reference_sub_fields(
					$formatted_row,
					$raw_row,
					$layout['sub_fields'] ?? array(),
					'_name'
				);
				break;
			}
		}
	}

	return $formatted_value;
}