Field Forge + Gutenberg — Block-Editor-Integration | Field Forge - Benutzerdefinierte Felder, gebaut für Geschwindigkeit
Herunterladen Anmelden

Field Forge + Gutenberg — Block-Editor-Integration

Zwei Möglichkeiten, Field Forge mit Gutenberg zu verwenden

1. Feldgruppen als Metaboxen

Dies ist der Standardansatz für benutzerdefinierte Felder in WordPress. Erstellen Sie eine Feldgruppe im visuellen Builder von Field Forge, weisen Sie sie über Standortregeln einem Beitragstyp zu, und sie erscheint als Metabox beim Bearbeiten von Beiträgen dieses Typs.

In Gutenberg können Metaboxen sein:

  • Unter dem Inhaltsbereich — position=”normal” — unter dem Block-Editor
  • In der Seitenleiste — position=”side” — in der Dokumentseitenleiste
  • Im erweiterten Abschnitt — position=”advanced” — zusammengeklappt unter dem Haupteditor

Alle drei Positionen funktionieren nativ mit Gutenberg. Redakteure füllen die Feldwerte auf die gleiche Weise aus, wie sie es im klassischen Editor tun würden.

2. PHP-gerenderte Gutenberg-Blöcke

Hier wird Field Forge für Entwickler interessanter. Sie können benutzerdefinierte Gutenberg-Blöcke mit PHP-Render-Callbacks registrieren, wobei das Render-Callback vollen Zugriff auf benutzerdefinierte Felder über get_field() hat.

Dies ist derselbe Ansatz, den ACF Pro mit acf_register_block_type() populär gemacht hat — und Field Forge unterstützt die exakt gleiche Funktionssignatur zur Migrationskompatibilität.

“`php add_action(‘init’, function() { if (function_exists(‘acf_register_block_type’)) { acf_register_block_type([ ‘name’ => ‘hero-section’, ‘title’ => ‘Hero Section’, ‘description’ => ‘Ein Hero-Bereich mit Titel, Untertitel und 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 } ```

Weisen Sie dieser Blockgruppe über Standortregeln eine Feldgruppe zu:

Standortregeln: Block ist gleich "acf/hero-section"

Wenn ein Redakteur diesen Block zu einem Gutenberg-Beitrag hinzufügt, wird die Feldgruppe im Inspektorbereich des Blocks gerendert. Redakteure füllen die Felder aus, der Block wird mit einer Live-Vorschau neu gerendert, und die Frontend-Ausgabe stammt aus dem PHP-Callback.

Vollständige PHP-Blockfunktion →


Automatische Erkennung von FAQ-Blöcken

Field Forge erkennt automatisch FAQ-artige Inhalte, die mit den Accordion- oder Details-Blöcken von Gutenberg erstellt wurden. Wenn ein Beitrag diese Blöcke verwendet, stellt Field Forge sie als strukturierte Daten für die Generierung von FAQ-Schemas zur Verfügung (dies ist die plattformübergreifende Integration mit SEO Forge).

Sie müssen FAQ-Felder nicht manuell registrieren — Field Forge liest die Blockstruktur und macht die Daten programmgesteuert verfügbar.


Integration von Blockmustern

Feldgruppen von Field Forge können in Blockmustern verwendet werden. Speichern Sie ein wiederverwendbares Muster, das einen von Field Forge unterstützten benutzerdefinierten Block enthält, und Redakteure können das Muster in jeden Beitrag einfügen, um sofort einen vorkonfigurierten Block mit angehängten benutzerdefinierten Feldern zu erhalten.


Kompatibilität mit Full Site Editing (FSE)

Für Websites, die den Full Site Editing-Modus von WordPress verwenden (Block-Themen mit Site-Editor), funktioniert Field Forge normal:

  • Feldgruppen werden in den Block-Editoren von Block-Themen gerendert
  • Benutzerdefinierte Gutenberg-Blöcke, die über acf_register_block_type() registriert sind, funktionieren im Site-Editor
  • Template-Teile können Field Forge-unterstützte Blöcke enthalten
  • Globale Stile integrieren sich über die supports-Konfiguration mit Field Forge-Blöcken

Dynamische Blöcke mit InnerBlocks

Für komplexere Blockmuster kombinieren Sie Field Forge-Blöcke mit dem -Komponenten von 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 } ```

Der Seitenbereich wird von benutzerdefinierten Feldern unterstützt, der Hauptbereich besteht aus Standard-Gutenberg-Blöcken. Benutzer erhalten das Beste aus beiden Welten.


Leistung

Die Feldwerte von Field Forge werden beim ersten Blockrendering über den Objekt-Cache geladen, und nachfolgende Renderings auf derselben Seite sind Cache-Treffer. Für Seiten mit mehreren benutzerdefinierten Blöcken bedeutet dies eine Datenbankabfrage pro einzigartigem Feld, unabhängig davon, wie viele Blöcke es verwenden.

Kombiniert mit benutzerdefinierter Tabellenspeicherung laden Gutenberg-Seiten mit vielen von Field Forge unterstützten Blöcken schneller als äquivalente ACF-unterstützte Seiten.


Migration von ACF-Blockregistrierungen

Wenn Sie bereits acf_register_block_type()-Aufrufe in Ihrem Theme haben, funktionieren diese nach der Migration von ACF zu Field Forge unverändert weiter. Die Kompatibilitätsschicht implementiert acf_register_block_type() mit derselben Signatur und leitet intern zur Blockregistrierung von Field Forge weiter.

Keine Codeänderungen erforderlich. Ihre Gutenberg-Blöcke werden weiterhin über PHP-Callbacks gerendert, die get_field() verwenden — was jetzt auf die Speicherung von Field Forge anstelle von ACF verweist.


Bereit, Field Forge im Block-Editor zu verwenden?

Holen Sie sich Field Forge — ab $35/Jahr →

Die Gutenberg-Integration ist in jeder Version von Field Forge enthalten, einschließlich der kostenlosen.

Forge KI-Assistent Online

Hallo! Ich bin der Field Forge KI-Assistent. Fragen Sie mich alles über das Plugin — Einrichtung, Funktionen, Fehlerbehebung oder Entwicklung.

Gerade eben
Unterstützt von Forge KI · Dokumentation durchsuchen