Liigu sisu juurde

Seaded

Blockstudio sisaldab võimsat seadete API, mis võimaldab määrata valikuid teemakaustas oleva blockstudio.json faili ja/või filtrite kaudu. Lisaks saavad lubatud kasutajad haldusalas seadeid visuaalselt muuta.

JSON kaudu

Kui teemakaustas on fail blockstudio.json, kasutatakse seda praeguse saidi vaikevalikute määramiseks. Faili valideerimiseks ja IDE-s automaattäite võimaldamiseks on saadaval JSON skeem.

Fail on valikuline. Kui seda pole, kasutab Blockstudio haldusalas salvestatud seadeid lisaks sisseehitatud vaikeväärtustele. Faili lisamine, muutmine või eemaldamine tuvastatakse automaatselt, seega pole vahemälu tühjendamine ega käsitsi uuesti laadimine vajalik.

Saadaval on järgmised atribuudid:

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

Filtrite kaudu

Teise võimalusena saate suurema paindlikkuse huvides määrata valikud PHP kaudu, kasutades filtrit blockstudio/settings/${setting}.

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

Filtriga blockstudio/settings/${setting} määratud valikud alistavad failis blockstudio.json määratud valikud. Mõlemat meetodit saab kasutada koos.

Käitusaegsed väärtused pakuvad ka blockstudio/performance/${setting} filtreid ja üht viimast blockstudio/performance/config filtrit. Viimane peab tagastama kehtiva konfiguratsiooniobjekti.

Kuidas allikad kihistuvad

