_acf_add_field_storage_names() │ ACF 6.8.11

Adds the meta name a field is loaded from without a reference, and those of its sub fields.

Group and clone sub field names are worked out with the field types' own prepare_field_for_db(), as when their values are loaded. Repeater and flexible content rows are named {field}_{row}_{sub_field}; the row number is held as a placeholder and turned into a pattern.

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

Хуков нет.

Возвращает

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

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

_acf_add_field_storage_names( $storage, $field );
$storage(массив) (обязательный)
The names and patterns, as array keys.
$field(массив) (обязательный)
The field array, with its meta name in name.

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

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

Код _acf_add_field_storage_names() ACF 6.8.11

function _acf_add_field_storage_names( array &$storage, $field ) {
	$name = (string) ( $field['name'] ?? '' );

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

	// Names containing a row placeholder become patterns.
	if ( false !== strpos( $name, "\0" ) ) {
		$parts = array_map(
			function ( $part ) {
				return preg_quote( $part, '/' );
			},
			explode( "\0", $name )
		);

		$storage['patterns'][ '/^' . implode( '\d+', $parts ) . '$/' ] = true;
	} else {
		$storage['names'][ $name ] = true;
	}

	foreach ( _acf_get_field_storage_sub_fields( $field ) as $sub_field ) {
		_acf_add_field_storage_names( $storage, $sub_field );
	}
}