Preskoči na vsebino

Nastavitve

Blockstudio vključuje zmogljiv sistem nastavitev API, ki omogoča določanje možnosti z datoteko blockstudio.json v mapi teme in/ali s filtri. Poleg tega lahko pooblaščeni uporabniki vizualno spreminjajo nastavitve v skrbniškem območju.

Prek JSON

Če je v mapi teme datoteka blockstudio.json, bo uporabljena za določitev privzetih možnosti za trenutno spletno mesto. Na voljo je shema JSON za preverjanje datoteke in pomoč pri samodokončanju v IDE-ju.

Datoteka ni obvezna. Če je ni, Blockstudio uporabi nastavitve, shranjene v skrbniškem območju, poleg svojih vgrajenih privzetih vrednosti. Dodajanje, spreminjanje ali odstranjevanje datoteke se zazna samodejno, zato ni treba počistiti predpomnilnika ali ročno znova naložiti strani.

Na voljo so naslednje lastnosti:

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

Prek filtrov

Druga možnost je, da uporabite filter blockstudio/settings/${setting} za določanje možnosti prek PHP, kar zagotavlja več prilagodljivosti.

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, nastavljene s filtrom blockstudio/settings/${setting}, preglasijo tiste, nastavljene z datoteko blockstudio.json. Uporabite lahko oba načina hkrati.

Vrednosti med izvajanjem izpostavljajo tudi filtre blockstudio/performance/${setting} in še en končni filter blockstudio/performance/config. Zadnji mora vrniti veljaven konfiguracijski objekt.

Kako se viri združujejo

