Ustawienia
Blockstudio zawiera rozbudowany interfejs ustawień API, który pozwala konfigurować opcje za pomocą pliku blockstudio.json w folderze motywu i/lub filtrów. Ponadto uprawnieni użytkownicy mogą zmieniać ustawienia wizualnie w obszarze administracyjnym.
Za pomocą JSON
Jeśli w folderze motywu znajduje się plik blockstudio.json, zostanie użyty do ustawienia domyślnych opcji bieżącej witryny. Dostępny jest schemat JSON, który pozwala zweryfikować plik i ułatwia autouzupełnianie w środowisku IDE.
Plik jest opcjonalny. Jeśli go nie ma, Blockstudio korzysta z ustawień zapisanych w obszarze administracyjnym oraz z wbudowanych wartości domyślnych. Dodanie, zmiana lub usunięcie pliku jest wykrywane automatycznie, więc nie trzeba czyścić pamięci podręcznej ani ręcznie odświeżać strony.
Dostępne są następujące właściwości:
{
"$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
}
}
Za pomocą filtrów
Możesz też użyć filtra blockstudio/settings/${setting}, aby ustawić opcje za pomocą PHP i uzyskać większą elastyczność.
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');
Opcje ustawione za pomocą filtra blockstudio/settings/${setting} zastępują te z pliku blockstudio.json. Można korzystać z obu metod jednocześnie.
Wartości czasu wykonania udostępniają również filtry blockstudio/performance/${setting} i jeden
końcowy filtr blockstudio/performance/config. Ten ostatni musi zwracać prawidłowy
obiekt konfiguracji.
Kolejność nakładania źródeł
Wszystkie źródła są wczytywane i łączone, począwszy od tego o najniższym priorytecie:
- Wbudowane wartości domyślne
- Ustawienia zapisane w panelu administracyjnym UI (opcja
blockstudio_settings) blockstudio.jsonw motywie- Filtry
blockstudio/settings/*
blockstudio.json zastępuje tylko zadeklarowane klucze. Wcześniej całkowicie zastępował zapisane ustawienia, więc niezwiązana wartość zapisana w panelu administracyjnym przestawała obowiązywać po pojawieniu się pliku. Teraz jest nakładany na te ustawienia. Ma to jednak drugą stronę: nieaktualna wartość zapisana w panelu administracyjnym UI nadal obowiązuje, dopóki plik nie zadeklaruje tego klucza lub zapisana wartość nie zostanie usunięta. Jeśli ustawienie działa inaczej, niż wynika z pliku, sprawdź zapisaną warstwę za pomocą wp bs settings lub Settings::get_raw(), które zwraca tylko to, co aktywne źródło JSON lub źródło opcji zadeklarowało jawnie.
Odczytywanie ustawień z PHP
Blockstudio\Settings wczytuje aktywne źródło, zgłasza błędne JSON i automatycznie wczytuje je ponownie po zmianie blockstudio.json:
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);
}
Użyj Settings::get_raw(), gdy integracja wymaga tylko wartości jawnie zadeklarowanych przez aktywne źródło JSON lub źródło opcji. Settings::fingerprint() zwraca deterministyczną tożsamość efektywnej konfiguracji. Procesy długotrwałe mogą jawnie wywołać Settings::reload(), aby natychmiast odczytać zmianę pliku. Podczas zwykłego dostępu plik jest sprawdzany najwyżej raz na sekundę w ramach żądania lub długotrwałego procesu PHP, także po edycjach bez zmiany rozmiaru. Zmiana skonfigurowanej ścieżki zaczyna obowiązywać przy następnym odczycie. Gdy nie jest aktywny żaden plik JSON, zapisane ustawienia bazy danych nie podlegają temu opóźnieniu.
Rozwiązany profil wydajności jest dostępny za pośrednictwem
Blockstudio\Runtime_Settings::current(). Obsługuje ścieżki z ukośnikami i kropkami:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Dostępne ustawienia
users
| Opcja | Typ | Domyślnie | Opis |
|---|---|---|---|
ids |
tablica | [] |
Identyfikatory użytkowników z dostępem do edytora |
roles |
tablica | [] |
Role użytkowników z dostępem do edytora |
assets
| Opcja | Typ | Domyślnie | Opis |
|---|---|---|---|
enqueue |
boolean | true |
Automatyczne dodawanie zasobów bloków do kolejki |
reset.enabled |
boolean | false |
Usuń style bloków core i zastosuj reset narzędzi edytora |
reset.fullWidth |
array | [] |
Typy wpisów korzystające z układu edytora na pełną szerokość |
minify.css |
boolean | false |
Zmniejsz rozmiar wyjścia CSS |
minify.js |
boolean | false |
Zmniejsz rozmiar wyjścia JS |
process.scss |
boolean | false |
Przetwarzaj pliki SCSS |
output |
string | source |
Miejsce zapisu skompilowanych zasobów: source lub cache |
inlineLimit |
integer | 0 |
Liczba bajtów zewnętrznych stylów bloków CSS drukowanych w kodzie strony |
output domyślnie ma wartość source, co powoduje utworzenie katalogu _dist obok każdego bloku. Ustaw wartość cache, aby zapisywać skompilowane zasoby w katalogu pamięci podręcznej Blockstudio, dzięki czemu drzewo źródłowe bloków pozostanie czyste i będzie można je wdrażać z niezmiennej kopii roboczej. Źródła Blockstudio nie mogą zapisywać, dlatego niezależnie od tego ustawienia zawsze przekierowują zapis do pamięci podręcznej.
inlineLimit jest wyłączone w 0, więc każdy zewnętrzny arkusz stylów zachowuje swój znacznik <link>. Ustaw wartość w bajtach, aby zamiast tego umieszczać w kodzie strony najmniejsze zewnętrzne arkusze stylów bloków, o ile ich łączny rozmiar nie przekracza tej wartości. 40000 to limit, którego WordPress core używa dla tej samej reguły. Zobacz Wstawianie małych arkuszy stylów.
Gdy aktywne jest reset.enabled, Blockstudio kopiuje również oczyszczone wartości body_class z interfejsu użytkownika do obszaru edytora. Użyj blockstudio/editor/canvas/body_class, aby dostosować listę klas używaną wyłącznie w edytorze.
cache
| Opcja | Typ | Domyślnie | Opis |
|---|---|---|---|
enabled |
boolean | true |
Włącz pamięci podręczne oparte na plikach Blockstudio |
path |
string | "blockstudio/cache" |
Ścieżka pamięci podręcznej, względna względem WP_CONTENT_DIR lub bezwzględna |
namespaceGrace |
integer | 86400 |
Liczba sekund przechowywania wycofanej przestrzeni nazw pamięci podręcznej przed jej usunięciem |
Domyślnie pliki pamięci podręcznej są zapisywane w wp-content/blockstudio/cache, poza katalogiem przesłanych plików. Względna ścieżka path jest rozwiązywana względem WP_CONTENT_DIR; ścieżka bezwzględna jest używana bezpośrednio. Umożliwia to korzystanie z hostów udostępniających osobny zapisywalny wolumin pamięci podręcznej.
Po włączeniu Blockstudio używa tego jednego katalogu głównego dla danych kompilacji, danych rejestracji wstępnie zbudowanych bloków, rozpoznanych zasobów edytora, Tailwind CSS, dokumentów renderowania, fragmentów wysp, wstępnego renderowania statycznego, indeksów grafów, kolejek i diagnostyki. Każdy obiekt jest odizolowany według sieci, witryny, pełnej tożsamości środowiska wykonawczego i zakresu. Tożsamości środowiska wykonawczego obejmują Blockstudio, ustawienia, WordPress, PHP, aktywny motyw, aktywne wtyczki, logiczne źródła wykrywania, kontekst hosta oraz jawne skróty zależności przekazane przez operację, która jest ich właścicielem.
Zmiany treści, terminów, użytkowników i metadanych unieważniają wypełnione wybory pól, ale nie wykrywanie struktury bloków ani skompilowane zasoby. Wybory są odświeżane osobno, z blokadą stałej ścieżki kompilacji. Seria zapisów, na przykład synchronizacja tłumaczeń lub import, jest łączona: pierwszy zapis po okresie bezczynności odświeża dane od razu, a ostatni zapis z serii jest uwzględniany po upływie trzydziestu sekund, z możliwością zmiany tej wartości za pomocą blockstudio/cache/populate_debounce. Metadane, które WordPress zapisuje w celach porządkowych, na przykład blokada edycji wpisu, nie są uznawane za zmianę; blockstudio/cache/populate_ignored_meta_keys rozszerza tę listę. Edytor zawsze pobiera aktualne opcje, więc ten przedział czasu wpływa tylko na wybory odczytywane z pamięci podręcznej podczas renderowania. Pliki źródłowe i ustawienia kompilacji nadal standardowo unieważniają pamięć podręczną struktury. Nadpisywanie wyborów nie powoduje ponownego skanowania katalogu pamięci podręcznej przy każdej zmianie treści; okresowe czyszczenie nadal usuwa osierocone pliki tymczasowe. Tożsamości środowiska wykonawczego pozostają odizolowane dla poszczególnych języków; wiele katalogów przestrzeni nazw pamięci podręcznej w witrynie wielojęzycznej samo w sobie nie świadczy o chybieniu pamięci podręcznej.
Aktywność dziennika SQLite w katalogu danych bloku db nie usuwa z pamięci podręcznej metadanych bloku. Zmiany w db.php, obserwowanych plikach źródłowych lub strukturze plików źródłowych i podkatalogów katalogu danych nadal unieważniają pamięć podręczną.
Przy równoczesnym przebudowywaniu środowiska wykonawczego wybierany jest jeden proces budujący. Pozostałe żądania czekają do pięciu sekund, a następnie używają ostatnich poprawnych metadanych bloków, jeśli ich pliki źródłowe i wymagane skompilowane zasoby nadal istnieją. Żądanie przy zimnym starcie, bez bezpiecznego ładunku, zwraca HTTP 503 z Retry-After zamiast rozpoczynać kolejną kompilację. Filtr blockstudio/cache/build_wait_budget dostosowuje czas oczekiwania w milisekundach zarówno przy przebudowie struktury, jak i odświeżaniu opcji. Host bez doradczych blokad plików odświeża opcje bez zabezpieczenia i nadal je publikuje, dzięki czemu następne żądanie trafia w pamięć podręczną.
Nieaktywne pliki .build.lock z kluczami specyficznymi dla klucza, pozostałe po wcześniejszych wersjach, są usuwane ze wszystkich przestrzeni nazw pamięci podręcznej tej witryny przez WP-Cron. Proces rozpoczyna się pięć minut po aktualizacji i usuwa do 10,000 blokad na minutę w ramach dziesięciosekundowego limitu. wp bs cache status podaje liczbę pozostałych, a wp bs cache cleanup natychmiast opróżnia kolejkę; wp bs cache clear czyści pamięć podręczną środowiska wykonawczego. Jeśli zaplanowana partia jest opóźniona o ponad dziesięć minut, ponieważ cron nie działa, żądania raz na godzinę przeglądają ograniczoną liczbę blokad, aby opróżnianie nie utknęło. Niedawne lub używane blokady są pozostawiane bez zmian, a nowe blokady o stałej ścieżce nigdy nie są usuwane. Po opróżnieniu kolejki ta sama partia usuwa porzucone przestrzenie nazw pamięci podręcznej po upływie ich namespaceGrace, najwyżej raz na godzinę w każdej witrynie, i zachowuje codzienne uruchomienie tego procesu. Okres karencji liczy się od pierwszego przeglądu, który wykryje wycofaną przestrzeń nazw, a nie od daty jej najnowszego pliku. Przestrzeń nazw, która nadal jest bieżąca dla dowolnego zakresu, nigdy nie jest usuwana.
Wewnętrzne czyszczenie pamięci podręcznej nie uruchamia filtrów usuwania załączników WordPress.
Hosty z wyłączonym WP-Cron powinny nadal uruchamiać zwykły zaplanowany proces roboczy cron; nie usuwaj bez rozróżnienia aktywnych plików blokad, aby opróżnić kolejkę.
Filtr ustawienia blockstudio/settings/cache/path zmienia skonfigurowaną wartość. Aby rozwiązać ścieżkę zależnie od wdrożenia, filtr blockstudio/cache/dir modyfikuje rozpoznany katalog bazowy:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Hosty, w których tożsamość dzierżawcy różni się od identyfikatorów sieci/bloga WordPress, mogą filtrować blockstudio/cache/site_key. Wynik jest oczyszczany i używany wyłącznie jako segment katalogu. blockstudio/cache/context pozostaje właściwym miejscem na serializowalny wariant środowiska wykonawczego, który musi zmieniać tożsamości obiektów.
themeDefaults
| Opcja | Typ | Domyślnie | Opis |
|---|---|---|---|
titleTag |
boolean | false |
Włącz obsługę znacznika tytułu WordPress motywu |
suppressDirectoryUpdates |
boolean | false |
Usuń aktywne motywy potomne i nadrzędne z wyników aktualizacji katalogu |
Wzorce nadal korzystają z istniejącego Blockstudio\Patterns API; te wartości domyślne nie wprowadzają alternatywnych interfejsów stron ani wzorców.
performance
Profil compat pozostawia ogólne działanie WordPress bez zmian. speed i strict włączają te same opcjonalne wartości domyślne interfejsu użytkownika; każde ustawienie podrzędne może zastąpić wartość profilu.
Ustawienia opcjonalne pełnią funkcję bramek rejestracji. Gdy opcjonalna funkcja jest false, Blockstudio nie podłącza jej do interfejsu użytkownika, panelu administracyjnego, edytora, REST ani zaplanowanych wywołań zwrotnych. Wyłączenie Early Serve lub zaplanowanego podgrzewania po ich użyciu powoduje jednokrotne wykonanie przypisanego im czyszczenia; kolejne żądania pozostają nieaktywne.
| Opcja | Typ | Domyślna zgodność | Domyślna szybkość/ścisłość | Opis |
|---|---|---|---|---|
profile |
string | "compat" |
Nie dotyczy | compat, speed lub strict |
wordpress.headNoise |
boolean | false |
true |
Usuwa ogólne wykrywanie w sekcji head i wyświetlanie emoji |
wordpress.embeds |
boolean | false |
true |
Usuwa wykrywanie oEmbed i skrypty hosta |
wordpress.xmlrpc |
boolean | false |
true |
Wyłącza XML-RPC i pingbacki |
wordpress.editor |
boolean | false |
true |
Wyłącza zdalne powierzchnie wykrywania edytora |
wordpress.frontendAssets |
boolean | false |
true |
Usuwa ogólne zasoby frontendu rdzenia |
wordpress.media |
boolean | false |
true |
Stosuje domyślne ustawienia wyjściowe obrazów |
wordpress.heartbeat |
boolean | false |
true |
Ogranicza częstotliwość Heartbeat poza edytorami |
preload.links |
string | "off" |
"intent" |
Wstępnie pobiera dokumenty z tej samej domeny po intencji użytkownika |
media.lazy |
boolean | false |
true |
Używa modułu ładującego obrazy Blockstudio |
media.skeleton |
boolean | false |
true |
Wyświetla wbudowany szkielet ładowania |
media.metadata |
boolean | false |
true |
Deklaruje użycie assets/media.json |
media.rootMargin |
string | "300px" |
"300px" |
Margines przecięcia dla leniwego ładowania |
measurement.enabled |
boolean | false |
false |
Włącza interfejsy API do pomiarów w czasie działania |
measurement.queryMonitor |
boolean | false |
false |
Uwzględnia zapytania trwające co najmniej 50ms |
measurement.headers |
boolean | false |
false |
Wysyła nagłówki z profilem i skrótem konfiguracji |
measurement.timings |
boolean | false |
false |
Wysyła nagłówek z czasem działania |
staticPrerender.enabled |
boolean | false |
false |
Włącza buforowanie HTML bezpieczne dla anonimowych użytkowników |
staticPrerender.ttl |
integer | 86400 |
86400 |
Maksymalny wiek buforowanego dokumentu w sekundach |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Używa tożsamości signature lub przyrostowej graph |
staticPrerender.earlyServe |
boolean | false |
false |
Udostępnia bezpieczne trafienia w pamięci podręcznej, zanim uruchomi się WordPress |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Pozwala użytkownikom korzystać z trafień w pamięci podręcznej, ale nie ich tworzyć |
staticPrerender.dynamicPaths |
array | [] |
[] |
Prefiksy ścieżek, które muszą pozostać dynamiczne |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Nagłówki odpowiedzi przechowywane wraz z trafieniami w pamięci podręcznej i wysyłane przy ich zwracaniu |
staticPrerender.warm.enabled |
boolean | false |
false |
Włącza trwałą, zaplanowaną kolejkę rozgrzewania |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Odstęp między rozgrzewaniami w sekundach |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Maksymalna liczba zadań przetwarzanych podczas jednego przebiegu rozgrzewania |
staticPrerender.warm.transport |
string | "http" |
"http" |
Używa http lub renderera udostępnionego przez hosta internal |
Statyczne renderowanie wstępne pozostaje wyłączone, chyba że zostanie jawnie włączone. Wyłącznik główny w pozycji wyłączonej nie rejestruje żadnych hooków żądań renderowania wstępnego, a wyłączone przełączniki earlyServe i warm.enabled nie rejestrują żadnych hooków administratora ani cron. Tryb sygnatur używa taniej, aktywowanej tożsamości przy zwykłych żądaniach. Tryb grafu jest przeznaczony do jawnych kompilacji: zapisuje zależności źródłowe poszczególnych stron, dzięki czemu zmiana jednej strony nie unieważnia niezwiązanych dokumentów. Zobacz Renderowanie wstępne statyczne, aby poznać szczegóły rozgrzewania, wdrażania, wczesnego serwowania i bezpieczeństwa.
Pomiary są dostępne programowo:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Gdy nagłówki są włączone, Blockstudio wysyła
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config i opcjonalnie
X-Blockstudio-Performance-Time. Akcja
blockstudio/performance/measurement_enabled otrzymuje rozwiązane ustawienia czasu wykonywania.
Opcje media sterują bs_media_image(), manifestem assets/media.json i frontendowym lazy loaderem. Zobacz Media, aby poznać funkcję pomocniczą, generator manifestu i działanie loadera.
content
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
enabled |
boolean | false |
Włącz konfigurację synchronizacji treści |
id |
string | "default" |
Przestrzeń nazw zestawu treści przechowywana w synchronizowanych encjach |
path |
string | "content" |
Katalog plików treści względem motywu |
includePageSyncManaged |
boolean | false |
Uwzględnij wpisy zarządzane przez Page Sync bez przejmowania ich treści |
authors |
string | "ignore" |
Obsługa autorów (ignore lub istniejący użytkownik login) |
postTypes |
array | [] |
Dozwolone typy wpisów |
meta.include |
array | [] |
Wzorce glob kluczy meta do synchronizacji |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Wzorce glob kluczy meta do wykluczenia |
meta.references |
object | {} |
Zadeklarowane odwołania do meta przepisywane między ID i UID |
taxonomies |
array | [] |
Dozwolone zarejestrowane taksonomie dla terminów i relacji |
media |
string | "manifest" |
Sposób obsługi odwołań do załączników (manifest lub none) |
Synchronizacją treści zarządza się przez wp bs content, które zapisuje dozwolone wpisy,
postmeta i zadeklarowane odwołania w przenośnych plikach. Zobacz
Synchronizacja treści, aby poznać przebieg pracy i format plików.
editor
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
formatOnSave |
boolean | false |
Formatuj block.json przy zapisie |
assets |
array | [] |
Dodatkowe zasoby do załadowania w edytorze |
markup |
boolean | false |
Włącz edycję znaczników |
tailwind
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
enabled |
boolean | false |
Włącz kompilację Tailwind CSS |
config |
string | "" |
Konfiguracja Tailwind v4 CSS-first |
Zobacz Tailwind CSS, aby poznać działanie kompilacji i format konfiguracji CSS-first.
blockTags
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
enabled |
boolean | false |
Włącz renderowanie tagów bs: na poziomie strony w treści wpisu i obszarach widżetów |
allow |
array | [] |
Lista dozwolonych wzorców nazw bloków; obsługuje symbole wieloznaczne fnmatch() |
deny |
array | [] |
Lista zablokowanych wzorców nazw bloków; ma pierwszeństwo przed allow |
prefixes |
object | {} |
Prefiks do tworzenia przestrzeni nazw skrótów; każda wartość to przestrzeń nazw lub uporządkowana tablica |
Renderowanie tagów na poziomie szablonu jest zawsze aktywne; te opcje sterują zastępowaniem na poziomie strony. Zobacz Renderowanie, aby poznać składnię tagów i reguły rozwiązywania.
ui
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
enabled |
boolean | false |
Zarejestruj dołączone komponenty bsui/* UI i aplikacje demonstracyjne app/* |
blockEditor
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
disableLoading |
boolean | false |
Wyłącz ładowanie bloków w edytorze |
enhance |
boolean | false |
Włącz funkcje najechania i zaznaczania w edytorze Blockstudio |
cssClasses |
array | [] |
Adresy URL arkuszy stylów, z których pobierać klasy CSS na potrzeby autouzupełniania w polu klas |
cssVariables |
array | [] |
Adresy URL arkuszy stylów, z których pobierać zmienne CSS na potrzeby autouzupełniania w polu kodu |
blockEditor.blocks
Użyj blockEditor.blocks do określenia globalnych zasad wstawiania bloków w projekcie. allow i deny przyjmują nazwy bloków oraz wzorce z symbolami wieloznacznymi, takie jak 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 wyrejestrowuje style zarejestrowane w rejestrze stylów bloków WordPress’
PHP:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Użyj blockEditor.patterns, aby wyłączyć globalne źródła wzorców i filtrować
kategorie wzorców.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Użyj blockEditor.media do określenia globalnych zasad wstawiania mediów.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
grab.enabled |
boolean | false |
Włącz pobieranie elementów z frontendu |
perf |
boolean | false |
Włącz profilowanie wydajności przy każdym ładowaniu strony |
canvas.enabled |
boolean | false |
Włącz kanwę |
canvas.adminBar |
boolean | true |
Pokaż pasek administratora WordPress podczas przeglądania kanwy |
githooks
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
commit |
boolean | false |
Generuj hook pre-commit służący wyłącznie do analizy, gdy uruchamia się blockstudio-githooks sync |
Zobacz zarządzany hook commit, aby dowiedzieć się, co uruchamia wygenerowany hook i jak pozostaje zsynchronizowany.
phpstan
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
preset |
string | "base" |
Domyślny zestaw analiz, gdy w wierszu poleceń nie wybrano żadnego: base, theme, extreme-theme lub wordpress-render |
configuration |
string | "" |
Konfiguracja projektu PHPStan dołączana do zestawu, rozwiązywana względem blockstudio.json |
roots |
array | ["."] |
Katalogi główne motywów analizowane przez polecenie kanoniczne |
excludePaths |
array | [] |
Dodatkowe wykluczenia skanera względem każdego skonfigurowanego katalogu głównego |
maxFiles |
integer | 10000 |
Maksymalna liczba plików sprawdzanych przez skaner motywu |
blockTags |
object | {} |
Mapowania elementów, aliasy tagów i scanPhp dla reguły tagów bloków |
Te ustawienia sterują kanonicznym poleceniem blockstudio-phpstan. Zobacz
PHPStan, aby poznać zestawy, warstwy i wdrażanie.
ai
| Opcja | Typ | Domyślna wartość | Opis |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Generuj łączony plik kontekstu bloków, ustawień, schematów i dokumentacji dla narzędzi LLM |
Zobacz Integracja z AI, aby znaleźć indeks dokumentacji i pełny wygenerowany tekst.
Włączaj i łącz dołączone komponenty headless UI wprowadzone w Blockstudio 7.3.