Zum Inhalt springen

Dennis · 14. Oktober 2026

Blockstudio 7.7

Blockstudio 7.7 führt virtuelle Routen für Dokumente ohne einen WordPress-Beitrag ein, verbessert gezielte Prerender-Builds und macht die Bearbeitung und das Rendering vorhandener Blöcke zuverlässiger. Außerdem erweitert es die PHPStan-Prüfungen für Block-Tags und verbessert die Barrierefreiheit der mitgelieferten UI-Komponenten.

Der dateibasierte Workflow bleibt unverändert. Blöcke werden anhand ihrer Templates gerendert, und dateibasierte Seiten werden nur durch eine ausdrückliche Synchronisierung mit CLI oder API geändert. Diese Version führt keine automatische Seitensynchronisierung bei Besucher- oder Admin-Anfragen ein.

Kurz gesagt:

  • Virtuelle Routen: Stelle eine Komponentengalerie, einen Katalog oder ein anderes vollständiges Dokument bereit, ohne einen Beitrag anzulegen oder einen eigenen Redirect-Handler zu schreiben.
  • Gezielte Prerender-Builds: HTTP-Builds speichern die Quelldateien, die jede Seite verwendet, damit ein späterer Build nur betroffene Routen rendern kann.
  • Cache-Aufbewahrung: Halte ausgemusterte Stylesheets für gecachte Seiten verfügbar und prüfe oder bereinige ungenutzte Einträge in der Early-Serve-Map.
  • Zuverlässigerer Editor: Bei mehrfach ausgewählten Blöcken bleiben die jeweiligen Werte erhalten. Rückgängig und Wiederholen funktionieren für RichText und Seitenleistenfelder, und der geerbte Kontext bleibt beim richtigen Block.
  • Intakte Dateiinhalte: Verschachtelte Listen, Abschnittselemente, Inline-HTML, Shortcodes und maskierte Attribute bleiben beim Parsen und Rendern erhalten.
  • Verbesserungen für PHPStan: Präfix-Tags, Aliase, zugeordnete Seitenelemente und Template-Variablen werden anhand der projektspezifischen Definitionen geprüft.
  • Barrierefreies UI: Steuerelemente zeigen ihren Status korrekt an, Labels schalten das richtige Eingabefeld um, und Listen- und Tabellenkomponenten verwenden eine gültige HTML-Struktur.
  • Übersetzungen: Installierte JavaScript-Übersetzungen werden im Editor und in der Admin-Übersicht geladen, einschließlich zuvor nicht übersetzter Feldsteuerelemente.

Virtuelle Routen

Manche Seiten stammen aus Daten und nicht aus einem vom Editor verwalteten Beitrag. Eine Komponentenreferenz benötigt beispielsweise möglicherweise eine eigene URL und einen Dokumenttitel, aber keinen Eintrag in wp_posts.

Registriere das Dokument mit Blockstudio\Virtual_Routes:

PHP
add_action('init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function () {
            get_header();
            echo bs_block([
                'name' => 'mytheme/card',
                'data' => ['heading' => 'Example card'],
            ]);
            get_footer();
        },
        ['title' => 'Component gallery']
    );
});

Die Route stellt /components/ bereit. Ihr Callback läuft im Ausgabepuffer von Blockstudio, sodass gerenderte Blöcke ihre Styles, Skripte, gebündelten UI-Assets und die Tailwind-Ausgabe über die reguläre Pipeline erhalten. WordPress wandelt die passende Route weder in einen 404-Fehler um noch leitet sie zu einem Beitrag weiter.

Für eine Gruppe von URLs setze prefix auf true und gib einen match-Callback an. Der Callback erhält den Pfad unterhalb der Route und gibt den Wert zurück, den dein Renderer benötigt. Bei Rückgabe von null oder false bleibt die Anfrage für WordPress. Verwende urls, um die Pfade aufzulisten, die ein statischer Prerender-Build einbeziehen soll. Eine einzelne Route ohne Präfix nimmt standardmäßig ihren eigenen Pfad auf.

Virtual_Routes::urls() gibt absolute URLs für Integrationen zurück, die eine Sitemap erstellen. Virtuelle Dokumente werden dadurch nicht automatisch in die Beitrags-Sitemap von WordPress aufgenommen.

