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 “>