Przejdź do treści

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:

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
  }
}

Za pomocą filtrów

Możesz też użyć filtra blockstudio/settings/${setting}, aby ustawić opcje za pomocą PHP i uzyskać większą elastyczność.

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');

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:

  1. Wbudowane wartości domyślne
  2. Ustawienia zapisane w panelu administracyjnym UI (opcja blockstudio_settings)
  3. blockstudio.json w motywie
  4. 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:

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);
}

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:

PHP
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:

PHP
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:

PHP
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/*.

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 wyrejestrowuje style zarejestrowane w rejestrze stylów bloków WordPress’ PHP:

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

UI Komponenty

Włączaj i łącz dołączone komponenty headless UI wprowadzone w Blockstudio 7.3.