Die vollständige API und alle Optionen findest du unter Virtuelle Routen.

Präzisere Prerender-Builds

Graph-Modus-Builds, die über HTTP gerendert werden, erfassen jetzt die Dateien, die jede Route verwendet: das Template WordPress, gerenderte Block-Templates und Assets, Definitionen und Layouts von Dateiseiten sowie über blockstudio/render/dependencies hinzugefügte Abhängigkeiten.

Beim nächsten Build vergleicht build_plan() diese Abhängigkeiten. Wird ein Block-Template geändert, markiert das seine abhängigen Routen zum erneuten Rendern, ohne alle nicht betroffenen Seiten neu aufzubauen. Änderungen an gemeinsam genutzter Konfiguration betreffen weiterhin den gesamten Build; neue oder abgelaufene Routen werden wie bisher gerendert.

Änderungen, die nur die Datenbank betreffen, sind keine Dateiabänderungen. Bei einem Deployment, das eine Option, einen Beitrag oder einen anderen Datenbankwert übernehmen muss, musst du einen Build erzwingen oder die betroffenen URLs ausdrücklich rendern.

Die Version behebt außerdem Änderungen der Build-Identität während des ersten Renderns, veraltete opcode-gecachte Early-Serve-Maps und den unbeabsichtigten Ausschluss gültiger URLs, nur weil ihr Pfad search oder preview enthält. Markdown-Anfragen mit Accept: text/markdown umgehen den gecachten HTML, und die betreffenden Antworten senden Vary: Accept.

Statisches Prerendering berücksichtigt jetzt Filter, die das aktive Theme registriert, wenn entschieden wird, ob seine Hooks eingebunden werden. Ein Theme kann die Funktion deaktivieren, ohne dass sie durch eine zuvor erfolgte Einstellungsabfrage aktiviert bleibt.

Siehe Static Prerendering.

Cache-Aufbewahrung und Wartung

Eine gecachte HTML-Seite kann die Laufzeitidentität überdauern, mit der ihr Stylesheet kompiliert wurde. cache.namespaceGrace legt fest, wie lange ausgemusterte Namespaces verfügbar bleiben, nachdem die Bereinigung sie erstmals als ausgemustert erkannt hat:

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

Dieses Beispiel bewahrt ausgemusterte Dateien neun Tage lang auf. Standardmäßig ist es ein Tag. Aktive Namespaces und Namespaces, die ausgelieferte Prerender-Artefakte bereitstellen, sind von der Bereinigung ausgenommen.

Für die Early-Serve-Map gibt es außerdem Befehle zum Prüfen und Bereinigen:

Shell
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune

Sie melden und entfernen Einträge für gelöschte Websites oder fehlende Verzeichnisse. Wird eine Website in einer Multisite-Installation gelöscht, werden auch ihre Einträge entfernt. Fehlende Routendokumente werden separat gemeldet, statt den Eintrag einer ansonsten gültigen Website zu entfernen.

Hinweise zur Aufbewahrung findest du unter Caching, die Befehle zur Wartung der Map.

Ein zuverlässigerer Editor

Beim Bearbeiten eines mehrfach ausgewählten Blocks wird jetzt nur dieser Block aktualisiert. Beim Speichern bleiben Inhalt, Schlüssel, Metadaten und Sperren jedes Blocks erhalten, statt Attribute zwischen ausgewählten Blöcken zu kopieren.

RichText-Werte befinden sich direkt in den Blockattributen, damit Gutenberg sie in Rückgängig und Wiederholen einbeziehen kann. Seitenleistenfelder sind Teil desselben Verlaufs. InnerBlocks templateLock="false" wird als echter boolescher Wert übergeben und entsperrt Inhalte auch dann, wenn ein äußerer Bereich gesperrt ist.

Erste Preloads erhalten die ID und den Typ des bearbeiteten Beitrags, sodass Templates bereits beim ersten Rendern die richtigen Metadaten lesen können. Identische untergeordnete Blöcke unter verschiedenen übergeordneten Blöcken behalten in Preloads und Render-Caches ihren jeweiligen geerbten Kontext. Änderungen an Attributen oder Kontext während einer ersten Anfrage lassen die Vorschau nicht mehr hinterherhinken.

