Введение
ACF Blocks — это настраиваемые, динамические блоки, глубоко интегрированные с пользовательскими полями. Эта премиальная функция, доступная в ACF PRO, использует мощный PHP-фреймворк для создания кастомных типов блоков без глубоких знаний JavaScript или React, необходимых для создания блоков WordPress.
PHP-ориентированная природа ACF Blocks позволяет разработчикам на PHP легко создавать индивидуальные решения в соответствии с современной разработкой тем WordPress. ACF Blocks сохраняют совместимость с ядром WordPress, предоставляя доступ ко многим тем же возможностям, что и у нативных блоков.
Упростите рабочий процесс
Окружение PHP
ACF Blocks — это PHP-фреймворк и не требует JavaScript. Это отличает его от API блоков WordPress, который сильно опирается на современные JavaScript-техники, синтаксис и инструменты сборки.
Простое шаблонирование
Как и в разработке тем WordPress, ACF Blocks отображаются с помощью PHP-файла шаблона или callback-функции, что дает полный контроль над HTML-выводом.
Совместимость с пользовательскими полями
ACF Blocks полностью совместимы со всеми типами полей, включая Repeater и Clone! Создайте группу полей и привяжите ее к недавно зарегистрированному блоку с помощью привычных правил расположения ACF.
То же самое относится и к функциям шаблонов. Загружаете ли вы значение поля через get_field() или перебираете поля Repeater с помощью have_rows(), опыт остается знакомым и последовательным, как при обычной разработке темы.
Предпросмотр в реальном времени
Контент меняется — вместе с ним меняются и предпросмотры блоков! При редактировании блока ACF HTML будет обновляться в админке, показывая контент в реальном времени. Если вы используете блок ACF в блоке Query Loop или в теме блоков Full Site Editing, предпросмотр блока будет автоматически обновляться по мере изменения запроса.
Полная совместимость с WordPress
Нативная совместимость
ACF Blocks сохраняют нативную совместимость с ядром WordPress. Это позволяет работать таким функциям, как «выравнивание», «якорь» и даже Повторно используемые блоки!
ACF Blocks несовместимы с отдельным плагином Gutenberg, поскольку плагин включает новые экспериментальные возможности и версии API, которые ACF пока не поддерживает.
Где угодно и сколько угодно
ACF Blocks не привязаны к метаданным, поэтому их можно использовать где угодно в WordPress и по нескольку раз в одной записи.
Загрузка ресурсов блока
ACF Blocks поддерживали подключение ресурсов, специфичных для блока, еще до WordPress! Теперь WordPress тоже поддерживает это, требуя загружать ресурсы с помощью специальных ключей конфигурации ресурсов WordPress. Блоки, созданные в более ранних версиях ACF Blocks, следует перенести на методы, предоставляемые WordPress.
Поддержка block.json
ACF Blocks регистрируются стандартной функцией WordPress register_block_type(), которая загружает файл block.json с вашей конфигурацией.
add_action( 'init', 'register_acf_blocks' );
function register_acf_blocks() {
register_block_type( __DIR__ . '/blocks/your-example-block' );
}
Гибкий дизайн & разработка
Версионирование блоков
Представленное в ACF 6.0 версионирование блоков позволяет включать новые возможности или отключать их, чтобы уже созданные вами блоки сохраняли обратную совместимость.
Блоки без полей
Блоки ACF можно создавать без полей — это полезно, когда нужно показывать элементы шаблона записи, такие как заголовки или содержимое записи, либо когда нужно отображать поля, добавленные к самой отображаемой записи, а не к блоку.
Поддержка InnerBlocks
ACF Blocks полностью поддерживают InnerBlocks, позволяя вкладывать блоки друг в друга. Для этого достаточно добавить <InnerBlocks /> в PHP-файл шаблона блока.
Изменения контекста блока
ACF Blocks поддерживают контекст блока. Это значит, что можно настроить передачу данных в их InnerBlocks, включая данные из полей ACF родительского блока. Когда что-то в этом контексте блока меняется, шаблон дочерних блоков автоматически перезагружается, а ваш шаблон обрабатывает любые изменения, которые могут быть вызваны значениями полей родительского блока.
Следующие шаги
ACF Blocks дают вам функциональность нативных блоков WordPress в привычной PHP-среде. Эта функция ACF PRO позволяет предлагать клиентам идеально подобранные решения, которые объединяют мощь Advanced Custom Fields с удобством редактирования контента и компоновки, доступными в современном редакторе сайтов WordPress.
Далее мы рассмотрим некоторые ключевые понятия, используемые в блоках WordPress, и то, как они применяются при создании ACF Blocks.
Обновлено: 01.06.2026