Přejít k obsahu

Nastavení

Blockstudio nabízí výkonnou vrstvu nastavení API, která umožňuje definovat možnosti v souboru blockstudio.json ve složce šablony a/nebo pomocí filtrů. Uživatelé s příslušnými oprávněními mohou navíc nastavení měnit vizuálně v administraci.

Přes JSON

Pokud se ve složce šablony nachází soubor blockstudio.json, použije se k nastavení výchozích možností pro aktuální web. K dispozici je schéma JSON k ověření souboru a k podpoře automatického doplňování v IDE.

Soubor není povinný. Pokud chybí, Blockstudio použije nastavení uložená v administraci a svá vestavěná výchozí nastavení. Přidání, změna nebo odebrání souboru se rozpozná automaticky, takže není nutné mazat mezipaměť ani ručně obnovovat stránku.

K dispozici jsou následující vlastnosti:

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

Přes filtry

Místo toho můžete použít filtr blockstudio/settings/${setting} a nastavit možnosti přes PHP s větší flexibilitou.

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

Možnosti nastavené pomocí filtru blockstudio/settings/${setting} mají přednost před možnostmi nastavenými v souboru blockstudio.json. Oba způsoby lze použít současně.

Hodnoty za běhu zpřístupňují také filtry blockstudio/performance/${setting} a jeden závěrečný filtr blockstudio/performance/config. Ten musí vracet platný konfigurační objekt.

Jak se zdroje skládají