Kõik allikad laaditakse ja liidetakse, alustades madalaima prioriteediga allikast:

  1. Sisseehitatud vaikeväärtused
  2. Haldusliidese kaudu salvestatud seaded UI (valik blockstudio_settings)
  3. Teemas olev blockstudio.json
  4. blockstudio/settings/* filtrid

blockstudio.json alistab ainult need võtmed, mille ta määratleb. Varem asendas see salvestatud seaded täielikult, mistõttu faili ilmumisel lakkas rakendumast mõni sõltumatu haldusalas salvestatud väärtus; nüüd lisatakse see nende peale. Teine külg on see, et haldusliidese kaudu salvestatud aegunud väärtus UI jääb rakenduma, kuni failis määratletakse vastav võti või salvestatud väärtus eemaldatakse. Kui seade käitub teisiti, kui failis kirjas, kontrollige salvestatud kihti käsuga wp bs settings või Settings::get_raw(), mis tagastab ainult selle, mille aktiivne allikas JSON või valikute allikas on sõnaselgelt määratlenud.

Seadete lugemine allikast PHP

Blockstudio\Settings laadib aktiivse allika, annab teada vigasest JSON-ist ning laadib automaatselt uuesti, kui blockstudio.json muutub:

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

Kasutage Settings::get_raw(), kui integratsioon vajab ainult aktiivses JSON-s või suvandite allikas selgesõnaliselt deklareeritud väärtusi. Settings::fingerprint() tagastab deterministliku tõhusa seadistuse identifikaatori. Pikalt töötavad protsessid saavad failimuudatuse viivitamatuks lugemiseks kutsuda sõnaselgelt Settings::reload(). Tavapärase juurdepääsu korral kontrollitakse faili päringu või pikalt töötava PHP protsessi jooksul maksimaalselt kord sekundis, ka siis, kui muudetud fail on sama suurusega. Seadistatud tee muutmine jõustub järgmisel lugemisel. Kui ükski JSON fail pole aktiivne, ei lükata salvestatud andmebaasiseadistuste lugemist selle ajavahemiku võrra edasi.

Lahendatud jõudlusprofiil on saadaval atribuudi Blockstudio\Runtime_Settings::current() kaudu. See toetab kaldkriipsu või punktiga teid:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

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

Saadaolevad seaded

users

Valik Tüüp Vaikeväärtus Kirjeldus
ids massiiv [] Redaktorile juurdepääsu omavate kasutajate ID-d
roles massiiv [] Redaktorile juurdepääsu omavad kasutajarollid

assets

Valik Tüüp Vaikeväärtus Kirjeldus
enqueue boolean true Lisa ploki varad automaatselt järjekorda
reset.enabled boolean false Eemalda tuumiku plokistiilid ja rakenda redaktori utiliitide lähtestus
reset.fullWidth array [] Postituse tüübid, mis kasutavad täislaiuses redaktori paigutust
minify.css boolean false Minimeeri CSS väljund
minify.js boolean false Minimeeri JS väljund
process.scss boolean false Töötle SCSS faile
output string source Kompileeritud varade salvestuskoht: source või cache
inlineLimit integer 0 Välise ploki CSS baitide arv, mis prinditakse igal lehel tekstisiseselt

output vaikeväärtus on source, mis loob iga ploki kõrvale kataloogi _dist. Määrake selle väärtuseks cache, et salvestada kompileeritud varad hoopis Blockstudio vahemälukataloogi. Nii jääb plokkide lähtekoodipuu puhtaks ja muutmatusest välja registreeritud koodikogust juurutatavaks. Allikate Blockstudio puhul kirjutatakse varad suunamisest sõltumata alati vahemällu.

inlineLimit on asukohas 0 välja lülitatud, mistõttu jääb igale välisele laaditabelile selle <link> silt. Määrake selle väärtuseks baitide arv, et printida lehe väikseimad välised laaditabelid hoopis tekstisiseselt, kui nende kogumaht jääb selle arvu piiresse. 40000 on sama reegli jaoks tuumiku kasutatav piirang WordPress. Vt jaotist Väikeste laaditabelite lisamine teksti.

Kui reset.enabled on aktiivne, kopeerib Blockstudio redaktori lõuendile ka puhastatud esiosa body_class väärtused. Kasutage blockstudio/editor/canvas/body_class, et kohandada ainult redaktoris kasutatavate klasside loendit.

cache

Valik Tüüp Vaikeväärtus Kirjeldus
enabled tõeväärtus true Luba Blockstudio failipõhised vahemälud
path string "blockstudio/cache" Vahemälu asukoht, suhteline WP_CONTENT_DIR suhtes või absoluutne
namespaceGrace täisarv 86400 Mitu sekundit hoida kasutuselt kõrvaldatud vahemälunimeruumi enne koristamist

Vaikimisi kirjutatakse vahemälufailid asukohta wp-content/blockstudio/cache, üleslaadimiste kataloogist väljapoole. Suhteline path lahendatakse lähtepunktiga WP_CONTENT_DIR; absoluutset teed kasutatakse otse. See sobib majutusteenustega, mis pakuvad eraldi kirjutatavat vahemälu köidet.

Kui see on lubatud, kasutab Blockstudio seda üht juurkataloogi koosteväljundite, eelehitatud plokkide registreerimisandmete, lahendatud redaktorivarade, Tailwind CSS, renderdusdokumentide, saarefragmentide, staatiliste eeltöötluste, graafiindeksite, järjekordade ja diagnostika jaoks. Iga objekt eraldatakse võrgu, saidi, täieliku käituskeskkonna identiteedi ja skoobi järgi. Käituskeskkonna identiteet hõlmab väärtusi Blockstudio, seadeid, WordPress, PHP, aktiivset teemat, aktiivseid pluginaid, loogilisi avastamisallikaid, hosti konteksti ja toimingu omaniku antud selgesõnalisi sõltuvuste räsi.

Sisu-, termini-, kasutaja- ja metaandmete muudatused muudavad täidetud välja-valikud kehtetuks, kuid ei mõjuta struktuursete plokkide tuvastamist ega kompileeritud varasid. Valikud värskendatakse eraldi, fikseeritud koosteteekonna lukustuse all. Järjestikused kirjutused, näiteks tõlgete sünkroonimine või import, koondatakse: esimene kirjutus pärast vaikset perioodi käivitab värskenduse kohe ja viimane kirjutus kajastub pärast kolmekümne sekundi möödumist. Seda aega saab muuta sättega blockstudio/cache/populate_debounce. Metaandmed, mida WordPress kirjutab arvestuse pidamiseks, näiteks postituse muutmise lukk, ei lähe muudatusena arvesse; blockstudio/cache/populate_ignored_meta_keys täiendab seda loendit. Redaktor pärib alati aktiivseid valikuid, seega mõjutab ajavahemik ainult renderdamise ajal loetavaid vahemällu salvestatud valikuid. Lähtefailid ja koostesätted muudavad struktuurse vahemälu tavapäraselt kehtetuks. Valikute ülekirjutamine ei skanni iga sisumuudatuse korral vahemälukataloogi uuesti; perioodiline puhastamine eemaldab endiselt orvuks jäänud ajutised failid. Keelepõhised käitusaja identiteedid jäävad eraldatuks; mitme vahemälu nimeruumide kataloogi olemasolu mitmekeelsel saidil ei tõenda iseenesest vahemälu möödumist.

SQLite päevikukirjed ploki db andmekataloogis ei tühista ploki metaandmete vahemällu salvestamist. Muudatused asukohas db.php, jälgitavates lähtefailides või andmekataloogi lähtefailide ja alamkataloogide struktuuris muudavad vahemälu endiselt kehtetuks.

Samaaegsetel käituskeskkonna taasloomistel valitakse üks koostaja. Teised päringud ootavad kuni viis sekundit ja kasutavad seejärel viimast toimivat plokimetaandmestikku, kui selle lähtefailid ning vajalikud kompileeritud varad on endiselt olemas. Külm päring, mille jaoks puudub ohutu väljund, tagastab HTTP 503 koos väärtusega Retry-After, selle asemel et käivitada uut koostet. Filter blockstudio/cache/build_wait_budget määrab nii struktuuri taasloomiste kui ka valikute värskendamise ooteaja millisekundites. Hosti puhul, mis ei toeta nõuandvaid faililukke, värskendatakse valikuid lukustamata ja avaldatakse need ikkagi, nii et järgmine päring leiab need vahemälust.

Varasemate versioonide jäetud jõudeolekus olevad võtmespetsiifilised .build.lock failid kogutakse saidi kõigist vahemälunimeruumidest funktsiooniga WP-Cron. Kogumine algab viis minutit pärast uuendust ja eemaldab kuni 10,000 lukku minutis, kasutades selleks kuni kümme sekundit. wp bs cache status teatab allesjäänud arvu ja wp bs cache cleanup tühjendab järjekorra kohe; wp bs cache clear tühjendab käituskeskkonna vahemälu. Kui ajastatud töötlus hilineb üle kümne minuti, sest cron ei käivitu, skannivad päringud kord tunnis piiratud arvu lukke, et tühjendamine ei seiskuks. Hiljutised või hoitavad lukud jäetakse puutumata ning uusi kindla teega lukke ei koguta kunagi. Kui järjekord on tühjendatud, kogub sama töötlus mahajäetud vahemälunimeruumid pärast nende namespaceGrace möödumist. Seda tehakse saidi kohta kõige rohkem kord tunnis ning selleks jäetakse alles igapäevane käivitus. Ajapikendus algab esimesest skannimisest, mis tuvastab nimeruumi kasutuselt kõrvaldatuna, mitte selle uusima faili loomise hetkest. Nimeruumi, mis on mõne skoobi jaoks endiselt aktiivne, ei koguta kunagi. Sisemine vahemälu puhastamine ei käivita manuste kustutamise filtreid WordPress. Hosti puhul, kus WP-Cron on keelatud, peab tavapärane ajastatud cron töötlus endiselt käima; ärge kustutage järjekorra tühjendamiseks valimatult aktiivseid lukufaile.

Seadistusfilter blockstudio/settings/cache/path muudab seadistatud väärtust. Juurutuspõhise teelahenduse jaoks filtreerib blockstudio/cache/dir lahendatud baaskataloogi:

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

Hostid, mille rentniku identiteet erineb võrgu või ajaveebi ID-dest WordPress, saavad filtreerida väärtust blockstudio/cache/site_key. Tulemus puhastatakse ja seda kasutatakse ainult kataloogitee segmendina. Jadastatava käitusvariandi jaoks, mis peab muutma objektide identiteete, on õige koht endiselt blockstudio/cache/context.

themeDefaults

Valik Tüüp Vaikeväärtus Kirjeldus
titleTag tõeväärtus false Luba WordPress tiitlisildi teematoetus
suppressDirectoryUpdates tõeväärtus false Eemalda aktiivsed alam- ja ülemteemad kataloogi uuendamise tulemustest

Mustrid kasutavad jätkuvalt olemasolevat Blockstudio\Patterns API; need vaikeväärtused ei lisa alternatiivseid lehe- ega mustrifassaade.

performance

Profiil compat jätab üldise käitumise WordPress muutmata. speed ja strict lubavad sama valikulise esiosa vaikekonfiguratsiooni; iga alamseade saab profiili väärtuse alistada.

Valikulised seaded on registreerimisväravad. Kui valikuline funktsioon on false, ei lisa Blockstudio selle funktsiooni esiosa-, haldus-, redaktori-, REST- ega ajastatud tagasihelistusi. Kui Early Serve või ajastatud soojendamine pärast kasutamist välja lülitada, teeb see ühe korra ära enda hallatava puhastuse; edaspidised päringud ei tee midagi.

Valik Tüüp Ühilduvuse vaikeväärtus Kiiruse/ranguse vaikeväärtus Kirjeldus
profile string "compat" Pole kohaldatav compat, speed või strict
wordpress.headNoise boolean false true Eemalda üldine päise tuvastamine ja emotikonide väljund
wordpress.embeds boolean false true Eemalda oEmbed-i tuvastamine ja hosti skriptid
wordpress.xmlrpc boolean false true Keela XML-RPC ja pingbackid
wordpress.editor boolean false true Keela kaugredaktori tuvastuspinnad
wordpress.frontendAssets boolean false true Eemalda üldised tuuma esiotsa varad
wordpress.media boolean false true Rakenda piltide väljundi vaikeväärtused
wordpress.heartbeat boolean false true Piira Heartbeati kasutamist väljaspool redaktoreid
preload.links string "off" "intent" Eellaadi samalt päritolult dokumente pärast kasutaja tegevust
media.lazy boolean false true Kasuta Blockstudio pildilaadurit
media.skeleton boolean false true Kuva sisseehitatud laadimise kohatäide
media.metadata boolean false true Teata assets/media.json kasutamisest
media.rootMargin string "300px" "300px" Laaduri lõikumisvahemik
measurement.enabled boolean false false Luba käitusaja mõõtmis-API-d
measurement.queryMonitor boolean false false Kaasa päringud, mis kestavad vähemalt 50ms
measurement.headers boolean false false Saada profiili ja konfiguratsiooni räsi päised
measurement.timings boolean false false Saada käitusaja kestuse päis
staticPrerender.enabled boolean false false Luba anonüümsust säilitav HTML vahemällu salvestamine
staticPrerender.ttl integer 86400 86400 Vahemällu salvestatud dokumendi maksimaalne vanus sekundites
staticPrerender.invalidate string "signature" "signature" Kasuta signature või järkjärgulist graph identiteeti
staticPrerender.earlyServe boolean false false Esita turvalised vahemälutabamused enne, kui WordPress käivitub
staticPrerender.serveLoggedIn boolean false false Luba kasutajatel vahemälutabamusi kasutada, kuid mitte luua
staticPrerender.dynamicPaths array [] [] Teeprefiksid, mis peavad jääma dünaamiliseks
staticPrerender.replayHeaders array ["Link"] ["Link"] Vahemälutabamustega salvestatavad ja nende korral saadetavad vastuse päised
staticPrerender.warm.enabled boolean false false Luba püsiv ajastatud soojendamisjärjekord
staticPrerender.warm.interval integer 3600 3600 Soojendamise intervall sekundites
staticPrerender.warm.concurrency integer 2 2 Ühe soojenduskorraga töödeldavate tööde maksimaalne arv
staticPrerender.warm.transport string "http" "http" Kasuta http või hosti pakutavat internal renderdajat

Staatiline eelrenderdamine jääb keelatuks, kuni seda pole sõnaselgelt lubatud. Keelatud pealüliti ei registreeri eelrenderdamise päringuhaake ning keelatud lülitid earlyServe ja warm.enabled ei registreeri admini- ega cron-haake. Allkirjarežiim kasutab tavaliste päringute korral odavat aktiveeritud identiteeti. Graafirežiim on mõeldud selgesõnalisteks järkudeks: see salvestab iga lehe lähteandmete sõltuvused, nii et ühe lehe muutmine ei tühista seosetute dokumentide kehtivust. Vt Staatiline eelrenderdamine soojendamise, juurutamise, varajase esitamise ja ohutuse üksikasju.

Mõõtmised on saadaval programmiliselt:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Kui päised on lubatud, saadab Blockstudio päised X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config ja soovi korral ka X-Blockstudio-Performance-Time. Tegevus blockstudio/performance/measurement_enabled saab lahendatud käitusajasätted.

Valikud media juhivad bs_media_image()-i, assets/media.json-manifesti ja esikülje laisklaadurit. Abifunktsiooni, manifestikoosturi ja laaduri käitumise kohta vt Meedia.

content

Valik Tüüp Vaikeväärtus Kirjeldus
enabled boolean false Luba Content Synci konfiguratsioon
id string "default" Sünkroonitud olemitele salvestatav sisukogumi nimeruum
path string "content" Teemaga seotud sisufailide kataloog
includePageSyncManaged boolean false Kaasa Page Synci hallatavad postitused nende sisu omamata
authors string "ignore" Autori käsitlemine (ignore või olemasoleva kasutaja login)
postTypes array [] Lubatud postitusetüübid
meta.include array [] Meta-võtmete sünkroonitavate glob-mustrid
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Välistatavate meta-võtmete glob-mustrid
meta.references object {} Määratud meta-viited, mis kirjutatakse ID-de ja UID-de vahel ümber
taxonomies array [] Lubatud registreeritud taksonoomiad terminite ja seoste jaoks
media string "manifest" Manuseviite käitumine (manifest või none)

Content Synci hallatakse valiku wp bs content kaudu ning see ekspordib lubatud postitused, postituse metaandmed ja määratud viited teisaldatavatesse failidesse. Vt Content Sync töövoo ja failivormingu kohta.

editor

Valik Tüüp Vaikeväärtus Kirjeldus
formatOnSave boolean false Vorminda salvestamisel block.json
assets array [] Täiendavad varad, mis redaktorisse laadida
markup boolean false Luba märgistuse muutmine

tailwind

Valik Tüüp Vaikeväärtus Kirjeldus
enabled boolean false Luba Tailwind CSS kompileerimine
config string "" Tailwind-i v4 CSS-i põhine konfiguratsioon

Vt Tailwind CSS kompileerimise käitumise ja CSS-i põhise konfiguratsioonivormingu kohta.

blockTags

Valik Tüüp Vaikeväärtus Kirjeldus
enabled boolean false Luba lehepõhine bs:-siltide renderdamine postituse sisus ja vidinate aladel
allow array [] Plokinimede mustrite lubatud loend; toetab fnmatch() metamärke
deny array [] Plokinimede mustrite keelatud loend; on ülimuslik valiku allow suhtes
prefixes object {} Lühivormide nimeruumide prefiks; iga väärtus on nimeruum või järjestatud massiiv

Malli tasemel siltide renderdamine on alati aktiivne; need valikud juhivad lehe tasemel asendamist. Siltide süntaksi ja lahendusreeglite kohta vt Renderdamine.

ui

Valik Tüüp Vaikeväärtus Kirjeldus
enabled boolean false Registreeri komplekti kuuluvad bsui/* UI komponendid ja app/* näidisrakendused

blockEditor

Valik Tüüp Vaikeväärtus Kirjeldus
disableLoading boolean false Keela plokkide laadimine redaktoris
enhance boolean false Luba Blockstudio redaktoris hõljutamise ja valimise juhtnupud
cssClasses array [] Stiililehe URL-id, kust eraldada CSS klassid klassivälja automaatseks täitmiseks
cssVariables array [] Stiililehe URL-id, kust eraldada CSS muutujad koodivälja automaatseks täitmiseks

blockEditor.blocks

Kasuta valikut blockEditor.blocks kogu projekti ploki lisaja reeglite määramiseks. allow ja deny aktsepteerivad plokinimesid ja metamärgiga mustreid, näiteks 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 tühistab registreeritud stiilide registreeringu, mille allikaks oli WordPress-i PHP-plokistiilide register:

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

blockEditor.patterns

Kasuta valikut blockEditor.patterns globaalsete mustriallikate keelamiseks ja mustrikategooriate filtreerimiseks.

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

blockEditor.media

Kasuta valikut blockEditor.media globaalsete meedia lisaja reeglite määramiseks.

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

dev

Valik Tüüp Vaikeväärtus Kirjeldus
grab.enabled boolean false Luba esikülje elementide valija
perf boolean false Luba jõudlusprofiil igal lehe laadimisel
canvas.enabled boolean false Luba lõuend
canvas.adminBar boolean true Kuva lõuendi vaatamisel WordPress adminiriba

githooks

Valik Tüüp Vaikeväärtus Kirjeldus
commit boolean false Loo ainult analüüsi tegev eelkinnituse haak, kui käivitub blockstudio-githooks sync

Vt hallatav sissekandehaak, et teada saada, mida loodud haak käivitab ja kuidas see sünkroonis püsib.

phpstan

Valik Tüüp Vaikeväärtus Kirjeldus
preset string "base" Analüüsi eelseadistus, kui käsurealt pole seda valitud: base, theme, extreme-theme või wordpress-render
configuration string "" Projekti PHPStan konfiguratsioon, mis kaasatakse koos eelseadistusega ja lahendatakse asukohast blockstudio.json
roots array ["."] Kanoonilise käsu analüüsitavad teemajuured
excludePaths array [] Täiendavad skanneri välistused iga seadistatud juure suhtes
maxFiles integer 10000 Teemaskanneri uuritavate failide maksimumarv
blockTags object {} Elemendivastendused, sildialias’ed ja scanPhp plokisildi reegli jaoks

Need sätted juhivad kanoonilist käsku blockstudio-phpstan. Eelseadistuste, kihtide ja kasutuselevõtu kohta vt PHPStan.

ai

Valik Tüüp Vaikeväärtus Kirjeldus
enableContextGeneration boolean false Loo plokkidest, sätetest, skeemidest ja dokumentatsioonist koondatud kontekstifail LLM-tööriistadele

Dokumentatsiooni registri ja kogu loodud teksti kohta vt AI-lõiming.

UI Komponendid

Luba ja kombineeri komplekti kuuluvaid peata UI komponente, mis võeti kasutusele versioonis Blockstudio 7.3.