Field Forge + Gutenberg — Інтеграція блочного редактора | Field Forge - Кастомні поля, створені для швидкості
Завантажити Увійти

Field Forge + Gutenberg — Інтеграція блочного редактора

Два способи використання Field Forge з Gutenberg

1. Групи полів як метабокси

Це стандартний підхід до користувацьких полів WordPress. Створіть групу полів у візуальному конструкторі Field Forge, призначте її за допомогою правил розташування для типу поста, і вона з’явиться як метабокс під час редагування постів цього типу.

У Gutenberg метабокси можуть бути:

  • Під областю контенту — position=”normal” — під блочним редактором
  • У бічній панелі — position=”side” — у бічній панелі документа
  • У розширеній секції — position=”advanced” — згорнутий під основним редактором

Усі три позиції працюють нативно з Gutenberg. Редактори заповнюють значення полів так само, як у класичному редакторі.

2. PHP-відображувані блоки Gutenberg

Тут Field Forge стає більш цікавим для розробників. Ви можете реєструвати користувацькі блоки Gutenberg з PHP-викликами рендерингу, де виклик рендерингу має повний доступ до користувацьких полів через get_field().

Це той же підхід, який популяризував ACF Pro з acf_register_block_type() — і Field Forge підтримує точно таку ж сигнатуру функції для сумісності при міграції.

“`php add_action(‘init’, function() { if (function_exists(‘acf_register_block_type’)) { acf_register_block_type([ ‘name’ => ‘hero-section’, ‘title’ => ‘Герой секція’, ‘description’ => ‘Герой секція з заголовком, підзаголовком та CTA.’, ‘render_callback’ => ‘render_hero_section_block’, ‘category’ => ‘theme’, ‘icon’ => ‘cover-image’, ‘keywords’ => [‘hero’, ‘section’], ‘supports’ => [ ‘align’ => [‘wide’, ‘full’], ‘anchor’ => true, ], ]); } });

function render_hero_section_block($block) { $title = get_field(‘title’); $subtitle = get_field(‘subtitle’); $background_image = get_field(‘background_image’); ?>

<img decoding="async" src="” alt=””>

<?php } ```

Призначте групу полів цьому блоку за допомогою правил розташування:

Location Rules: Block is equal to "acf/hero-section"

Коли редактор додає цей блок до поста Gutenberg, група полів відображається всередині панелі інспектора блоку. Редактори заповнюють поля, блок повторно рендериться з живим попереднім переглядом, а вихід на фронтенді надходить з PHP-виклику.

Повна функція PHP блоків →


Авто-визначення блоків FAQ

Field Forge автоматично визначає контент у стилі FAQ, створений за допомогою блоків Accordion або Details Gutenberg. Коли пост використовує ці блоки, Field Forge надає їх як структуровані дані для генерації схеми FAQ (це інтеграція між плагінами з SEO Forge).

Вам не потрібно вручну реєструвати поля FAQ — Field Forge читає структуру блоку і робить дані доступними програмно.


Інтеграція шаблонів блоків

Групи полів Field Forge можуть використовуватися всередині шаблонів блоків. Збережіть повторно використовуваний шаблон, що містить користувацький блок на базі Field Forge, і редактори можуть вставити шаблон у будь-який пост, щоб миттєво отримати попередньо налаштований блок з прикріпленими користувацькими полями.


Сумісність з повним редагуванням сайту (FSE)

Для сайтів, що використовують режим повного редагування сайту WordPress (блокові теми з редактором сайту), Field Forge працює нормально:

  • Групи полів відображаються в редакторах постів блокової теми
  • Користувацькі блоки Gutenberg, зареєстровані через acf_register_block_type(), працюють в редакторі сайту
  • Частини шаблонів можуть включати блоки на базі Field Forge
  • Глобальні стилі інтегруються з блоками Field Forge через конфігурацію supports

Динамічні блоки з InnerBlocks

Для більш складних шаблонів блоків поєднуйте блоки Field Forge з компонентом Gutenberg :

“`php acf_register_block_type([ ‘name’ => ‘two-column-with-fields’, ‘render_callback’ => ‘render_two_column_block’, ‘supports’ => [ ‘inner_blocks’ => true, ], ]);

function render_two_column_block($block) { $sidebar_title = get_field(‘sidebar_title’); $sidebar_content = get_field(‘sidebar_content’); ?>

<?php } ```

Бічна панель живиться користувацькими полями, основна область — стандартні блоки Gutenberg. Користувачі отримують найкраще з обох світів.


Продуктивність

Значення полів Field Forge завантажуються через об’єктний кеш під час першого рендерингу блоку, а наступні рендеринги на тій же сторінці є кеш-ударом. Для сторінок з кількома користувацькими блоками це означає один запит до бази даних на унікальне поле, незалежно від того, скільки блоків його використовують.

У поєднанні з кастомним зберіганням таблиць, сторінки Gutenberg з багатьма блоками на базі Field Forge завантажуються швидше, ніж еквівалентні сторінки на базі ACF.


Міграція з реєстрацій блоків ACF

Якщо у вас є існуючі виклики acf_register_block_type() у вашій темі, вони продовжать працювати без змін після міграції з ACF на Field Forge. Сумісний шар реалізує acf_register_block_type() з тією ж сигнатурою, маршрутизуючи до реєстрації блоків Field Forge внутрішньо.

Зміни коду не потрібні. Ваші блоки Gutenberg продовжують рендеритися через PHP-виклики, які використовують get_field() — що тепер вирішується на зберіганні Field Forge замість ACF.


Готові використовувати Field Forge у блочному редакторі?

Отримайте Field Forge — від $35/рік →

Інтеграція з Gutenberg включена в усі версії Field Forge, включаючи безкоштовну.

Асистент ШІ Forge Онлайн

Привіт! Я асистент ШІ Field Forge. Запитайте мене про будь-що щодо плагіна — налаштування, можливості, усунення несправностей чи розробку.

Щойно
Працює на Forge AI · Переглянути документацію