Описание
Этот фильтр позволяет добавлять поля в верхнюю панель инструментов конкретного блока ACF, обеспечивая прямое редактирование из заголовка блока в редакторе.
Когда поле добавлено в панель инструментов, оно отображается как кнопка. Нажатие на эту кнопку открывает всплывающее окно с полем ввода, что делает процесс редактирования более удобным и интегрированным.
Журнал изменений
- Добавлено в версии 6.7.
Параметры
apply_filters( 'acf/blocks/top_toolbar_fields', $fields, $block, $content, $is_preview, $post_id, $wp_block, $context );
$fields(array) Массив полей, которые будут отображаться в панели инструментов.
По умолчанию — пустой массив.$block(array) Массив свойств блока.$content(string) Внутреннее содержимое блока.$is_preview(bool) Логическое значение, которое равно true, когда блок рендерится
для предпросмотра при редактировании.$post_id(int) ID редактируемой записи.$wp_block(WP_Block|null) Экземпляр WP_Block или null.$context(array) Контекст блока.
Возвращаемое значение
(array) Изменённый массив полей.
Пример
Этот пример показывает, как добавить поле изображения в панель инструментов блока ACF:
function my_block_top_toolbar_fields($block_top_toolbar_field_names, $block) {
// Если рассматриваемый блок — наш блок.
if ( 'acf/my-acf-block' === $block['name'] ) {
// Показываем некоторые поля ACF в основной панели инструментов блока.
return array( 'my_background_image_field', 'my_background_color_field');
}
// Если рассматриваемый блок не наш, просто передаём переменную как есть.
return $block_top_toolbar_field_names;
}
add_filter( 'acf/blocks/top_toolbar_fields', 'my_block_top_toolbar_fields', 10, 2 );
Обновлено: 31.05.2026