Preskočiť na obsah

Nastavenia

Blockstudio obsahuje výkonné rozhranie nastavení API, ktoré umožňuje nastavovať možnosti pomocou súboru blockstudio.json v priečinku témy a/alebo filtrov. Okrem toho môžu používatelia s príslušnými oprávneniami meniť nastavenia vizuálne v administračnej oblasti.

Cez JSON

Ak sa v priečinku témy nachádza súbor blockstudio.json, použije sa na nastavenie predvolených možností aktuálneho webu. K dispozícii je schéma JSON na overenie súboru a podporu automatického dopĺňania v IDE.

Súbor je voliteľný. Ak chýba, Blockstudio použije nastavenia uložené v administračnej oblasti spolu so vstavanými predvolenými hodnotami. Pridanie, zmena alebo odstránenie súboru sa zistí automaticky, takže nie je potrebné vymazať vyrovnávaciu pamäť ani súbor ručne znova načítať.

K dispozícii sú tieto 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
  }
}

Pomocou filtrov

Ďalšou možnosťou je použiť filter blockstudio/settings/${setting} a nastaviť možnosti pomocou PHP, čo poskytuje väčšiu flexibilitu.

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é pomocou filtra blockstudio/settings/${setting} majú prednosť pred možnosťami nastavenými pomocou súboru blockstudio.json. Oba spôsoby možno používať súčasne.

Hodnoty za behu sprístupňujú aj filtre blockstudio/performance/${setting} a jeden záverečný filter blockstudio/performance/config. Ten musí vrátiť platný konfiguračný objekt.

Poradie vrstiev zdrojov

