_acf_set_block_meta_value() │ ACF 6.8.11

Adds a block field's value to the values to save, under the field's top-level key.

Seamless clone sub field values are nested under the clone's key, as the clone field saves them.

Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.

Хуков нет.

Возвращает

void. Ничего (null).

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

_acf_set_block_meta_value( $keyed_values, $field, $value );
$keyed_values(массив) (обязательный)
The values to save, keyed by top-level field key.
$field(массив) (обязательный)
The field array.
$value(разное) (обязательный)
The field's value.

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

С версии 6.8.11 Введена.

Код _acf_set_block_meta_value() ACF 6.8.11

function _acf_set_block_meta_value( array &$keyed_values, $field, $value ) {
	$root_key = acf_get_field_root_key( $field );

	if ( $root_key === $field['key'] ) {
		$keyed_values[ $root_key ] = $value;
		return;
	}

	if ( $root_key === '' ) {
		return;
	}

	// A seamless clone of a seamless clone passes each level its own value, so build every level down to the field.
	$root_field = acf_get_field( $root_key );
	$path       = $root_field ? _acf_get_seamless_clone_path( $root_field, $field['key'] ) : array();
	$path       = $path ? $path : array( $field['key'] );
	$leaf_key   = array_pop( $path );

	if ( ! isset( $keyed_values[ $root_key ] ) || ! is_array( $keyed_values[ $root_key ] ) ) {
		$keyed_values[ $root_key ] = array();
	}

	$level = &$keyed_values[ $root_key ];

	foreach ( $path as $key ) {
		if ( ! isset( $level[ $key ] ) || ! is_array( $level[ $key ] ) ) {
			$level[ $key ] = array();
		}

		$level = &$level[ $key ];
	}

	$level[ $leaf_key ] = $value;
}