Vsak vir se naloži in združi, začenši z najnižjo prednostno ravnjo:

  1. Vgrajene privzete vrednosti
  2. Nastavitve, shranjene prek skrbniške UI (možnost blockstudio_settings)
  3. blockstudio.json v temi
  4. Filtri blockstudio/settings/*

blockstudio.json preglasi samo ključe, ki jih določa. Prej je v celoti nadomestil shranjene nastavitve, zato se nepovezana vrednost, shranjena v skrbniškem območju, po pojavu datoteke ni več uporabljala; zdaj se uporabi nad njimi. Po drugi strani pa se zastarela vrednost, shranjena prek skrbniške UI, še naprej uporablja, dokler datoteka ne določi tega ključa ali dokler shranjena vrednost ni odstranjena. Če se nastavitev obnaša drugače, kot določa datoteka, preverite shranjeno plast z wp bs settings ali Settings::get_raw(), ki vrne samo tisto, kar je aktivni vir JSON ali možnosti izrecno določil.

Branje nastavitev iz PHP

Blockstudio\Settings naloži aktivni vir, sporoči nepravilno oblikovan JSON in se samodejno znova naloži, ko se spremeni 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);
}

Uporabite Settings::get_raw(), kadar integracija potrebuje samo vrednosti, izrecno določene v aktivnem JSON ali viru možnosti. Settings::fingerprint() vrne deterministično identiteto učinkovitih nastavitev. Dolgotrajno delujoči procesi lahko izrecno pokličejo Settings::reload(), da spremembo datoteke takoj zaznajo. Ob običajnem dostopu se datoteka preveri največ enkrat na sekundo znotraj zahteve ali dolgotrajno delujočega procesa PHP, tudi pri spremembah, ki ohranijo velikost. Sprememba nastavljene poti začne veljati pri naslednjem branju. Če datoteka JSON ni aktivna, shranjene nastavitve iz zbirke podatkov niso odložene zaradi tega časovnega okna.

Razrešeni profil zmogljivosti je na voljo prek Blockstudio\Runtime_Settings::current(). Podpira poti z ločili poševnica ali pika:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

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

Razpoložljive nastavitve

users

Možnost Vrsta Privzeto Opis
ids polje [] ID-ji uporabnikov z dostopom do urejevalnika
roles polje [] Vloge uporabnikov z dostopom do urejevalnika

assets

Možnost Vrsta Privzeto Opis
enqueue boolean true Samodejno dodajanje sredstev blokov v čakalno vrsto
reset.enabled boolean false Odstrani sloge osnovnih blokov in uporabi ponastavitev pripomočkov urejevalnika
reset.fullWidth array [] Vrste objav, ki uporabljajo celozaslonsko postavitev urejevalnika
minify.css boolean false Minificiraj izhod CSS
minify.js boolean false Minificiraj izhod JS
process.scss boolean false Obdelaj datoteke SCSS
output string source Mesto zapisa prevedenih sredstev: source ali cache
inlineLimit integer 0 Število bajtov zunanjega bloka CSS, izpisanega v vrstici na stran

output je privzeto nastavljen na source, kar ustvari mapo _dist ob vsakem bloku. Nastavite ga na cache, da se prevedena sredstva zapišejo v mapo predpomnilnika Blockstudio, s čimer drevo izvorne kode blokov ostane čisto in ga je mogoče uvesti iz nespremenljivega odjavljanja. Viri Blockstudio, ki ne morejo pisati v že preusmerjene datoteke, se ne glede na to nastavitev preusmerijo v predpomnilnik.

inlineLimit je pri 0 izklopljen, zato vsaka zunanja slogovna datoteka ohrani svojo oznako <link>. Nastavite ga na število bajtov, da se v vrstici izpišejo najmanjše zunanje slogovne datoteke blokov na strani, dokler njihova skupna velikost ne presega te vrednosti. 40000 je omejitev, ki jo za isto pravilo uporablja jedro WordPress. Glejte Vstavljanje majhnih slogovnih datotek v vrstico.

Ko je reset.enabled aktivna, Blockstudio v platno urejevalnika kopira tudi očiščene vrednosti body_class za sprednji del. Seznam razredov, ki velja samo za urejevalnik, lahko prilagodite z blockstudio/editor/canvas/body_class.

cache

Možnost Vrsta Privzeto Opis
enabled logična vrednost true Omogoči predpomnilnike na podlagi datotek Blockstudio
path niz "blockstudio/cache" Pot predpomnilnika, relativna glede na WP_CONTENT_DIR ali absolutna
namespaceGrace celo število 86400 Število sekund, ki jih upokojeni imenski prostor predpomnilnika ostane na voljo pred čiščenjem

Datoteke predpomnilnika se privzeto zapisujejo v wp-content/blockstudio/cache, zunaj mape za prenose. Relativna pot path se razreši glede na WP_CONTENT_DIR; absolutna pot se uporabi neposredno. To podpira gostitelje, ki zagotavljajo namenski zapisljiv nosilec za predpomnilnik.

Ko je omogočen, Blockstudio uporablja to eno korensko mapo za gradbene podatkovne pakete, vnaprej pripravljene podatke o registraciji blokov, razrešena sredstva urejevalnika, Tailwind CSS, dokumente izrisov, fragmente otočkov, statične predizrise, indekse grafov, čakalne vrste in diagnostiko. Vsak objekt je ločen glede na omrežje, spletno mesto, celotno identiteto izvajalnega okolja in obseg. Identiteta izvajalnega okolja zajema Blockstudio, nastavitve, WordPress, PHP, aktivno temo, aktivne vtičnike, logične vire odkrivanja, kontekst gostitelja in izrecne zgoščene vrednosti odvisnosti, ki jih zagotovi operacija, ki je zanje odgovorna.

Spremembe vsebine, izrazov, uporabnikov in metapodatkov razveljavijo izpolnjene izbire polj, ne pa strukturnega odkrivanja blokov ali prevedenih sredstev. Izbire se osvežujejo ločeno, pri čemer velja zaklep za fiksno pot gradnje. Niz zaporednih zapisov, na primer sinhronizacija prevodov ali uvoz, se združi: prvi zapis po obdobju mirovanja sproži takojšnjo osvežitev, zadnji zapis v nizu pa se upošteva po preteku tridesetih sekund; ta čas je mogoče prilagoditi z blockstudio/cache/populate_debounce. Metapodatki, ki jih WordPress zapisuje kot evidenco, na primer zaklep urejanja objave, se ne štejejo kot sprememba; blockstudio/cache/populate_ignored_meta_keys ta seznam razširja. Urejevalnik vedno poizveduje po trenutno veljavnih možnostih, zato časovno okno vpliva samo na predpomnjene izbire, prebrane ob izrisu. Izvorne datoteke in nastavitve gradnje še naprej običajno razveljavijo strukturni predpomnilnik. Pri prepisovanju izbir se ob vsaki spremembi vsebine ne pregleduje znova imenika predpomnilnika; redno čiščenje še vedno odstranjuje osirotele začasne datoteke. Identitete izvajalnega okolja za posamezne jezike ostanejo ločene; več imenikov imenskih prostorov predpomnilnika na večjezičnem spletnem mestu samo po sebi ne dokazuje, da je prišlo do izpada predpomnilnika.

Dnevniške dejavnosti SQLite znotraj podatkovnega imenika bloka db ne zavržejo predpomnjenih metapodatkov bloka. Spremembe db.php, nadzorovanih izvornih datotek ali strukture izvornih datotek in podimenikov v podatkovnem imeniku še vedno razveljavijo predpomnilnik.

Pri sočasni ponovni gradnji izvajalnega okolja je izbran en graditelj. Druge zahteve čakajo do pet sekund, nato pa znova uporabijo zadnje dobre metapodatke bloka, če njegove izvorne datoteke in zahtevana prevedena sredstva še obstajajo. Hladna zahteva brez varnega podatkovnega paketa vrne HTTP 503 z Retry-After, namesto da bi začela novo gradnjo. Filter blockstudio/cache/build_wait_budget prilagodi čas čakanja v milisekundah za strukturne ponovne gradnje in osvežitve izbir. Gostitelj brez svetovalnih zaklepov datotek osveži izbire brez zaščite in jih vseeno objavi, zato bo naslednja zahteva dosegla zadetek.

Nedejavne datoteke .build.lock za posamezne ključe, ki so jih pustile prejšnje različice, se v vseh imenskih prostorih predpomnilnika tega spletnega mesta odstranijo z WP-Cron. Čiščenje se začne pet minut po nadgradnji in v desetsekundnem časovnem okviru odstrani do 10,000 zaklepov na minuto. wp bs cache status poroča o preostalem številu, wp bs cache cleanup pa takoj izprazni zaostanek; wp bs cache clear počisti izvajalni predpomnilnik. Če je načrtovani paket zaradi neproženja cron več kot deset minut v zamudi, zahteve enkrat na uro pregledajo omejeno število zaklepov, da se čiščenje ne ustavi. Nedavni ali zasedeni zaklepi ostanejo nedotaknjeni, novi zaklepi z nespremenljivo potjo pa se nikoli ne odstranijo. Ko je zaostanek odpravljen, isti paket odstrani opuščene imenske prostore predpomnilnika, ko preteče njihov namespaceGrace, največ enkrat na uro za posamezno spletno mesto, in zanje ohranja dnevni sprožilec. Čas mirovanja se šteje od prvega pregleda, ki ugotovi, da je imenski prostor opuščen, ne od njegove najnovejše datoteke; imenski prostor, ki je še vedno aktualen za kateri koli obseg, se nikoli ne odstrani. Notranje čiščenje predpomnilnika ne sproži filtrov WordPress za brisanje prilog. Gostitelji z onemogočenim WP-Cron morajo še naprej izvajati običajni načrtovani delavec cron; za izpraznitev zaostanka ne brišite vseh aktivnih datotek zaklepanja.

Filter nastavitev blockstudio/settings/cache/path spremeni konfigurirano vrednost. Za razreševanje poti, prilagojeno uvajanju, filter blockstudio/cache/dir razreši osnovno mapo:

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

Gostitelji z identiteto najemnika, ki se razlikuje od ID-jev omrežja ali spletnika WordPress, lahko filtrirajo blockstudio/cache/site_key. Rezultat se očisti in uporabi samo kot segment imenika. blockstudio/cache/context ostaja pravo mesto za serializabilno različico izvajalnega okolja, ki mora spremeniti identitete objektov.

themeDefaults

Možnost Vrsta Privzeto Opis
titleTag logična vrednost false Omogoči podporo teme za oznake naslovov WordPress
suppressDirectoryUpdates logična vrednost false Odstrani aktivne podrejene in nadrejene teme iz rezultatov posodobitev imenikov

Vzorci še naprej uporabljajo obstoječo Blockstudio\Patterns API; te privzete vrednosti ne uvajajo drugih vmesnikov za strani ali vzorce.

performance

Profil compat pusti splošno vedenje WordPress nespremenjeno. speed in strict omogočata enake privzete nastavitve za sprednji del, ki se vključijo po izbiri; vsako podrejeno nastavitev je mogoče nastaviti drugače kot vrednost profila.

Nastavitve za izbirno uporabo so prehodi za registracijo. Ko je izbirna funkcija false, Blockstudio ne pripne povratnih klicev za njen sprednji del, skrbniško območje, urejevalnik, REST ali načrtovane naloge. Če po uporabi funkcije Early Serve ali načrtovanega predhodnega segrevanja onemogočite, se enkrat izvede čiščenje virov, ki jih upravljajo. Poznejše zahteve ne sprožijo nobenega dejanja.

Možnost Vrsta Privzeto za združljivost Privzeto za hitrost/strogo delovanje Opis
profile string "compat" Ni na voljo compat, speed ali strict
wordpress.headNoise boolean false true Odstrani splošno odkrivanje v glavi in izpis emodžijev
wordpress.embeds boolean false true Odstrani odkrivanje oEmbed in skripte gostitelja
wordpress.xmlrpc boolean false true Onemogoči XML-RPC in povratne objave
wordpress.editor boolean false true Onemogoči oddaljene površine za odkrivanje urejevalnika
wordpress.frontendAssets boolean false true Odstrani splošna sredstva jedra za sprednji del
wordpress.media boolean false true Uporabi privzete nastavitve izhoda slik
wordpress.heartbeat boolean false true Omeji Heartbeat zunaj urejevalnikov
preload.links string "off" "intent" Po nameri uporabnika vnaprej pridobi dokumente istega izvora
media.lazy boolean false true Uporabi nalagalnik slik v Blockstudio
media.skeleton boolean false true Prikaži vgrajen skelet med nalaganjem
media.metadata boolean false true Označi uporabo assets/media.json
media.rootMargin string "300px" "300px" Rob preseka za leno nalaganje
measurement.enabled boolean false false Omogoči API-je za merjenje med izvajanjem
measurement.queryMonitor boolean false false Vključi poizvedbe, ki trajajo vsaj 50ms
measurement.headers boolean false false Pošlji glave s profilom in zgoščeno vrednostjo konfiguracije
measurement.timings boolean false false Pošlji glavo s časom izvajanja
staticPrerender.enabled boolean false false Omogoči predpomnjenje HTML, varno za anonimne uporabnike
staticPrerender.ttl integer 86400 86400 Največja starost predpomnjenega dokumenta v sekundah
staticPrerender.invalidate string "signature" "signature" Uporabi identiteto signature ali inkrementalno graph
staticPrerender.earlyServe boolean false false Posreduj varne zadetke, še preden se zažene WordPress
staticPrerender.serveLoggedIn boolean false false Dovoli uporabnikom uporabo zadetkov iz predpomnilnika, nikoli pa njihovega ustvarjanja
staticPrerender.dynamicPaths array [] [] Predpone poti, ki morajo ostati dinamične
staticPrerender.replayHeaders array ["Link"] ["Link"] Glave odziva, shranjene skupaj z zadetki iz predpomnilnika in poslane ob njihovi uporabi
staticPrerender.warm.enabled boolean false false Omogoči trajno načrtovano čakalno vrsto za ogrevanje
staticPrerender.warm.interval integer 3600 3600 Interval ogrevanja v sekundah
staticPrerender.warm.concurrency integer 2 2 Največje število opravil, obdelanih v enem prehodu ogrevanja
staticPrerender.warm.transport string "http" "http" Uporabite http ali izrisovalnik, ki ga zagotovi gostitelj internal

Statično predizrisovanje ostane onemogočeno, razen če ga izrecno omogočite. Onemogočeno glavno stikalo ne registrira nobenih kavljev za zahteve predizrisovanja, onemogočeni stikali earlyServe in warm.enabled pa ne registrirata nobenih skrbniških kavljev ali kavljev cron. Način s podpisom pri običajnih zahtevah uporablja poceni aktivirano identiteto. Način grafa je namenjen izrecnim gradnjam: beleži odvisnosti izvornih datotek za posamezne strani, zato sprememba ene strani ne razveljavi nepovezanih dokumentov. Za podrobnosti o ogrevanju, uvajanju, zgodnjem streženju in varnosti glejte Statično predizrisovanje.

Meritve so na voljo programsko:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Ko so glave omogočene, Blockstudio pošlje X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config in po želji X-Blockstudio-Performance-Time. Dejanje blockstudio/performance/measurement_enabled prejme razrešene nastavitve izvajanja.

Možnosti media usmerjajo bs_media_image(), manifest assets/media.json in leni nalagalnik za sprednji del. Za pomočnik, graditelj manifesta in delovanje nalagalnika glejte Mediji.

content

Možnost Vrsta Privzeto Opis
enabled logična vrednost false Omogoči konfiguracijo Content Sync
id niz "default" Imenski prostor nabora vsebine, shranjen v sinhroniziranih entitetah
path niz "content" Imenik z datotekami vsebine glede na temo
includePageSyncManaged logična vrednost false Vključi objave, ki jih upravlja Page Sync, ne da bi prevzel njihovo vsebino
authors niz "ignore" Ravnanje z avtorji (ignore ali obstoječi uporabnik login)
postTypes polje [] Seznam dovoljenih vrst objav
meta.include polje [] Vzorci glob za sinhronizacijo ključev metapodatkov
meta.exclude polje ["_edit_lock", "_edit_last", "_wp_old_slug"] Vzorci glob za izključitev ključev metapodatkov
meta.references objekt {} Deklarirane reference metapodatkov, prepisane med ID-ji in UID-ji
taxonomies polje [] Seznam dovoljenih registriranih taksonomij za izraze in razmerja
media niz "manifest" Obnašanje referenc na priloge (manifest ali none)

Content Sync se upravlja prek wp bs content in izvozi dovoljene objave, postmeta ter deklarirane reference v prenosljive datoteke. Za potek dela in obliko datotek glejte Content Sync.

editor

Možnost Vrsta Privzeto Opis
formatOnSave logična vrednost false Ob shranjevanju oblikuj block.json
assets polje [] Dodatna sredstva za nalaganje v urejevalniku
markup logična vrednost false Omogoči urejanje označevalnega jezika

tailwind

Možnost Vrsta Privzeto Opis
enabled logična vrednost false Omogoči prevajanje Tailwind CSS
config niz "" Konfiguracija po načelu Tailwind v4 CSS

Za delovanje prevajanja in obliko konfiguracije po načelu CSS glejte Tailwind CSS.

blockTags

Možnost Vrsta Privzeto Opis
enabled logična vrednost false Omogoči izrisovanje oznak bs: na ravni strani v vsebini objav in območjih gradnikov
allow polje [] Seznam dovoljenih vzorcev imen blokov; podpira nadomestne znake fnmatch()
deny polje [] Seznam prepovedanih vzorcev imen blokov; ima prednost pred allow
prefixes objekt {} Predpona za kratke zapise, vsaka vrednost pa je imenski prostor ali urejeno polje

Izrisovanje oznak na ravni predloge je vedno aktivno; te možnosti nadzorujejo zamenjavo na ravni strani. Za pravila označevanja in razreševanja glejte Izrisovanje.

ui

Možnost Vrsta Privzeto Opis
enabled logična vrednost false Registriraj priložene komponente bsui/* UI in predstavitvene aplikacije app/*

blockEditor

Možnost Vrsta Privzeto Opis
disableLoading logična vrednost false Onemogoči nalaganje blokov v urejevalniku
enhance logična vrednost false Omogoči možnosti za pomik kazalca in izbiro v urejevalniku Blockstudio
cssClasses polje [] URL-ji slogovnih datotek, iz katerih se pridobijo razredi CSS za samodokončevanje polja razredov
cssVariables polje [] URL-ji slogovnih datotek, iz katerih se pridobijo spremenljivke CSS za samodokončevanje polja kode

blockEditor.blocks

Za pravilnik vstavljalnika blokov za celoten projekt uporabite blockEditor.blocks. allow in deny sprejemata imena blokov in vzorce z nadomestnimi znaki, kot je 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 odregistrira sloge, registrirane prek registra slogov blokov WordPress: PHP

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

blockEditor.patterns

Z blockEditor.patterns onemogočite globalne vire vzorcev in filtrirate kategorije vzorcev.

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

blockEditor.media

Za globalni pravilnik vstavljalnika predstavnosti uporabite blockEditor.media.

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

dev

Možnost Vrsta Privzeto Opis
grab.enabled logična vrednost false Omogoči zajemalnik elementov na sprednjem delu
perf logična vrednost false Omogoči profilirnik zmogljivosti ob vsakem nalaganju strani
canvas.enabled logična vrednost false Omogoči platno
canvas.adminBar logična vrednost true Med ogledom platna prikaži skrbniško vrstico WordPress

githooks

Možnost Vrsta Privzeto Opis
commit logična vrednost false Ustvari kavelj za preverjanje pred potrditvijo, ki izvaja samo analizo, ko se zažene blockstudio-githooks sync

Za informacije o tem, kaj izvaja ustvarjeni kavelj in kako ostaja usklajen, glejte upravljani kavelj za potrditev.

phpstan

Možnost Vrsta Privzeto Opis
preset niz "base" Prednastavitev analize, če je ukazna vrstica ne izbere: base, theme, extreme-theme ali wordpress-render
configuration niz "" Konfiguracija projekta PHPStan, vključena poleg prednastavitve in razrešena iz blockstudio.json
roots polje ["."] Korenine tem, ki jih analizira kanonični ukaz
excludePaths polje [] Dodatne izključitve pregledovalnika glede na vsako nastavljeno korenino
maxFiles celo število 10000 Največje število datotek, ki jih pregleda pregledovalnik tem
blockTags objekt {} Preslikave elementov, vzdevki oznak in scanPhp za pravilo oznake pravilo blokovne oznake

Te nastavitve usmerjajo kanonični ukaz blockstudio-phpstan. Za prednastavitve, plasti in uvedbo glejte PHPStan.

ai

Možnost Vrsta Privzeto Opis
enableContextGeneration logična vrednost false Ustvari združeno kontekstno datoteko z bloki, nastavitvami, shemami in dokumentacijo za orodja LLM

Za kazalo dokumentacije in celotno ustvarjeno besedilo glejte Integracija AI.

UI Komponente

Omogočite in sestavite priložene brezglavne komponente UI, uvedene v različici Blockstudio 7.3.