Načtou se všechny zdroje a sloučí se od nejnižší priority:

  1. Vestavěná výchozí nastavení
  2. Nastavení uložená přes UI administrace (možnost blockstudio_settings)
  3. blockstudio.json v šabloně
  4. Filtry blockstudio/settings/*

blockstudio.json přepisuje pouze klíče, které definuje. Dříve zcela nahrazoval uložená nastavení, takže hodnota uložená v administraci přestala platit, jakmile se soubor objevil; nyní se přidává nad ně. Druhou stranou je, že zastaralá hodnota uložená přes administraci UI se dál používá, dokud soubor nedefinuje daný klíč nebo uloženou hodnotu neodstraníte. Pokud se nastavení chová jinak, než uvádí soubor, zkontrolujte uloženou vrstvu pomocí wp bs settings nebo Settings::get_raw(), které vrací pouze to, co aktivní zdroj JSON nebo možností výslovně definoval.

Čtení nastavení z PHP

Blockstudio\Settings načte aktivní zdroj, nahlásí chybně formátované JSON a automaticky se znovu načte při změně 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);
}

Použijte Settings::get_raw(), pokud integrace potřebuje pouze hodnoty výslovně určené aktivním zdrojem JSON nebo možností. Settings::fingerprint() vrací deterministickou identitu efektivního nastavení. Dlouho běžící procesy mohou výslovným zavoláním Settings::reload() okamžitě načíst změnu souboru. Běžný přístup kontroluje soubor nejvýše jednou za sekundu v rámci požadavku nebo dlouho běžícího procesu PHP, a to i při úpravách se stejnou velikostí. Změna konfigurované cesty se projeví při příštím čtení. Pokud není aktivní žádný soubor JSON, načtení uloženého nastavení z databáze toto okno nezpozdí.

Vyřešený profil výkonu je dostupný přes Blockstudio\Runtime_Settings::current(). Podporuje cesty oddělené lomítkem nebo tečkou:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

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

Dostupná nastavení

users

Možnost Typ Výchozí hodnota Popis
ids pole [] ID uživatelů s přístupem k editoru
roles pole [] Uživatelské role s přístupem k editoru

assets

Možnost Typ Výchozí hodnota Popis
enqueue boolean true Automaticky zařadit prostředky bloků do fronty
reset.enabled boolean false Odebrat styly základních bloků a použít reset nástrojů editoru
reset.fullWidth array [] Typy příspěvků používající rozvržení editoru na celou šířku
minify.css boolean false Minifikovat výstup CSS
minify.js boolean false Minifikovat výstup JS
process.scss boolean false Zpracovávat soubory SCSS
output string source Umístění zkompilovaných prostředků: source nebo cache
inlineLimit integer 0 Počet bajtů externích stylů bloků CSS vložených přímo na stránku

output má ve výchozím nastavení hodnotu source, která vytváří adresář _dist vedle každého bloku. Nastavte ji na cache, chcete-li ukládat zkompilované prostředky do adresáře mezipaměti Blockstudio, aby strom zdrojových souborů bloků zůstal čistý a bylo možné jej nasadit z neměnného checkoutu. Zdroje Blockstudio, které nelze zapisovat, se do mezipaměti přesměrovávají bez ohledu na toto nastavení.

inlineLimit je vypnuté při hodnotě 0, takže každý externí stylopis zachová svůj tag <link>. Nastavte počet bajtů, chcete-li místo toho vložit přímo na stránku nejmenší externí styly bloků, pokud jejich celková velikost nepřekročí tento limit. 40000 je limit, který WordPress používá pro stejné pravidlo. Další informace najdete v části Vkládání malých stylopisů.

Když je aktivní reset.enabled, Blockstudio také kopíruje vyčištěné hodnoty frontendových tříd body_class do plátna editoru. Seznam tříd používaný pouze v editoru upravte pomocí blockstudio/editor/canvas/body_class.

cache

Možnost Typ Výchozí hodnota Popis
enabled boolean true Povolit mezipaměti založené na souborech Blockstudio
path string "blockstudio/cache" Cesta k mezipaměti, relativní k WP_CONTENT_DIR nebo absolutní
namespaceGrace integer 86400 Počet sekund, po které se vyřazený jmenný prostor mezipaměti uchovává před odstraněním

Ve výchozím nastavení se soubory mezipaměti zapisují do wp-content/blockstudio/cache mimo adresář nahraných souborů. Relativní cesta path se určuje vzhledem k WP_CONTENT_DIR; absolutní cesta se použije přímo. Díky tomu lze využít hosting s vyhrazeným zapisovatelným svazkem mezipaměti.

Je-li tato možnost povolena, Blockstudio používá tento jediný kořenový adresář pro sestavené datové části, předem sestavená registrační data bloků, vyřešené prostředky editoru, Tailwind CSS, vykreslené dokumenty, fragmenty ostrovů, staticky předvykreslené stránky, indexy grafů, fronty a diagnostické údaje. Každý objekt je oddělen podle sítě, webu, úplné identity běhového prostředí a rozsahu. Identity běhového prostředí zahrnují Blockstudio, nastavení, WordPress, PHP, aktivní šablonu, aktivní pluginy, logické zdroje zjišťování, kontext hostitele a explicitní hash hodnoty závislostí dodané vlastníkem operace.

Změny obsahu, termínu, uživatele a metadat zneplatní naplněné možnosti polí, nikoli strukturální vyhledávání bloků nebo sestavené prostředky. Možnosti se obnovují samostatně pod zámkem pevně dané cesty sestavení. Série zápisů, například synchronizace překladů nebo import, se slučuje: první zápis po klidovém období spustí obnovení okamžitě a poslední zápis ze série se projeví po uplynutí třiceti sekund; interval lze upravit pomocí blockstudio/cache/populate_debounce. Metadata, která WordPress zapisuje jako evidenci, například zámek úprav příspěvku, se za změnu nepovažují; seznam rozšiřuje blockstudio/cache/populate_ignored_meta_keys. Editor vždy načítá aktuální možnosti, takže časové okno ovlivňuje pouze možnosti z mezipaměti načtené při vykreslení. Zdrojové soubory a nastavení sestavení zneplatňují strukturální mezipaměť běžným způsobem. Přepsání možností při každé změně obsahu znovu neprohledává adresář mezipaměti; pravidelné čištění stále odstraňuje osiřelé dočasné soubory. Identity běhu specifické pro jazyk zůstávají oddělené; více adresářů jmenných prostorů mezipaměti na vícejazyčném webu samo o sobě nedokazuje, že došlo k minutí mezipaměti.

Aktivita žurnálu SQLite uvnitř datového adresáře bloku db neodstraňuje metadata bloku z mezipaměti. Změny v db.php, sledovaných zdrojových souborech nebo ve struktuře zdrojových souborů a podadresářů datového adresáře mezipaměť nadále zneplatňují.

Při souběžném opětovném sestavení běhového prostředí je zvolen jeden proces, který sestavení provede. Ostatní požadavky čekají až pět sekund a poté znovu použijí poslední platná metadata bloků, pokud jejich zdrojové soubory a požadované zkompilované prostředky stále existují. Požadavek při studeném spuštění bez bezpečné datové části vrátí HTTP 503 s Retry-After místo spuštění dalšího sestavení. Filtr blockstudio/cache/build_wait_budget upravuje čekání v milisekundách pro strukturální sestavení i obnovu možností. Hostitel bez poradních zámků souborů obnoví možnosti bez ochrany a přesto je zveřejní, takže další požadavek zasáhne do mezipaměti.

Neaktivní soubory zámků .build.lock pro jednotlivé klíče, které zůstaly po starších verzích, se napříč jmennými prostory mezipaměti tohoto webu odstraňují pomocí WP-Cron. Čištění začne pět minut po aktualizaci a v rámci desetisekundového limitu odstraní až 10,000 zámků za minutu. wp bs cache status uvádí zbývající počet a wp bs cache cleanup okamžitě vyčistí nevyřízené zámky; wp bs cache clear vymaže běhovou mezipaměť. Pokud je naplánovaná dávka kvůli nefunkčnímu cron zpožděná o více než deset minut, požadavky jednou za hodinu projdou omezený počet zámků, aby se čištění nezastavilo. Nedávné nebo držené zámky zůstanou nedotčené a nové zámky pevné cesty se nikdy neodstraňují. Po vyčištění nevyřízených zámků stejná dávka odstraní opuštěné jmenné prostory mezipaměti, jakmile uplyne jejich namespaceGrace, nejvýše jednou za hodinu na web; čištění se spouští také jednou denně. Tato lhůta se počítá od prvního průchodu, který zjistí, že jmenný prostor byl vyřazen, nikoli od data jeho nejnovějšího souboru. Jmenný prostor, který je stále aktuální v kterémkoli ze svých rozsahů, se nikdy neodstraní. Interní čištění mezipaměti nespouští filtry WordPress pro odstraňování příloh. Hostitelé s vypnutým WP-Cron by měli dál spouštět svůj obvyklý plánovaný pracovní proces cron; živé soubory zámků nemažte bez rozmyslu, abyste vyčistili nevyřízené zámky.

Filtr nastavení blockstudio/settings/cache/path mění nakonfigurovanou hodnotu. Pro rozlišení cest podle nasazení použijte blockstudio/cache/dir, který filtruje vyřešený základní adresář:

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

Hostitelé, u kterých se identita tenanta liší od ID sítě/blogu WordPress, mohou filtrovat blockstudio/cache/site_key. Výsledek se očistí a použije pouze jako část názvu adresáře. blockstudio/cache/context zůstává správným místem pro serializovatelnou variantu běhového prostředí, která musí změnit identity objektů.

themeDefaults

Možnost Typ Výchozí hodnota Popis
titleTag boolean false Povolit podporu značky title v šabloně WordPress
suppressDirectoryUpdates boolean false Odebrat aktivní podřízené a nadřazené šablony z výsledků aktualizace adresářů

Vzory nadále používají stávající Blockstudio\Patterns API; tato výchozí nastavení nepřidávají alternativní fasády stránek ani vzorů.

performance

Profil compat ponechává obecné chování WordPress beze změny. speed a strict povolují stejná volitelná výchozí nastavení frontendu; každé podřízené nastavení může hodnotu profilu přepsat.

Volitelná nastavení fungují jako podmínky registrace. Když je volitelná funkce false, Blockstudio nepřipojí její callbacky pro frontend, administraci, editor, REST ani plánované úlohy. Po vypnutí funkce Early Serve nebo plánovaného zahřívání se jednou provede úklid prostředků, které funkce spravovala; další požadavky už žádnou činnost neprovedou.

Možnost Typ Výchozí hodnota v režimu kompatibility Výchozí hodnota v režimu rychlosti/přísnosti Popis
profile string "compat" Nepoužije se compat, speed nebo strict
wordpress.headNoise boolean false true Odebere obecné objevování v hlavičce a výstup emoji
wordpress.embeds boolean false true Odebere objevování oEmbed a skripty hostitele
wordpress.xmlrpc boolean false true Zakáže XML-RPC a pingbacky
wordpress.editor boolean false true Zakáže vzdálené plochy pro objevování editoru
wordpress.frontendAssets boolean false true Odebere obecné prostředky jádra pro frontend
wordpress.media boolean false true Použije výchozí nastavení výstupu obrázků
wordpress.heartbeat boolean false true Omezí Heartbeat mimo editory
preload.links string "off" "intent" Po záměru uživatele přednačte dokumenty stejného původu
media.lazy boolean false true Použije načítání obrázků v Blockstudio
media.skeleton boolean false true Zobrazí vestavěnou kostru načítání
media.metadata boolean false true Deklaruje použití assets/media.json
media.rootMargin string "300px" "300px" Okraj průsečíku pro líné načítání
measurement.enabled boolean false false Povolí API pro měření za běhu
measurement.queryMonitor boolean false false Zahrne dotazy trvající alespoň 50ms
measurement.headers boolean false false Odešle hlavičky s hashem profilu a konfigurace
measurement.timings boolean false false Odešle hlavičku s dobou běhu
staticPrerender.enabled boolean false false Povolí ukládání do mezipaměti HTML bezpečné pro anonymní uživatele
staticPrerender.ttl integer 86400 86400 Maximální stáří dokumentu v mezipaměti v sekundách
staticPrerender.invalidate string "signature" "signature" Použije identitu signature nebo inkrementální graph
staticPrerender.earlyServe boolean false false Bezpečné výsledky poskytne ještě před spuštěním WordPress
staticPrerender.serveLoggedIn boolean false false Umožní uživatelům výsledky z mezipaměti používat, nikoli vytvářet
staticPrerender.dynamicPaths array [] [] Prefixy cest, které musí zůstat dynamické
staticPrerender.replayHeaders array ["Link"] ["Link"] Hlavičky odpovědi ukládané spolu s výsledky a odesílané při jejich použití
staticPrerender.warm.enabled boolean false false Povolí trvalou plánovanou frontu zahřívání
staticPrerender.warm.interval integer 3600 3600 Interval zahřívání v sekundách
staticPrerender.warm.concurrency integer 2 2 Maximální počet úloh zpracovaných během jednoho průchodu zahřívání
staticPrerender.warm.transport string "http" "http" Použije http nebo renderer poskytovaný hostitelem internal

Statické předběžné vykreslování zůstává vypnuté, dokud ho výslovně nepovolíte. Vypnutý hlavní přepínač neregistruje žádné háčky požadavků na předběžné vykreslování a vypnuté přepínače earlyServe a warm.enabled neregistrují žádné administrátorské ani háčky cron. Režim podpisu používá při běžných požadavcích levnou aktivovanou identitu. Režim grafu je určen pro explicitní sestavení: zaznamenává závislosti zdrojů jednotlivých stránek, takže změna jedné stránky nezneplatní nesouvisející dokumenty. Informace o zahřívání, nasazení, předčasném poskytování a bezpečnosti najdete v tématu Statické předběžné vykreslování.

Měření jsou dostupná programově:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Když jsou hlavičky povolené, Blockstudio odesílá X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config a případně X-Blockstudio-Performance-Time. Akce blockstudio/performance/measurement_enabled obdrží vyřešená nastavení běhového prostředí.

Možnosti media řídí bs_media_image(), manifest assets/media.json a líný načítač frontendu. Pomocnou funkci, generátor manifestu a chování načítače najdete v tématu Média.

content

Možnost Typ Výchozí hodnota Popis
enabled boolean false Povolí konfiguraci Content Sync
id string "default" Jmenný prostor sady obsahu ukládaný do synchronizovaných entit
path string "content" Adresář souborů obsahu relativní k šabloně
includePageSyncManaged boolean false Zahrne příspěvky spravované Page Sync, aniž by převzala správu jejich obsahu
authors string "ignore" Zpracování autorů (ignore nebo login existujícího uživatele)
postTypes array [] Povolené typy příspěvků
meta.include array [] Glob vzory klíčů meta dat k synchronizaci
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Glob vzory klíčů meta dat k vyloučení
meta.references object {} Deklarované odkazy na meta data přepisované mezi ID a UID
taxonomies array [] Povolené registrované taxonomie pro výrazy a vztahy
media string "manifest" Chování odkazů na přílohy (manifest nebo none)

Content Sync se spravuje prostřednictvím wp bs content a převádí povolené příspěvky, postmeta a deklarované odkazy na přenositelné soubory. Pracovní postup a formát souborů najdete v tématu Content Sync.

editor

Možnost Typ Výchozí hodnota Popis
formatOnSave boolean false Při uložení formátuje block.json
assets array [] Další prostředky k načtení v editoru
markup boolean false Povolí úpravy značek

tailwind

Možnost Typ Výchozí hodnota Popis
enabled boolean false Povolí kompilaci Tailwind CSS
config string "" Konfigurace Tailwind v4 zaměřená na CSS

Informace o chování kompilace a formátu konfigurace zaměřené na CSS najdete v tématu Tailwind CSS.

blockTags

Možnost Typ Výchozí hodnota Popis
enabled boolean false Povolí vykreslování značek bs: na úrovni stránky v obsahu příspěvků a oblastech widgetů
allow array [] Seznam povolených vzorů názvů bloků; podporuje zástupné znaky fnmatch()
deny array [] Seznam zakázaných vzorů názvů bloků; má přednost před allow
prefixes object {} Prefix pro zkrácené názvy, každá hodnota je jmenný prostor nebo seřazené pole

Vykreslování značek na úrovni šablony je vždy aktivní; tyto možnosti řídí nahrazování na úrovni stránky. Syntaxi značek a pravidla rozlišení najdete v tématu Vykreslování.

ui

Možnost Typ Výchozí hodnota Popis
enabled boolean false Zaregistruje přibalené komponenty bsui/* UI a ukázkové aplikace app/*

blockEditor

Možnost Typ Výchozí hodnota Popis
disableLoading boolean false Zakáže načítání bloků v editoru
enhance boolean false Povolí funkce Blockstudio editoru při najetí a výběru
cssClasses array [] URL šablon stylů, ze kterých se extrahují třídy CSS pro automatické doplňování v poli tříd
cssVariables array [] URL šablon stylů, ze kterých se extrahují proměnné CSS pro automatické doplňování v poli kódu

blockEditor.blocks

Pro zásady vkládání bloků v celém projektu použijte blockEditor.blocks. allow a deny přijímají názvy bloků a vzory se zástupnými znaky, například 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 ruší registraci stylů zaregistrovaných prostřednictvím registru stylů bloků PHP od WordPress:

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

blockEditor.patterns

Pomocí blockEditor.patterns zakažte globální zdroje vzorů a filtrujte kategorie vzorů.

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

blockEditor.media

Pro zásady vkládání médií v celém projektu použijte blockEditor.media.

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

dev

Možnost Typ Výchozí hodnota Popis
grab.enabled boolean false Povolí nástroj pro výběr prvků ve frontendu
perf boolean false Povolí profiler výkonu při každém načtení stránky
canvas.enabled boolean false Povolí plátno
canvas.adminBar boolean true Při prohlížení plátna zobrazí administrátorský panel WordPress

githooks

Možnost Typ Výchozí hodnota Popis
commit boolean false Při spuštění blockstudio-githooks sync vytvoří předběžný potvrzovací háček určený pouze k analýze

Informace o tom, co generovaný háček spouští a jak zůstává synchronizovaný, najdete v tématu Spravovaný potvrzovací háček.

phpstan

Možnost Typ Výchozí hodnota Popis
preset string "base" Předvolba analýzy, pokud ji příkazový řádek neurčí: base, theme, extreme-theme nebo wordpress-render
configuration string "" Konfigurace projektu PHPStan zahrnutá vedle předvolby, určená z blockstudio.json
roots array ["."] Kořeny šablon analyzované kanonickým příkazem
excludePaths array [] Další vyloučení skeneru relativní ke každému nakonfigurovanému kořeni
maxFiles integer 10000 Maximální počet souborů kontrolovaných skenerem šablon
blockTags object {} Mapování prvků, aliasy značek a scanPhp pro pravidlo značek bloku

Tato nastavení řídí kanonický příkaz blockstudio-phpstan. Předvolby, vrstvy a přijetí najdete v tématu PHPStan.

ai

Možnost Typ Výchozí hodnota Popis
enableContextGeneration boolean false Vygeneruje kombinovaný kontextový soubor bloků, nastavení, schémat a dokumentace pro nástroje LLM

Index dokumentace a celý vygenerovaný text najdete v tématu Integrace AI.

UI Komponenty

Povolte a kombinujte přibalené bezhlavé komponenty UI představené ve verzi Blockstudio 7.3.