Načíta sa každý zdroj a zlúči sa s ostatnými, pričom sa začína zdrojom s najnižšou prioritou:

  1. Vstavané predvolené hodnoty
  2. Nastavenia uložené cez administrátorskú UI (možnosť blockstudio_settings)
  3. blockstudio.json v téme
  4. Filtre blockstudio/settings/*

blockstudio.json prepíše iba kľúče, ktoré deklaruje. Predtým úplne nahradil uložené nastavenia, takže po objavení súboru sa prestala uplatňovať nesúvisiaca hodnota uložená v administrácii; teraz sa použije ako ďalšia vrstva nad nimi. Druhou stranou je, že zastaraná hodnota uložená cez administrátorskú UI sa naďalej uplatňuje, kým súbor nedeklaruje daný kľúč alebo sa uložená hodnota neodstráni. Ak sa nastavenie správa inak, než uvádza súbor, skontrolujte uloženú vrstvu pomocou wp bs settings alebo Settings::get_raw(), ktoré vracia iba hodnoty výslovne deklarované aktívnym zdrojom JSON alebo zdrojom možností.

Čítanie nastavení z PHP

Blockstudio\Settings načíta aktívny zdroj, nahlási chybne formátované JSON a automaticky sa znova načíta pri zmene 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žite Settings::get_raw(), keď integrácia potrebuje iba hodnoty výslovne deklarované v aktívnom zdroji JSON alebo v zdroji možností. Settings::fingerprint() vracia deterministickú identitu efektívnych nastavení. Dlho bežiace procesy môžu výslovne zavolať Settings::reload(), aby sa zmena súboru načítala okamžite. Bežný prístup kontroluje súbor najviac raz za sekundu v rámci požiadavky alebo dlho bežiaceho procesu PHP, a to aj pri úpravách, ktoré nemenia veľkosť súboru. Zmena nakonfigurovanej cesty sa prejaví pri ďalšom čítaní. Keď nie je aktívny žiadny súbor JSON, uložené nastavenia databázy sa počas tohto intervalu neoneskoria.

Rozpoznaný profil výkonu je k dispozícii cez Blockstudio\Runtime_Settings::current(). Podporuje cesty so lomkou aj bodkou:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

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

Dostupné nastavenia

users

Možnosť Typ Predvolené Opis
ids pole [] ID používateľov s prístupom k editoru
roles pole [] Roly používateľov s prístupom k editoru

assets

Možnosť Typ Predvolené Popis
enqueue boolean true Automaticky zaradiť prostriedky blokov do frontu
reset.enabled boolean false Odstrániť štýly základných blokov a použiť reset pomocných tried editora
reset.fullWidth array [] Typy príspevkov používajúce rozloženie editora na celú šírku
minify.css boolean false Minifikovať výstup CSS
minify.js boolean false Minifikovať výstup JS
process.scss boolean false Spracovať súbory SCSS
output string source Miesto zápisu skompilovaných prostriedkov: source alebo cache
inlineLimit integer 0 Počet bajtov externých štýlov blokov CSS vypísaných priamo na každej stránke

output má predvolene hodnotu source, ktorá vytvorí priečinok _dist vedľa každého bloku. Nastavte ju na cache, ak chcete zapisovať skompilované zdroje do priečinka vyrovnávacej pamäte Blockstudio, aby strom zdrojov blokov zostal čistý a bolo možné ho nasadiť z nemenného checkoutu. Zdroje Blockstudio, ktoré už presmerovanie nepodporujú, sa bez ohľadu na toto nastavenie zapisujú do vyrovnávacej pamäte.

inlineLimit je pri hodnote 0 vypnuté, takže každý externý súbor so štýlmi si ponechá značku <link>. Ak chcete namiesto toho vypísať priamo na stránke najmenšie externé súbory so štýlmi blokov, nastavte počet bajtov; ich celková veľkosť sa musí zmestiť do zadaného limitu. 40000 je limit, ktorý WordPress core používa pre rovnaké pravidlo. Pozrite si časť Vkladanie malých súborov so štýlmi.

Keď je aktívne reset.enabled, Blockstudio kopíruje do plátna editora aj očistené hodnoty body_class z frontendu. Pomocou blockstudio/editor/canvas/body_class upravte zoznam tried platný iba v editore.

cache

Možnosť Typ Predvolené Opis
enabled boolean true Povoliť vyrovnávaciu pamäť súborov Blockstudio
path reťazec "blockstudio/cache" Cesta k vyrovnávacej pamäti, relatívna k WP_CONTENT_DIR alebo absolútna
namespaceGrace integer 86400 Počet sekúnd, počas ktorých sa vyradený menný priestor vyrovnávacej pamäte uchová pred odstránením

Súbory vyrovnávacej pamäte sa predvolene zapisujú do wp-content/blockstudio/cache, mimo priečinka nahratých súborov. Relatívna cesta path sa vyhodnocuje vzhľadom na WP_CONTENT_DIR; absolútna cesta sa použije priamo. To umožňuje využívať hostiteľov, ktorí poskytujú vyhradený zapisovateľný zväzok pre vyrovnávaciu pamäť.

Keď je táto možnosť povolená, Blockstudio používa tento jediný koreňový priečinok pre zostavovacie dáta, vopred zostavené registračné údaje blokov, vyriešené zdroje editora, Tailwind CSS, vykreslené dokumenty, fragmenty ostrovov, statické predvykreslenia, grafové indexy, fronty a diagnostiku. Každý objekt je izolovaný podľa siete, webu, úplnej identity behu a rozsahu. Identity behu zahŕňajú Blockstudio, nastavenia, WordPress, PHP, aktívnu tému, aktívne doplnky, logické zdroje zisťovania, kontext hostiteľa a explicitné kontrolné súčty závislostí dodané operáciou, ktorá ich vlastní.

Zmeny obsahu, termínov, používateľov a metadát zneplatnia vyplnené možnosti polí, nie objavovanie štruktúry blokov ani skompilované súbory. Možnosti sa obnovujú samostatne, pod pevným zámkom cesty zostavenia. Súbor zmien, napríklad synchronizácia prekladu alebo import, sa zlúči: prvý zápis po období nečinnosti vyvolá okamžité obnovenie a posledný zápis v súbore sa prejaví po uplynutí tridsiatich sekúnd, pričom tento interval možno upraviť pomocou blockstudio/cache/populate_debounce. Metadáta, ktoré WordPress zapisuje len ako evidenciu, napríklad zámok úpravy príspevku, sa nepovažujú za zmenu; blockstudio/cache/populate_ignored_meta_keys tento zoznam rozširuje. Editor vždy načítava aktuálne možnosti, takže toto časové okno ovplyvňuje len možnosti z vyrovnávacej pamäte načítané pri vykreslení. Zdrojové súbory a nastavenia zostavenia naďalej bežným spôsobom zneplatňujú vyrovnávaciu pamäť štruktúry. Pri prepisovaní možností sa adresár vyrovnávacej pamäte pri každej zmene obsahu znovu neprehľadáva; pravidelné čistenie naďalej odstraňuje osirelé dočasné súbory. Identity behu špecifické pre jednotlivé jazyky zostávajú oddelené; viacero menných priestorov vyrovnávacej pamäte na viacjazyčnom webe samo osebe nedokazuje, že došlo k minutiu vyrovnávacej pamäte.

Aktivita žurnálu SQLite v dátovom adresári bloku db neodstráni metadáta bloku uložené vo vyrovnávacej pamäti. Zmeny v db.php, sledovaných zdrojových súboroch alebo v štruktúre zdrojových súborov a podadresárov dátového adresára naďalej zneplatňujú vyrovnávaciu pamäť.

Pri súbežnom opätovnom zostavovaní behu sa vyberie jeden zostavovateľ. Ostatné požiadavky čakajú najviac päť sekúnd a potom znova použijú naposledy platné metadáta blokov, ak ich zdrojové súbory a požadované skompilované zdroje stále existujú. Studená požiadavka bez bezpečných dát vráti HTTP 503 s Retry-After namiesto spustenia ďalšieho zostavenia. Filter blockstudio/cache/build_wait_budget upravuje dobu čakania v milisekundách pri štrukturálnom zostavovaní aj obnovovaní možností. Hostiteľ bez poradných zámkov súborov obnoví možnosti bez ochrany a aj tak ich zverejní, takže nasledujúca požiadavka ich nájde.

Neaktívne súbory .build.lock špecifické pre kľúč, ktoré zostali po starších verziách, sa zhromažďujú naprieč mennými priestormi vyrovnávacej pamäte tohto webu pomocou WP-Cron. Proces sa začne päť minút po aktualizácii a v rámci desaťsekundového limitu odstráni až 10,000 zámkov za minútu. wp bs cache status nahlási zostávajúci počet a wp bs cache cleanup okamžite spracuje nevybavené zámky, zatiaľ čo wp bs cache clear vymaže vyrovnávaciu pamäť behu. Ak je naplánovaná dávka oneskorená o viac než desať minút, pretože sa nespúšťa cron, požiadavky raz za hodinu skontrolujú obmedzený počet zámkov, aby sa čistenie nezaseklo. Nedávne alebo používané zámky zostanú nedotknuté a nové zámky s pevnou cestou sa nikdy neodstraňujú. Po vyčistení nevybavených zámkov tá istá dávka zhromaždí opustené menné priestory vyrovnávacej pamäte po uplynutí ich namespaceGrace, najviac raz za hodinu na každom webe, pričom sa zachová denný plánovaný interval. Lehota sa počíta od prvého skenovania, pri ktorom sa priestor označí za vyradený, nie od jeho najnovšieho súboru; priestor, ktorý je stále aktuálny pre ktorýkoľvek zo svojich rozsahov, sa nikdy neodstráni. Interné čistenie vyrovnávacej pamäte nevolá filtre odstraňovania príloh WordPress. Hostitelia s vypnutým WP-Cron by mali naďalej spúšťať svoj bežný plánovaný proces cron; na vyčistenie nevybavených zámkov neodstraňujte bez rozmyslu aktívne súbory zámkov.

Filter nastavenia blockstudio/settings/cache/path mení nakonfigurovanú hodnotu. Ak chcete rozlíšiť cesty podľa nasadenia, filter blockstudio/cache/dir mení vyriešený základný priečinok:

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

Hostitelia, ktorých identita tenanta sa líši od ID siete/blogu WordPress, môžu filtrovať blockstudio/cache/site_key. Výsledok sa očistí a použije iba ako segment priečinka. blockstudio/cache/context zostáva správnym miestom na serializovateľný variant behu, ktorý musí meniť identity objektov.

themeDefaults

Možnosť Typ Predvolené Opis
titleTag boolean false Povoliť podporu značky názvu WordPress v téme
suppressDirectoryUpdates boolean false Odstrániť aktívne podtémy a nadradené témy z výsledkov aktualizácie priečinka

Vzory naďalej používajú existujúce Blockstudio\Patterns API; tieto predvolené hodnoty nezavádzajú alternatívne rozhrania stránok ani vzorov.

performance

Profil compat ponecháva všeobecné správanie WordPress nezmenené. speed a strict zapínajú rovnaké predvolené hodnoty frontendu; každé podriadené nastavenie môže prepísať hodnotu profilu.

Nastavenia aktivácie sú registračné brány. Keď je voliteľná funkcia false, Blockstudio nepripojí jej frontend, administráciu, editor, REST ani plánované spätné volania. Vypnutím funkcie Early Serve alebo plánovaného zahrievania po jej použití sa raz vykoná príslušné čistenie; ďalšie požiadavky zostanú neaktívne.

Možnosť Typ Predvolené nastavenie kompatibility Predvolené nastavenie rýchlosti/prísnosti Opis
profile string "compat" Nevzťahuje sa compat, speed alebo strict
wordpress.headNoise boolean false true Odstráni všeobecné zisťovanie hlavičky a výstup emotikonov
wordpress.embeds boolean false true Odstráni zisťovanie oEmbed a skripty hostiteľa
wordpress.xmlrpc boolean false true Zakáže XML-RPC a pingbacky
wordpress.editor boolean false true Zakáže vzdialené plochy na zisťovanie editora
wordpress.frontendAssets boolean false true Odstráni všeobecné zdroje frontendu jadra
wordpress.media boolean false true Použije predvolené nastavenia výstupu obrázkov
wordpress.heartbeat boolean false true Obmedzí Heartbeat mimo editorov
preload.links string "off" "intent" Načíta dokumenty z rovnakého pôvodu vopred po zámere používateľa
media.lazy boolean false true Použije načítavač obrázkov Blockstudio
media.skeleton boolean false true Zobrazí vstavanú kostru načítavania
media.metadata boolean false true Deklaruje použitie assets/media.json
media.rootMargin string "300px" "300px" Okraj priesečníka pre lenivý načítavač
measurement.enabled boolean false false Povolí rozhrania API na meranie za behu
measurement.queryMonitor boolean false false Zahrnie požiadavky trvajúce aspoň 50ms
measurement.headers boolean false false Odošle hlavičky s hashom profilu a konfigurácie
measurement.timings boolean false false Odošle hlavičku s uplynutým časom behu
staticPrerender.enabled boolean false false Povolí ukladanie do vyrovnávacej pamäte HTML bezpečné pre anonymných používateľov
staticPrerender.ttl integer 86400 86400 Maximálny vek dokumentu vo vyrovnávacej pamäti v sekundách
staticPrerender.invalidate string "signature" "signature" Použije identitu signature alebo inkrementálnu identitu graph
staticPrerender.earlyServe boolean false false Poskytne bezpečné zásahy pred spustením WordPress
staticPrerender.serveLoggedIn boolean false false Umožní používateľom využívať zásahy z vyrovnávacej pamäte, nie ich vytvárať
staticPrerender.dynamicPaths array [] [] Prefixy ciest, ktoré musia zostať dynamické
staticPrerender.replayHeaders array ["Link"] ["Link"] Hlavičky odpovede uložené spolu so zásahmi z vyrovnávacej pamäte a odosielané pri nich
staticPrerender.warm.enabled boolean false false Povolí trvalý naplánovaný front na predbežné zahriatie
staticPrerender.warm.interval integer 3600 3600 Interval zahrievania v sekundách
staticPrerender.warm.concurrency integer 2 2 Maximálny počet úloh spracovaných počas jedného priechodu zahrievania
staticPrerender.warm.transport string "http" "http" Použije http alebo renderer poskytnutý hostiteľom internal

Statické predvykresľovanie zostáva vypnuté, pokiaľ ho výslovne nepovolíte. Ak je hlavný prepínač vypnutý, nezaregistrujú sa žiadne háčiky požiadaviek na predvykreslenie a vypnuté prepínače earlyServe a warm.enabled nezaregistrujú žiadne administrátorské ani cron háčiky. Režim podpisu používa pri bežných požiadavkách lacnú aktivovanú identitu. Režim grafu je určený na explicitné zostavenia: zaznamenáva závislosti zdrojov pre každú stránku, takže zmena jednej stránky nezneplatní nesúvisiace dokumenty. Ďalšie informácie o zahrievaní, nasadzovaní, skorom poskytovaní a bezpečnosti nájdete v časti Statické predvykresľovanie.

Merania sú dostupné programovo:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Keď sú hlavičky povolené, Blockstudio odosiela X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config a voliteľne aj X-Blockstudio-Performance-Time. Akcia blockstudio/performance/measurement_enabled prijíma vyriešené nastavenia behu.

Možnosti media riadia bs_media_image(), manifest assets/media.json a lenivý načítavač frontendu. Pomocníka, tvorbu manifestu a správanie načítavača opisuje časť Médiá.

content

Možnosť Typ Predvolená hodnota Opis
enabled boolean false Povolí konfiguráciu Content Sync
id string "default" Menný priestor súborov obsahu uložený v synchronizovaných entitách
path string "content" Adresár súborov obsahu vzhľadom na tému
includePageSyncManaged boolean false Zahrnie príspevky spravované funkciou Page Sync bez prevzatia ich tela
authors string "ignore" Spracovanie autorov (ignore alebo login existujúceho používateľa)
postTypes array [] Povolené typy príspevkov
meta.include array [] Vzory glob pre meta kľúče, ktoré sa majú synchronizovať
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Vzory glob pre meta kľúče, ktoré sa majú vylúčiť
meta.references object {} Deklarované meta odkazy prepísané medzi ID a UID
taxonomies array [] Povolené registrované taxonómie pre termíny a vzťahy
media string "manifest" Správanie pri odkazoch na prílohy (manifest alebo none)

Content Sync sa spravuje cez wp bs content a exportuje povolené príspevky, postmeta a deklarované odkazy do prenosných súborov. Postup a formát súborov opisuje časť Content Sync.

editor

Možnosť Typ Predvolená hodnota Opis
formatOnSave boolean false Formátuje block.json pri uložení
assets array [] Ďalšie zdroje načítané v editore
markup boolean false Povolí úpravu značiek

tailwind

Možnosť Typ Predvolená hodnota Opis
enabled boolean false Povolí kompiláciu Tailwind CSS
config string "" Konfigurácia Tailwind v4 CSS-first

Správanie kompilácie a formát konfigurácie CSS-first nájdete v časti Tailwind CSS.

blockTags

Možnosť Typ Predvolená hodnota Opis
enabled boolean false Povolí vykresľovanie značiek bs: na úrovni stránky v obsahu príspevkov a oblastiach widgetov
allow array [] Zoznam povolených vzorov názvov blokov; podporuje zástupné znaky fnmatch()
deny array [] Zoznam zakázaných vzorov názvov blokov; má prednosť pred allow
prefixes object {} Predpona na pomenovanie skratiek; každá hodnota je menný priestor alebo zoradené pole

Vykresľovanie značiek na úrovni šablóny je vždy aktívne; tieto možnosti riadia nahrádzanie na úrovni stránky. Syntax značiek a pravidlá rozlišovania nájdete v časti Vykresľovanie.

ui

Možnosť Typ Predvolená hodnota Opis
enabled boolean false Zaregistruje pribalené komponenty bsui/* UI a ukážkové aplikácie app/*

blockEditor

Možnosť Typ Predvolená hodnota Opis
disableLoading boolean false Vypne načítavanie blokov v editore
enhance boolean false Povolí funkcie umiestňovania kurzora a výberu v editore Blockstudio
cssClasses array [] URL štýlov, z ktorých sa získavajú triedy CSS na automatické dopĺňanie poľa tried
cssVariables array [] URL štýlov, z ktorých sa získavajú premenné CSS na automatické dopĺňanie poľa kódu

blockEditor.blocks

Použite blockEditor.blocks na nastavenie pravidiel vkladania blokov pre celý projekt. allow a deny prijímajú názvy blokov a vzory so zástupnými znakmi, naprí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 zruší registráciu štýlov zaregistrovaných cez register štýlov blokov WordPress PHP:

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

blockEditor.patterns

Pomocou blockEditor.patterns vypnete globálne zdroje vzorov a filtrujete kategórie vzorov.

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

blockEditor.media

Pomocou blockEditor.media nastavíte pravidlá globálneho vkladania médií.

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

dev

Možnosť Typ Predvolená hodnota Opis
grab.enabled boolean false Povolí nástroj na výber prvkov na frontende
perf boolean false Povolí profilovanie výkonu pri každom načítaní stránky
canvas.enabled boolean false Povolí plátno
canvas.adminBar boolean true Pri zobrazení plátna ukáže panel správcu WordPress

githooks

Možnosť Typ Predvolená hodnota Opis
commit boolean false Vygeneruje analytický pre-commit hook pri spustení blockstudio-githooks sync

Informácie o tom, čo spúšťa vygenerovaný háčik a ako zostáva synchronizovaný, nájdete v časti spravovaný commit hook.

phpstan

Možnosť Typ Predvolené Popis
preset reťazec "base" Predvoľba analýzy, keď ju príkazový riadok nevyberie: base, theme, extreme-theme alebo wordpress-render
configuration reťazec "" Konfigurácia projektu PHPStan zahrnutá spolu s predvoľbou, načítaná z blockstudio.json
roots pole ["."] Koreňové priečinky tém analyzované kanonickým príkazom
excludePaths pole [] Ďalšie vylúčenia skenera vzhľadom na každý nakonfigurovaný koreňový priečinok
maxFiles celé číslo 10000 Maximálny počet súborov kontrolovaných skenerom tém
blockTags objekt {} Mapovania prvkov, aliasy značiek a scanPhp pre pravidlo značky značky bloku

Tieto nastavenia riadia kanonický príkaz blockstudio-phpstan. Predvoľby, vrstvy a začlenenie nájdete v časti PHPStan.

ai

Možnosť Typ Predvolená hodnota Opis
enableContextGeneration boolean false Vygeneruje súhrnný kontextový súbor blokov, nastavení, schém a dokumentácie pre nástroje LLM

Register dokumentácie a úplný vygenerovaný text nájdete v časti Integrácia AI.

UI Komponenty

Povoľte a kombinujte pribalené bezhlavé komponenty UI predstavené vo verzii Blockstudio 7.3.