Zum Inhalt springen

Einstellungen

Blockstudio bietet eine leistungsstarke EinstellungsAPI, mit der du Optionen über eine blockstudio.json-Datei in deinem Theme-Ordner und/oder Filter festlegen kannst. Außerdem können berechtigte Benutzer die Einstellungen im Adminbereich visuell ändern.

Über JSON

Wenn sich eine blockstudio.json-Datei in deinem Theme-Ordner befindet, wird sie verwendet, um die Standardoptionen für die aktuelle Website festzulegen. Ein JSON-Schema dient der Validierung der Datei und unterstützt die automatische Vervollständigung in einer IDE.

Die Datei ist optional. Fehlt sie, verwendet Blockstudio die im Adminbereich gespeicherten Einstellungen zusätzlich zu den integrierten Standardwerten. Das Hinzufügen, Ändern oder Entfernen der Datei wird automatisch erkannt; ein Leeren des Caches oder manuelles Neuladen ist nicht erforderlich.

Folgende Eigenschaften sind verfügbar:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "users": {
    "ids": [],
    "roles": []
  },
  "assets": {
    "enqueue": true,
    "reset": {
      "enabled": false,
      "fullWidth": []
    },
    "minify": {
      "css": false,
      "js": false
    },
    "process": {
      "scss": false
    }
  },
  "cache": {
    "enabled": true,
    "path": "blockstudio/cache"
  },
  "themeDefaults": {
    "titleTag": false,
    "suppressDirectoryUpdates": false
  },
  "performance": {
    "profile": "compat",
    "wordpress": {
      "headNoise": false,
      "embeds": false,
      "xmlrpc": false,
      "editor": false,
      "frontendAssets": false,
      "media": false,
      "heartbeat": false
    },
    "preload": {
      "links": "off"
    },
    "media": {
      "lazy": false,
      "skeleton": false,
      "metadata": false,
      "rootMargin": "300px"
    },
    "measurement": {
      "enabled": false,
      "queryMonitor": false,
      "headers": false,
      "timings": false
    }
  },
  "content": {
    "enabled": false,
    "id": "default",
    "path": "content",
    "includePageSyncManaged": false,
    "authors": "ignore",
    "postTypes": [],
    "meta": {
      "include": [],
      "exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
      "references": {}
    },
    "taxonomies": [],
    "media": "manifest"
  },
  "editor": {
    "formatOnSave": false,
    "assets": [],
    "markup": false
  },
  "tailwind": {
    "enabled": false,
    "config": "",
    "output": "inline"
  },
  "blockTags": {
    "enabled": false,
    "allow": [],
    "deny": [],
    "prefixes": {}
  },
  "ui": {
    "enabled": false
  },
  "blockEditor": {
    "disableLoading": false,
    "enhance": false,
    "cssClasses": [],
    "cssVariables": [],
    "blocks": {
      "allow": [],
      "deny": [],
      "directory": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      },
      "styles": {
        "deny": {}
      },
      "legacyWidgets": {
        "hide": []
      }
    },
    "patterns": {
      "core": true,
      "remote": true,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      }
    },
    "media": {
      "openverse": true,
      "imageSizes": {
        "allow": [],
        "deny": []
      }
    }
  },
  "dev": {
    "grab": {
      "enabled": false
    },
    "perf": false,
    "canvas": {
      "enabled": false,
      "adminBar": true
    }
  },
  "githooks": {
    "commit": false
  },
  "phpstan": {
    "preset": "base",
    "configuration": "",
    "roots": ["."],
    "excludePaths": [],
    "maxFiles": 10000
  },
  "ai": {
    "enableContextGeneration": false
  }
}

Über Filter

Alternativ kannst du den blockstudio/settings/${setting}-Filter verwenden, um Optionen flexibler über PHP festzulegen.

PHP
add_filter('blockstudio/settings/assets/enqueue', '__return_false');
add_filter('blockstudio/settings/editor/formatOnSave', '__return_true');
add_filter('blockstudio/settings/ui/enabled', '__return_true');
add_filter('blockstudio/settings/block_editor/patterns/remote', '__return_false');

