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:
{
"$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.
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:
- Integrierte Standardwerte
- Über den Adminbereich gespeicherte Einstellungen UI (die Option
blockstudio_settings) blockstudio.jsonim Themeblockstudio/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:
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:
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:
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:
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/*.
{
"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:
{
"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.
{
"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.
{
"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.
Aktiviere und kombiniere die enthaltenen Headless-UI-Komponenten, die mit Blockstudio 7.3 eingeführt wurden.