Blockstudio fügt außerdem keine versteckten Render-Markierungselemente mehr zwischen Blockwurzeln ein. Selektoren für benachbarte Geschwister wie .card + .card sehen jetzt im Editor dieselben Elementbeziehungen wie im Frontend; Vorschauen im Editor und Inserter bleiben getrennt.

Sicherere speicherweite Optionen

Felder, die Optionen verwenden, liefern weiterhin speicherweite Werte. Beim Speichern eines Beitrags werden jedoch nicht mehr blind alle gespeicherten Kopien dieser Felder geschrieben:

  • Entwürfe, ausstehende, private und geplante Speicherungen schreiben keine aktiven Speicheroptionen.
  • Veröffentlichte Beiträge schreiben die angegebenen Felder, die in dieser Bearbeitung geändert wurden.
  • Eine Speicherung nur des Titels in einer alten Kopie setzt keinen neueren speicherweiten Wert zurück.
  • Fehlende Felder und entfernte Blöcke löschen keine bestehenden Optionen.
  • Ein ausdrückliches null entfernt eine Option. Leere Strings, false, null und leere Arrays bleiben gültige Werte.

Dies ist die wichtigste Verhaltensänderung, die du beim Upgrade prüfen solltest. Wenn eine Integration einen privaten Beitrag oder Entwurf zum Aktualisieren einer aktiven Option verwendet hat, schreibe diese Option ausdrücklich oder verwende stattdessen einen veröffentlichten Konfigurationsbeitrag. Post-Meta-Speicherung ist von der Beschränkung auf veröffentlichte Beiträge nicht betroffen.

Die vollständigen Speicherregeln findest du unter Speicherung.

Dateiinhalte bleiben erhalten

Die HTML-zu-Block-Pipeline bewahrt mehr von der Struktur, die du geschrieben hast:

  • Verschachtelte Listen werden zu inneren Listenblöcken ihres übergeordneten Eintrags. Klassen von Listen und Einträgen bleiben erhalten; gewöhnliche flache Listen werden weiterhin wie bisher ausgegeben.
  • main, header, footer, article und aside werden zu Gruppenblöcken, die ihr Element erhalten, statt zu rohem HTML, das das Block-Rendering umgeht.
  • Zugeordnete Richtext-Absätze behalten ihr Inline-Markup, Absätze, die nur Bilder enthalten, werden dem zugeordneten Bildblock zugewiesen, und Shortcode-Tags behalten ihren Inhalt.
  • Maskierte Attribute werden dekodiert und einmal maskiert, einschließlich Attributen auf InnerBlocks, RichText und dem Element useBlockProps.
  • Größer-als-Zeichen in Anführungszeichen gesetzten Attributen selbstschließender Tags werden akzeptiert.
  • Globale Attribute von HTML gelangen zum Wurzelelement eines Blockstudio-Blocks, wenn der Block sie nicht als Felder deklariert. wp bs pages sync meldet gespeicherte Attribute, die nicht gerendert werden.

Seiten auf Basis von Blade, Muster und Site-Editor-Templates werden jetzt über Blockstudio\Blade_Renderer gerendert; unterstützt werden illuminate/view 8 bis 12. Erweiterungsdateien, die auf denselben Block zielen, werden alle registriert; ihre Priorität, Gruppenfelder und Ziellisten entsprechen dem dokumentierten Schema.

Auch verschachtelte Abhängigkeiten von SCSS werden erfasst. Wird ein Partial bearbeitet, das von einem anderen Partial importiert wird, ändert sich die Version des abhängigen Stylesheets und eine Neukompilierung wird ausgelöst.

Verbesserungen für PHPStan

Das separat installierte Paket blockstudio/phpstan erweitert die Validierung von Block-Tags auf Präfix- und Alias-Tags, zugeordnete Seitenelemente, Layouts, mitgelieferte UI-Blöcke und optional weitere PHP-Quellen des Projekts. Die Namespace-Auflösung entspricht der Laufzeit, auch bei Namespaces mit Bindestrichen; weitergeleitete globale Attribute von HTML werden akzeptiert.