Über den blockstudio/settings/${setting}-Filter festgelegte Optionen überschreiben die Optionen aus der blockstudio.json-Datei. Beide Methoden können gemeinsam verwendet werden.

Laufzeitwerte bieten außerdem blockstudio/performance/${setting}-Filter und einen abschließenden blockstudio/performance/config-Filter. Letzterer muss ein gültiges Konfigurationsobjekt zurückgeben.

So werden die Quellen zusammengeführt

Alle Quellen werden geladen und zusammengeführt, beginnend mit der niedrigsten Priorität:

  1. Integrierte Standardwerte
  2. Über den Adminbereich gespeicherte Einstellungen UI (die Option blockstudio_settings)
  3. blockstudio.json im Theme
  4. blockstudio/settings/*-Filter

blockstudio.json überschreibt nur die Schlüssel, die es festlegt. Früher wurden damit die gespeicherten Einstellungen vollständig ersetzt, sodass ein unabhängig im Adminbereich gespeicherter Wert ab dem Moment, in dem die Datei vorhanden war, nicht mehr angewendet wurde. Jetzt wird die Datei zusätzlich zu diesen Einstellungen berücksichtigt. Die Kehrseite: Ein veralteter Wert, der über den Adminbereich UI gespeichert wurde, gilt weiter, bis die Datei den entsprechenden Schlüssel festlegt oder der gespeicherte Wert entfernt wird. Wenn sich eine Einstellung anders verhält, als es die Datei vorgibt, prüfe die gespeicherte Ebene mit wp bs settings oder Settings::get_raw(). Damit werden nur die Werte zurückgegeben, die die aktive Quelle JSON oder die Optionsquelle ausdrücklich festgelegt hat.

Einstellungen aus PHP auslesen

Blockstudio\Settings lädt die aktive Quelle, meldet fehlerhaftes JSON und lädt automatisch neu, wenn sich blockstudio.json ändert:

PHP
use Blockstudio\Settings;

$enabled = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$roles = Settings::get_array('users/roles');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);

foreach (Settings::errors() as $error) {
    error_log($error);
}

Verwende Settings::get_raw(), wenn eine Integration nur Werte benötigt, die ausdrücklich in der aktiven JSON oder der Optionsquelle deklariert sind. Settings::fingerprint() gibt eine deterministische Identität der effektiven Einstellungen zurück. Lang laufende Prozesse können Settings::reload() ausdrücklich aufrufen, um eine Dateiänderung sofort einzulesen. Beim normalen Zugriff wird die Datei innerhalb einer Anfrage oder eines lang laufenden PHP-Prozesses höchstens einmal pro Sekunde geprüft, auch bei Änderungen, durch die die Dateigröße gleich bleibt. Eine Änderung des konfigurierten Pfads wird beim nächsten Lesevorgang wirksam. Wenn keine JSON-Datei aktiv ist, werden gespeicherte Datenbankeinstellungen durch dieses Zeitfenster nicht verzögert.

Das aufgelöste Performanceprofil ist über Blockstudio\Runtime_Settings::current() verfügbar. Es unterstützt Pfade mit Schrägstrichen oder Punkten:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

if ($runtime->enabled('measurement/queryMonitor')) {
    $hash = $runtime->hash();
}

Verfügbare Einstellungen

users

Option Typ Standard Beschreibung
ids Array [] Benutzer-IDs mit Editorzugriff
roles Array [] Benutzerrollen mit Editorzugriff

assets

Option Typ Standard Beschreibung
enqueue boolean true Block-Assets automatisch in die Warteschlange stellen
reset.enabled boolean false Core-Blockstile entfernen und den Editor-Utility-Reset anwenden
reset.fullWidth array [] Inhaltstypen mit Editor-Layout über die volle Breite
minify.css boolean false CSS-Ausgabe minimieren
minify.js boolean false JS-Ausgabe minimieren
process.scss boolean false SCSS-Dateien verarbeiten
output string source Speicherort der kompilierten Assets: source oder cache
inlineLimit integer 0 Bytes externer Block-CSS, die pro Seite inline ausgegeben werden

output verwendet standardmäßig source und legt neben jedem Block ein Verzeichnis _dist an. Setze den Wert auf cache, um kompilierte Assets stattdessen im Cache-Verzeichnis Blockstudio abzulegen. So bleibt der Block-Quellbaum sauber und lässt sich aus einem unveränderlichen Checkout bereitstellen. Quellen Blockstudio können unabhängig von dieser Einstellung nicht in den Cache umgeleitet werden.

inlineLimit ist auf 0 deaktiviert, daher behält jedes externe Stylesheet sein <link>-Tag. Setze den Wert auf eine Byte-Anzahl, um stattdessen die kleinsten externen Block-Stylesheets einer Seite inline auszugeben, solange ihre Gesamtgröße diesen Wert nicht überschreitet. 40000 ist der Grenzwert, den WordPress core für dieselbe Regel verwendet. Siehe Kleine Stylesheets inline ausgeben.

Wenn reset.enabled aktiv ist, kopiert Blockstudio außerdem bereinigte Frontend-body_class-Werte in die Editor-Leinwand. Mit blockstudio/editor/canvas/body_class kannst du die nur im Editor verwendete Klassenliste anpassen.

cache

Option Typ Standard Beschreibung
enabled Boolean true Blockstudio-Datei-Caches aktivieren
path String "blockstudio/cache" Cache-Pfad, relativ zu WP_CONTENT_DIR oder absolut
namespaceGrace Integer 86400 Sekunden, die ein stillgelegter Cache-Namensraum vor dem Bereinigen erhalten bleibt

Standardmäßig werden Cache-Dateien außerhalb des Upload-Verzeichnisses unter wp-content/blockstudio/cache gespeichert. Ein relativer path wird ausgehend von WP_CONTENT_DIR aufgelöst; ein absoluter Pfad wird direkt verwendet. So werden Hosts unterstützt, die ein eigenes beschreibbares Cache-Volume bereitstellen.

Wenn diese Option aktiviert ist, verwendet Blockstudio dieses eine Stammverzeichnis für Build-Payloads, vorausberechnete Blockregistrierungsdaten, aufgelöste Editor-Assets, Tailwind CSS, Render-Dokumente, Island-Fragmente, statische Vorab-Renderings, Graph-Indizes, Warteschlangen und Diagnosedaten. Jedes Objekt wird nach Netzwerk, Website, vollständiger Laufzeitidentität und Geltungsbereich isoliert. Laufzeitidentitäten umfassen Blockstudio, Einstellungen, WordPress, PHP, das aktive Theme, aktive Plugins, logische Erkennungsquellen, den Hostkontext und explizite Abhängigkeitshashes, die der zuständige Vorgang bereitstellt.

Änderungen an Inhalten, Begriffen, Benutzern und Metadaten machen bereits gefüllte Feldauswahlen ungültig, nicht jedoch die strukturelle Blockerkennung oder kompilierte Assets. Die Auswahlen werden separat unter einer festen Build-Pfad-Sperre aktualisiert. Eine Serie von Schreibvorgängen, etwa eine Übersetzungssynchronisierung oder ein Import, wird zusammengefasst: Der erste Schreibvorgang nach einer Ruhephase löst sofort eine Aktualisierung aus, und der letzte Schreibvorgang der Serie wird berücksichtigt, sobald dreißig Sekunden vergangen sind; der Zeitraum lässt sich mit blockstudio/cache/populate_debounce anpassen. Metadaten, die WordPress als Buchführung schreibt, etwa die Sperre für die Beitragsbearbeitung, gelten nicht als Änderung; blockstudio/cache/populate_ignored_meta_keys erweitert diese Liste. Der Editor fragt Optionen immer live ab, daher wirkt sich das Zeitfenster nur auf zwischengespeicherte Auswahlen aus, die beim Rendern gelesen werden. Quelldateien und Build-Einstellungen machen den strukturellen Cache weiterhin wie gewohnt ungültig. Beim Überschreiben der Auswahlen wird das Cache-Verzeichnis nicht bei jeder Inhaltsänderung erneut durchsucht; die regelmäßige Bereinigung entfernt weiterhin verwaiste temporäre Dateien. Sprachspezifische Laufzeit-Identitäten bleiben isoliert; mehrere Cache-Namespace-Verzeichnisse auf einer mehrsprachigen Website sind für sich genommen kein Hinweis auf einen Cache-Fehler.

SQLite Aktivitäten im Journal innerhalb des db-Datenverzeichnisses eines Blocks verwerfen keine zwischengespeicherten Blockmetadaten. Änderungen an db.php, überwachten Quelldateien oder der Struktur aus Quelldateien und Unterverzeichnissen des Datenverzeichnisses machen den Cache weiterhin ungültig.

Bei gleichzeitigem Neuaufbau der Laufzeit wird ein einzelner Prozess als Builder bestimmt. Andere Anfragen warten bis zu fünf Sekunden und verwenden danach die zuletzt gültigen Blockmetadaten erneut, sofern die Quelldateien und erforderlichen kompilierten Assets noch vorhanden sind. Eine kalte Anfrage ohne sichere Nutzdaten gibt HTTP 503 mit Retry-After zurück, statt einen weiteren Build zu starten. Mit dem Filter blockstudio/cache/build_wait_budget lässt sich die Wartezeit für strukturelle Neuaufbauten und die Aktualisierung von Auswahlen in Millisekunden anpassen. Bei einem Host ohne beratende Dateisperren werden Auswahlen ungeschützt aktualisiert und trotzdem veröffentlicht, sodass sie bei der nächsten Anfrage im Cache liegen.

Nicht aktive, schlüsselspezifische .build.lock-Dateien aus älteren Versionen werden mit WP-Cron aus allen Cache-Namensräumen dieser Website entfernt. Der Vorgang beginnt fünf Minuten nach dem Upgrade und löscht innerhalb eines Zeitlimits von zehn Sekunden bis zu 10.000 Sperren pro Minute. wp bs cache status gibt die verbleibende Anzahl zurück, und wp bs cache cleanup leert den Rückstand sofort. Mit wp bs cache clear wird der Laufzeit-Cache geleert. Ist ein geplanter Durchlauf mehr als zehn Minuten überfällig, weil cron nicht ausgeführt wird, entfernen Anfragen einmal pro Stunde eine begrenzte Anzahl von Sperren, damit die Bereinigung nicht ins Stocken gerät. Kürzlich erstellte oder gehaltene Sperren bleiben erhalten; die neuen Sperren mit festem Pfad werden nie entfernt. Nach dem Abbau des Rückstands bereinigt derselbe Durchlauf verwaiste Cache-Namensräume, sobald deren namespaceGrace abgelaufen ist, höchstens einmal pro Stunde und Website. Ein täglicher Durchlauf bleibt dafür ebenfalls geplant. Die Karenzzeit beginnt mit dem ersten Durchlauf, der einen Namensraum als stillgelegt erkennt, nicht mit dessen neuester Datei. Ein Namensraum, der für einen seiner Geltungsbereiche noch aktuell ist, wird nie entfernt. Die interne Cache-Bereinigung ruft keine Filter zum Löschen von WordPress-Anhängen auf. Hosts mit deaktiviertem WP-Cron sollten weiterhin ihren üblichen geplanten cron-Worker ausführen. Lösche nicht wahllos aktive Sperrdateien, um einen Rückstand zu beseitigen.

Der Einstellungsfilter blockstudio/settings/cache/path ändert den konfigurierten Wert. Für eine deploymentspezifische Pfadauflösung filtert blockstudio/cache/dir das aufgelöste Basisverzeichnis:

PHP
add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

Hosts, deren Mandantenidentität von den Netzwerk-/Blog-IDs WordPress abweicht, können blockstudio/cache/site_key filtern. Das Ergebnis wird bereinigt und ausschließlich als Verzeichnisabschnitt verwendet. blockstudio/cache/context bleibt der richtige Ort für eine serialisierbare Laufzeitvariante, die Objektidentitäten ändern muss.

themeDefaults

Option Typ Standard Beschreibung
titleTag Boolean false Unterstützung des Theme-Titel-Tags WordPress aktivieren
suppressDirectoryUpdates Boolean false Aktive Child- und Parent-Themes aus den Verzeichnissen der Update-Ergebnisse entfernen

Muster verwenden weiterhin das bestehende Blockstudio\Patterns API. Diese Standardwerte führen keine alternativen Fassaden für Seiten oder Muster ein.

performance

Das Profil compat lässt das allgemeine Verhalten von WordPress unverändert. speed und strict aktivieren dieselben optionalen Frontend-Standardwerte. Jede untergeordnete Einstellung kann ihren Profilwert überschreiben.

Optionale Einstellungen steuern die Registrierung. Ist ein optionales Feature false, bindet Blockstudio weder die zugehörigen Frontend-, Admin-, Editor- und REST-Callbacks ein noch geplante Callbacks. Wenn du Early Serve oder die geplante Vorwärmung deaktivierst, nachdem du sie verwendet hast, werden ihre eigenen Daten einmalig bereinigt. Bei späteren Anfragen bleiben sie inaktiv.

Option Typ Kompatibilitätsstandard Geschwindigkeits-/Strengestandard Beschreibung
profile string "compat" Nicht zutreffend compat, speed oder strict
wordpress.headNoise boolean false true Generische Head-Erkennung und Emoji-Ausgabe entfernen
wordpress.embeds boolean false true oEmbed-Erkennung und Host-Skripte entfernen
wordpress.xmlrpc boolean false true XML-RPC und Pingbacks deaktivieren
wordpress.editor boolean false true Remote-Erkennungsflächen des Editors deaktivieren
wordpress.frontendAssets boolean false true Generische Core-Frontend-Assets entfernen
wordpress.media boolean false true Standardwerte für die Bildausgabe anwenden
wordpress.heartbeat boolean false true Heartbeat außerhalb von Editoren drosseln
preload.links string "off" "intent" Dokumente desselben Ursprungs nach Nutzerintention vorab laden
media.lazy boolean false true Bild-Ladeprogramm von Blockstudio verwenden
media.skeleton boolean false true Integriertes Lade-Skelett anzeigen
media.metadata boolean false true Verwendung von assets/media.json deklarieren
media.rootMargin string "300px" "300px" Schnittmargen des Lazy-Loaders
measurement.enabled boolean false false Laufzeit-Mess-APIs aktivieren
measurement.queryMonitor boolean false false Abfragen mit mindestens 50ms einbeziehen
measurement.headers boolean false false Profil- und Konfigurations-Hash-Header senden
measurement.timings boolean false false Header mit verstrichener Laufzeit senden
staticPrerender.enabled boolean false false Anonymitätssicheres HTML-Caching aktivieren
staticPrerender.ttl integer 86400 86400 Maximales Alter zwischengespeicherter Dokumente in Sekunden
staticPrerender.invalidate string "signature" "signature" signature– oder inkrementelle graph-Identität verwenden
staticPrerender.earlyServe boolean false false Sichere Treffer ausliefern, bevor WordPress startet
staticPrerender.serveLoggedIn boolean false false Nutzern erlauben, Cache-Treffer zu verwenden, aber nie zu erstellen
staticPrerender.dynamicPaths array [] [] Pfadpräfixe, die dynamisch bleiben müssen
staticPrerender.replayHeaders array ["Link"] ["Link"] Antwort-Header, die mit Cache-Treffern gespeichert und bei ihnen gesendet werden
staticPrerender.warm.enabled boolean false false Dauerhafte geplante Warm-Queue aktivieren
staticPrerender.warm.interval integer 3600 3600 Warm-Intervall in Sekunden
staticPrerender.warm.concurrency integer 2 2 Maximale Anzahl an Jobs pro Warm-Durchlauf
staticPrerender.warm.transport string "http" "http" http oder einen vom Host bereitgestellten internal-Renderer verwenden

Statisches Prerendering bleibt deaktiviert, sofern es nicht ausdrücklich aktiviert wird. Ein deaktivierter Hauptschalter registriert keine Prerender-Request-Hooks, und deaktivierte earlyServe– und warm.enabled-Schalter registrieren keine Admin- oder cron-Hooks. Der Signaturmodus verwendet bei gewöhnlichen Requests eine kostengünstige aktivierte Identität. Der Graphmodus ist für explizite Builds vorgesehen: Er erfasst die Quellabhängigkeiten pro Seite, sodass die Änderung einer Seite keine nicht betroffenen Dokumente invalidiert. Weitere Informationen zu Aufwärmen, Deployment, frühem Ausliefern und Sicherheitsdetails findest du unter Statisches Prerendering.

Messwerte sind programmatisch verfügbar:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Wenn Header aktiviert sind, sendet Blockstudio X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config und optional X-Blockstudio-Performance-Time. Die Aktion blockstudio/performance/measurement_enabled erhält die aufgelösten Laufzeiteinstellungen.

Die Optionen von media steuern bs_media_image(), das assets/media.json– Manifest und den Lazy-Loader des Frontends. Unter Medien findest du Informationen zum Helper, Manifest-Builder und Verhalten des Loaders.

content

Option Typ Standard Beschreibung
enabled boolean false Content-Sync-Konfiguration aktivieren
id string "default" Namespace des Inhaltssatzes, der in synchronisierten Entitäten gespeichert wird
path string "content" Verzeichnis für Inhaltsdateien relativ zum Theme
includePageSyncManaged boolean false Von Page Sync verwaltete Beiträge einbeziehen, ohne ihren Inhalt zu verwalten
authors string "ignore" Umgang mit Autoren (ignore oder vorhandener Benutzer login)
postTypes array [] Zulässige Beitragstypen
meta.include array [] Glob-Muster für zu synchronisierende Meta-Schlüssel
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Glob-Muster für auszuschließende Meta-Schlüssel
meta.references object {} Deklarierte Meta-Referenzen werden zwischen IDs und UIDs umgeschrieben
taxonomies array [] Zulässige registrierte Taxonomien für Begriffe und Beziehungen
media string "manifest" Verhalten bei Attachment-Referenzen (manifest oder none)

Content Sync wird über wp bs content verwaltet und überträgt zulässige Beiträge, Postmeta und deklarierte Referenzen in portable Dateien. Weitere Informationen zum Ablauf und Dateiformat findest du unter Content Sync.

editor

Option Typ Standard Beschreibung
formatOnSave boolean false block.json beim Speichern formatieren
assets array [] Zusätzliche Assets im Editor laden
markup boolean false Markup-Bearbeitung aktivieren

tailwind

Option Typ Standard Beschreibung
enabled boolean false Tailwind CSS-Kompilierung aktivieren
config string "" Tailwind v4 CSS-Konfiguration zuerst

Informationen zum Kompilierungsverhalten und zum CSS-First-Konfigurationsformat findest du unter Tailwind CSS.

blockTags

Option Typ Standard Beschreibung
enabled boolean false Rendering von bs:-Tags auf Seitenebene in Beitragsinhalten und Widget-Bereichen aktivieren
allow array [] Zulassungsliste für Blocknamensmuster; unterstützt fnmatch()-Platzhalter
deny array [] Sperrliste für Blocknamensmuster; hat Vorrang vor allow
prefixes object {} Präfix zum Zuordnen von Kurzformen zu Namespaces; jeder Wert ist ein Namespace oder ein geordnetes Array

Rendering von Tags auf Template-Ebene ist immer aktiv; diese Optionen steuern das Ersetzen auf Seitenebene. Syntax und Auflösungsregeln für Tags findest du unter Rendering.

ui

Option Typ Standard Beschreibung
enabled boolean false Die enthaltenen bsui/*-UI-Komponenten und app/*-Demo-Apps registrieren

blockEditor

Option Typ Standard Beschreibung
disableLoading boolean false Laden von Blöcken im Editor deaktivieren
enhance boolean false Hover- und Auswahlfunktionen des Blockstudio-Editors aktivieren
cssClasses array [] Stylesheet-URLs, aus denen CSS-Klassen für die Autovervollständigung des Klassenfelds extrahiert werden
cssVariables array [] Stylesheet-URLs, aus denen CSS-Variablen für die Autovervollständigung des Codefelds extrahiert werden

blockEditor.blocks

Verwende blockEditor.blocks für die projektweite Richtlinie zum Block-Inserter. allow und deny akzeptieren Blocknamen und Platzhaltermuster wie core/*.

JSON
{
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      },
      "legacyWidgets": {
        "hide": ["archives", "calendar"]
      }
    }
  }
}

blocks.styles.deny hebt die Registrierung von Stilen auf, die über die Blockstil-Registry von WordPress’ PHP registriert wurden:

JSON
{
  "blockEditor": {
    "blocks": {
      "styles": {
        "deny": {
          "my-theme/card": ["outline"],
          "my-theme/media": ["framed"]
        }
      }
    }
  }
}

blockEditor.patterns

Verwende blockEditor.patterns, um globale Musterquellen zu deaktivieren und Musterkategorien zu filtern.

JSON
{
  "blockEditor": {
    "patterns": {
      "core": false,
      "remote": false,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "deny": ["gallery"],
        "rename": {
          "featured": "Featured Layouts"
        },
        "order": ["featured", "buttons"]
      }
    }
  }
}

blockEditor.media

Verwende blockEditor.media für die globale Richtlinie zum Medien-Inserter.

JSON
{
  "blockEditor": {
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"],
        "deny": ["medium_large"]
      }
    }
  }
}

dev

Option Typ Standard Beschreibung
grab.enabled boolean false Frontend-Element-Grabber aktivieren
perf boolean false Performance-Profiler bei jedem Seitenaufruf aktivieren
canvas.enabled boolean false Canvas aktivieren
canvas.adminBar boolean true Admin-Leiste von WordPress beim Anzeigen der Canvas einblenden

githooks

Option Typ Standard Beschreibung
commit boolean false Analyseorientierten Pre-Commit-Hook erzeugen, wenn blockstudio-githooks sync ausgeführt wird

Im Abschnitt Verwalteter Commit-Hook erfährst du, was der generierte Hook ausführt und wie er synchron bleibt.

phpstan

Option Typ Standard Beschreibung
preset string "base" Analysevorgabe, wenn die Befehlszeile keine auswählt: base, theme, extreme-theme oder wordpress-render
configuration string "" Projekt-PHPStan-Konfiguration, die neben der Vorgabe eingebunden und aus blockstudio.json aufgelöst wird
roots array ["."] Theme-Stammverzeichnisse, die vom kanonischen Befehl analysiert werden
excludePaths array [] Zusätzliche Scanner-Ausschlüsse relativ zu jedem konfigurierten Stammverzeichnis
maxFiles integer 10000 Maximale Anzahl der vom Theme-Scanner geprüften Dateien
blockTags object {} Elementzuordnungen, Tag-Aliase und scanPhp für die Block-Tag-Regel

Diese Einstellungen steuern den kanonischen Befehl blockstudio-phpstan. Vorgaben, Ebenen und Einführung findest du unter PHPStan.

ai

Option Typ Standard Beschreibung
enableContextGeneration boolean false Eine kombinierte Kontextdatei mit Blöcken, Einstellungen, Schemas und Dokumentation für LLM-Tools erzeugen

Den Dokumentationsindex und den vollständig generierten Text findest du unter KI-Integration.

UI Komponenten

Aktiviere und kombiniere die enthaltenen Headless-UI-Komponenten, die mit Blockstudio 7.3 eingeführt wurden.