_acf_add_field_storage_names()
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 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 );
}
}