Block-Template-Variablen wie $a, $block und $context gelten als durch Blockstudio definiert. Feldtypen bleiben bei Null-Coalescing und isset() unter PHPStan 2.3 erhalten; weist ein Template seinem eigenen $a einen Wert zu, bleibt der zugewiesene Typ erhalten.

Diese Änderungen sind in blockstudio/phpstan 0.1.9 enthalten. Aktualisiere das Paket getrennt vom Plugin; erforderlich ist PHPStan 2.1.47 oder neuer:

Shell
composer require --dev blockstudio/phpstan:^0.1.9

Konfiguration und Analyse-Presets findest du unter PHPStan.

Barrierefreiheit und Übersetzungen

Die Auslöser der mitgelieferten UI-Komponenten zeigen ihren erweiterten Status auf der jeweiligen Schaltfläche an. Labels für Kontrollkästchen, Schalter und Optionsfelder benennen ihre Steuerelemente und schalten sie um. Breadcrumbs, Seitennummerierung, Navigationsmenüs und Tabellen fügen zwischen Listen oder Tabellen und ihren Einträgen keine ungültigen umschließenden Elemente mehr ein.

Passwort-Umschalter zeigen ihren gedrückten Status an und haben eine größere Klickfläche. Eingabefelder akzeptieren autocomplete; Passwortfelder akzeptieren eine explizite ID und ein barrierefreies Label. Karussell-Ansichtsfenster lassen sich per Tastatur fokussieren, und Spinner- sowie Skeleton-Animationen berücksichtigen die Einstellung für reduzierte Bewegung.

Editor und Admin-Übersicht laden installierte JavaScript-Übersetzungen für die Textdomain blockstudio. Attributmenüs und Platzhalter, Aktionen im Code-Popup sowie Bild- und Datei-Badges lassen sich jetzt übersetzen. Strings ohne Übersetzung bleiben auf Englisch.

Siehe die UI-Bibliothek und die Übersetzungseinrichtung.

Dokumentation und Upgrade

Die Dokumentation ergänzt Anleitungen zu Dokumentationsseiten, Content Sync, Site-Editor-Vorlagen, Block-Tags, Islands, benutzerdefinierten Feldtypen, Bereitstellung, Prerendering, Registry-Einrichtung, Analysetools und UI App-Bildschirmen. Die ACF-Migrationsanleitung berücksichtigt die aktuelle ACF-Registrierung und Block Bindings.

Beispiele für Custom Populate verwenden jetzt den unterstützten Filter mit einem einzelnen Argument und benanntem Dataset. Die Asset-Dokumentation erklärt die Reihenfolge der Frontend-Stylesheets und wie du Theme-Overrides nach CSS-Blöcken lädst. Contributor-Installationen verwenden das öffentliche Font-Awesome-Paket ohne Registry-Zugangsdaten.

PHP 8.2 und WordPress 6.7 bleiben die Mindestanforderungen. Virtuelle Routen und die neuen Wartungsbefehle sind verfügbar, ohne bestehende Seitensammlungen zu ändern. Prüfe die oben genannten Speicherregeln für Optionen, aktualisiere das separate PHPStan-Paket, falls du es verwendest, und führe die Seitensynchronisierung weiterhin wie bisher ausdrücklich aus.

7.7.1 Nachbereitung

Der 7.7.1-Patch macht Synchronisierungsergebnisse klarer und sicherer. Bei einem zusammengeführten Abgleich mit Schlüsseln wird keine Revision erstellt und der Änderungszeitstempel nicht aktualisiert, wenn ein Beitrag unverändert bleibt. Vorhandene Veröffentlichungsstatus bleiben erhalten, dateibasierte Ersetzungen von Titel und Slug werden gemeldet und gesperrte oder entfernte Seiten im CLI-Bericht aufgeführt. Content Sync kennzeichnet von Page Sync verwaltete Inhalte und behält vorhandene Prüfungskopien bei. Der Patch schützt außerdem WordPress-verwaltete Attribute vor widersprüchlichen Feld-IDs und erhält Editor-Klassen, die von anderen Filtern hinzugefügt wurden.