PHP-рендеренные блоки Gutenberg — совместимые с acf_register_block_type

Почему PHP-рендеренные блоки?

Gutenberg (редактор блоков WordPress) был разработан вокруг блоков, рендеренных на JavaScript. Вы пишете функцию save() на JS, которая возвращает HTML блока, и WordPress сохраняет этот HTML в содержимом поста. Для простых визуальных блоков это работает отлично.

Но для динамических блоков — «Показать последние 3 блога с пользовательским стилем,» «Отобразить участника команды с данными из профиля текущего пользователя,» «Рендерить сетку продуктов из запроса WooCommerce» — блоки на JavaScript создают проблемы. Вам приходится писать вызовы REST API, управлять состояниями загрузки и восстанавливать логику получения данных, которую WordPress уже умеет делать на PHP.

PHP-рендеренные блоки позволяют вам написать PHP-обработчик, который выполняется во время рендеринга страницы, имеет полный доступ к API данных WordPress (WP_Query, get_field(), get_post_meta() и т.д.) и возвращает HTML напрямую. Проще, быстрее и более идиоматично для WordPress.

ACF представил acf_register_block_type() много лет назад, и он стал де-факто стандартом для разработчиков агентств, создающих пользовательские блоки Gutenberg. Field Forge поддерживает ту же сигнатуру функции, поэтому миграция тривиальна.

---

Как зарегистрировать PHP блок

Основной пример

«`php // functions.php или пользовательский плагин

add_action(‘acf/init’, ‘register_my_blocks’);

function register_my_blocks() { if (function_exists(‘acf_register_block_type’)) { acf_register_block_type([ ‘name’ => ‘feature-card’, ‘title’ => __(‘Карточка функции’), ‘description’ => __(‘Карточка функции с иконкой, заголовком и описанием.’), ‘render_callback’ => ‘render_feature_card_block’, ‘category’ => ‘theme’, ‘icon’ => ‘star-filled’, ‘keywords’ => [‘feature’, ‘card’], ‘supports’ => [ ‘align’ => [‘wide’, ‘full’], ‘anchor’ => true, ‘color’ => true, ], ]); } }

function render_feature_card_block($block) { $icon = get_field(‘icon’); $title = get_field(‘title’); $description = get_field(‘description’); ?>

<?php } ```

Этот код идентичен коду регистрации ACF. Работает без изменений после миграции.

Регистрация нативного Field Forge

Если вы предпочитаете нативный API Field Forge (для чистоты кода или чтобы избежать намека на необходимость ACF), используйте fieldforge_register_block_type():

«php add_action('init', function() { fieldforge_register_block_type([ 'name' => 'feature-card', 'title' => __('Карточка функции'), 'render_callback' => 'render_feature_card_block', 'category' => 'theme', ]); }); «

Обе функции делают одно и то же. Используйте ту, которая соответствует вашим командам.

---

Пользовательские поля в блоке

Каждый PHP блок может иметь свою собственную группу полей, назначенную через правила расположения:

« Правила расположения: Блок равен "acf/feature-card" «

Когда редактор добавляет блок в пост, Field Forge рендерит группу полей в боковой панели блока (или встроенно, в зависимости от настроек блока). Редактор заполняет поля, блок автоматически обновляется с живым предварительным просмотром.

Во время рендеринга функция render_callback использует get_field() для доступа к значениям полей:

«`php function render_feature_card_block($block) { // get_field() работает внутри обратных вызовов блока $icon = get_field(‘icon’); $title = get_field(‘title’);

// Массив $block содержит все данные об этом конкретном экземпляре блока $block_id = $block[‘id’]; $is_preview = !empty($block[‘is_preview’]); $block_data = $block[‘data’]; $className = !empty($block[‘className’]) ? $block[‘className’] : »;

// Рендеринг HTML ?>

<div class="feature-card «>