Asetukset
Blockstudio sisältää tehokkaan asetusten API, jonka avulla voit määrittää valintoja teemakansiossa olevalla blockstudio.json-tiedostolla ja/tai suodattimilla. Lisäksi käyttöoikeuden omaavat käyttäjät voivat muuttaa asetuksia visuaalisesti hallinta-alueella.
JSON-tiedoston kautta
Jos teemakansiossasi on blockstudio.json-tiedosto, sitä käytetään sivuston oletusasetusten määrittämiseen. Käytettävissä on JSON-skeema, jolla tiedoston voi validoida ja joka tarjoaa IDE:ssä automaattisen täydennyksen.
Tiedosto on valinnainen. Jos sitä ei ole, Blockstudio käyttää hallinta-alueelle tallennettuja asetuksia sisäänrakennettujen oletusarvojensa lisäksi. Tiedoston lisääminen, muuttaminen tai poistaminen havaitaan automaattisesti, joten välimuistia ei tarvitse tyhjentää eikä sivua ladata manuaalisesti uudelleen.
Seuraavat ominaisuudet ovat käytettävissä:
{
"$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
}
}
Suodattimien kautta
Vaihtoehtoisesti voit käyttää blockstudio/settings/${setting}-suodatinta asetusten määrittämiseen PHP-arvoilla, jolloin saat enemmän joustavuutta.
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');
blockstudio/settings/${setting}-suodattimella asetetut valinnat ohittavat blockstudio.json-tiedostossa määritetyt. Molempia menetelmiä voi käyttää yhdessä.
Ajoaikaiset arvot tarjoavat myös blockstudio/performance/${setting}-suodattimet ja yhden lopullisen blockstudio/performance/config-suodattimen. Jälkimmäisen on palautettava kelvollinen määritysobjekti.
Miten lähteet yhdistyvät
Kaikki lähteet ladataan ja yhdistetään alkaen pienimmän prioriteetin lähteestä:
- Sisäänrakennetut oletusarvot
- Hallinnan kautta tallennetut asetukset UI (valinta
blockstudio_settings) - Teeman
blockstudio.json blockstudio/settings/*-suodattimet
blockstudio.json ohittaa vain määrittämänsä avaimet. Aiemmin se korvasi tallennetut asetukset kokonaan, joten tiedoston ilmestyessä siihen liittymätön ylläpidossa tallennettu arvo lakkasi vaikuttamasta; nyt tiedosto lisätään niiden päälle. Kääntöpuolena ylläpidon kautta tallennettu vanhentunut arvo UI säilyy käytössä, kunnes tiedosto määrittää kyseisen avaimen tai tallennettu arvo poistetaan. Jos asetus toimii eri tavalla kuin tiedostossa ilmoitetaan, tarkista tallennettu kerros komennoilla wp bs settings tai Settings::get_raw(), jotka palauttavat vain sen, mitä aktiivinen JSON- tai asetuslähde on nimenomaisesti määrittänyt.
Asetusten lukeminen lähteestä PHP
Blockstudio\Settings lataa aktiivisen lähteen, ilmoittaa virheellisestä JSON-määrityksestä ja lataa sen automaattisesti uudelleen, kun blockstudio.json muuttuu:
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);
}
Käytä arvoa Settings::get_raw(), kun integraatio tarvitsee vain aktiivisen JSON- tai asetusten lähteessä erikseen määritellyt arvot. Settings::fingerprint() palauttaa määritysten tehokkaan identiteetin yhdenmukaisessa muodossa. Pitkäkestoiset prosessit voivat kutsua Settings::reload()-toimintoa erikseen, jotta tiedostomuutos luetaan heti. Tavallisessa käytössä tiedosto tarkistetaan enintään kerran sekunnissa pyyntöä tai pitkäkestoista PHP-prosessia kohti, myös silloin, kun tiedoston koko ei muutu. Määritetyn polun muuttaminen tulee voimaan seuraavalla lukukerralla. Kun aktiivista JSON-tiedostoa ei ole, tietokantaan tallennettujen asetusten lukeminen ei viivästy tämän aikarajan vuoksi.
Ratkaistu suorituskykyprofiili on saatavilla toiminnolla Blockstudio\Runtime_Settings::current(). Se tukee vinoviiva- ja pistepolkuja:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Käytettävissä olevat asetukset
users
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
ids |
array | [] |
Muokkaajan käyttöoikeuden saavat käyttäjätunnukset |
roles |
array | [] |
Muokkaajan käyttöoikeuden saavat käyttäjäroolit |
assets
| Asetus | Tyyppi | Oletus | Kuvaus |
|---|---|---|---|
enqueue |
boolean | true |
Lisää lohkoresurssit jonoon automaattisesti |
reset.enabled |
boolean | false |
Poista Coren lohkotyylit ja ota editorin apuluokkien nollaus käyttöön |
reset.fullWidth |
array | [] |
Sisältötyypit, joissa käytetään täysleveää editoriasettelua |
minify.css |
boolean | false |
Pienennä CSS-tulostetta |
minify.js |
boolean | false |
Pienennä JS-tulostetta |
process.scss |
boolean | false |
Käsittele SCSS-tiedostot |
output |
string | source |
Käännettyjen resurssien tallennuspaikka: source tai cache |
inlineLimit |
integer | 0 |
Sivukohtainen tavumäärä ulkoisia lohkojen CSS-määrityksiä varten |
output käyttää oletusarvoisesti arvoa source, joka luo _dist-hakemiston kunkin lohkon viereen. Aseta arvoksi cache, jos haluat tallentaa käännetyt resurssit Blockstudio-välimuistihakemistoon. Näin lohkojen lähdepuu pysyy siistinä ja käyttöönotettavana muuttumattomasta työkopiosta. Lähteet Blockstudio, joissa uudelleenohjausta ei voi käyttää, tallentavat resurssit välimuistiin tästä asetuksesta riippumatta.
inlineLimit ei ole käytössä arvossa 0, joten jokainen ulkoinen tyylitiedosto säilyttää <link>-tunnisteensa.
Aseta arvoksi tavumäärä, jos haluat tulostaa sivun pienimmät ulkoiset lohkotyylit inline-muodossa, kunhan niiden kokonaiskoko pysyy kyseisen rajan sisällä. 40000 on samaan sääntöön Coren käyttämä raja WordPress. Katso kohta Pienten tyylitiedostojen tulostaminen inline-muodossa.
Kun reset.enabled on käytössä, Blockstudio kopioi myös suodatetut käyttöliittymän body_class-arvot editorin piirtoalueelle. Säädä vain editorissa käytettävää luokkaluetteloa toiminnolla blockstudio/editor/canvas/body_class.
cache
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
enabled |
boolean | true |
Ota käyttöön Blockstudio-tiedostopohjaiset välimuistit |
path |
string | "blockstudio/cache" |
Välimuistin polku, suhteessa sijaintiin WP_CONTENT_DIR tai absoluuttinen |
namespaceGrace |
integer | 86400 |
Kuinka monta sekuntia käytöstä poistunut välimuistin nimiavaruus säilytetään ennen siivousta |
Välimuistitiedostot tallennetaan oletusarvoisesti sijaintiin wp-content/blockstudio/cache, uploads-hakemiston ulkopuolelle. Suhteellinen path ratkaistaan sijainnista WP_CONTENT_DIR; absoluuttista polkua käytetään sellaisenaan. Tämä tukee ympäristöjä, joissa on erillinen kirjoitettava välimuistitaltio.
Kun toiminto Blockstudio on käytössä, tämä yksi juurihakemisto sisältää käännösten hyötykuormat, valmiiksi kootut lohkojen rekisteröintitiedot, ratkaistut editoriresurssit, Tailwind CSS, renderöintidokumentit, saarekkeiden osat, staattiset esirenderöinnit, graafihakemistot, jonot ja diagnostiikkatiedot. Kukin kohde eristetään verkon, sivuston, koko ajonaikaisen tunnisteen ja rajauksen mukaan. Ajonaikaiset tunnisteet kattavat arvot Blockstudio, asetukset, WordPress, PHP, aktiivisen teeman, aktiiviset lisäosat, loogiset etsintälähteet, isäntäympäristön kontekstin sekä operaation omistajan toimittamat nimenomaiset riippuvuuksien tiivisteet.
Sisällön, termien, käyttäjän ja metatietojen muutokset mitätöivät täytetyt kenttävalinnat, mutta eivät rakenteellisten lohkojen etsintää tai käännettyjä aineistoja. Valinnat päivitetään erikseen kiinteän koontipolun lukituksen alaisina. Peräkkäiset kirjoitukset, kuten käännösten synkronointi tai tuonti, yhdistetään: ensimmäinen kirjoitus hiljaisen jakson jälkeen käynnistää päivityksen heti, ja viimeinen kirjoitus näkyy kerran, kun kolmekymmentä sekuntia on kulunut. Aikaa voi säätää asetuksella blockstudio/cache/populate_debounce. Metatieto, jonka WordPress kirjoittaa kirjanpitotarkoituksiin, kuten artikkelin muokkauslukko, ei ole muutos; blockstudio/cache/populate_ignored_meta_keys laajentaa tätä luetteloa. Muokkain kysyy aina reaaliaikaiset vaihtoehdot, joten aikaväli vaikuttaa vain renderöintihetkellä luettaviin välimuistissa oleviin valintoihin. Lähdetiedostot ja koontiasetukset mitätöivät rakenteellisen välimuistin edelleen normaalisti. Valintojen ylikirjoittaminen ei tarkista välimuistihakemistoa uudelleen jokaisen sisältömuutoksen yhteydessä; säännöllinen siivous poistaa silti orvot väliaikaistiedostot. Kielikohtaiset ajonaikaiset tunnisteet pysyvät erillään; useat välimuistin nimiavaruuden hakemistot monikielisellä sivustolla eivät yksinään osoita välimuistiosumaa.
Lohkon db tietohakemiston SQLite-kirjaus ei hylkää välimuistissa olevia lohkon metatietoja. Muutokset kohteeseen db.php, valvottuihin lähdetiedostoihin tai tietohakemiston lähdetiedostojen ja alihakemistojen rakenteeseen mitätöivät edelleen välimuistin.
Samanaikaisissa ajonaikaisissa uudelleenkoonneissa valitaan yksi koonnin tekijä. Muut pyynnöt odottavat enintään viisi sekuntia ja käyttävät sitten viimeisimpiä kelvollisia lohkon metatietoja, jos niiden lähdetiedostot ja vaaditut käännetyt resurssit ovat edelleen olemassa. Kylmä pyyntö, jolla ei ole turvallista hyötykuormaa, palauttaa HTTP 503 arvolla Retry-After sen sijaan, että käynnistäisi uuden koonnin. blockstudio/cache/build_wait_budget-suodatin säätää odotusaikaa millisekunteina sekä rakenteellisissa uudelleenkoonneissa että valintojen päivityksissä. Isäntäympäristö, joka ei tue neuvoa-antavia tiedostolukkoja, päivittää valinnat ilman suojausta ja julkaisee ne silti, joten seuraava pyyntö osuu välimuistiin.
Aiemmista versioista jääneet käyttämättömät avainkohtaiset .build.lock-tiedostot kerätään tämän sivuston kaikista välimuistin nimiavaruuksista toiminnolla WP-Cron. Keruu alkaa viisi minuuttia päivityksen jälkeen, ja siinä poistetaan enintään 10,000 lukkoa minuutissa kymmenen sekunnin aikarajan puitteissa. wp bs cache status ilmoittaa jäljellä olevan määrän ja wp bs cache cleanup tyhjentää jonon heti; wp bs cache clear tyhjentää ajonaikaisen välimuistin. Jos ajastettu erä on yli kymmenen minuuttia myöhässä, koska cron ei toimi, pyynnöt käyvät kerran tunnissa läpi rajatun määrän lukkoja, jotta tyhjennys ei pysähdy. Viimeaikaisiin ja lukittuihin tiedostoihin ei kosketa, eikä uusia kiinteän polun lukkoja koskaan kerätä. Kun jono on tyhjennetty, sama erä poistaa hylätyt välimuistin nimiavaruudet, kun niiden namespaceGrace on kulunut umpeen. Tämä tehdään enintään kerran tunnissa sivustoa kohden, ja päivittäinen ajo säilytetään. Odotusaika alkaa ensimmäisestä tarkistuksesta, jossa nimiavaruus todetaan käytöstä poistetuksi, ei sen uusimmasta tiedostosta; nimiavaruutta ei koskaan poisteta, jos se on yhä käytössä jossakin rajauksessa.
Sisäisen välimuistin siivous ei kutsu WordPress-liitteiden poistoon liittyviä suodattimia. Ympäristöissä, joissa WP-Cron ei ole käytössä, tavallisen ajastetun cron-työntekijän on jatkettava toimintaansa. Älä poista summittaisesti aktiivisia lukitustiedostoja jonon tyhjentämiseksi.
blockstudio/settings/cache/path-asetus suodattimella muutetaan määritettyä arvoa. Käyttöönoton mukaisessa polunratkaisussa blockstudio/cache/dir suodattaa ratkaistun perushakemiston:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Isäntäympäristöt, joissa vuokralaisen tunniste poikkeaa WordPress-verkon tai -blogin tunnisteista, voivat suodattaa arvon blockstudio/cache/site_key. Tulos puhdistetaan ja sitä käytetään vain hakemiston osana. Serialisoitava ajonaikainen muunnelma, jonka on muutettava kohteiden tunnisteita, määritetään edelleen oikeaoppisesti kohdassa blockstudio/cache/context.
themeDefaults
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
titleTag |
boolean | false |
Ota käyttöön WordPress-otsikkotunnisteen teematoiminnallisuuden tuki |
suppressDirectoryUpdates |
boolean | false |
Poista aktiiviset ali- ja pääteemat hakemistopäivitysten tuloksista |
Kuviot käyttävät edelleen aiempaa Blockstudio\Patterns API; nämä oletusarvot eivät tuo käyttöön vaihtoehtoisia sivu- tai kuviokokonaisuuksia.
performance
compat-profiili jättää yleisen WordPress-toiminnan ennalleen. speed ja strict ottavat käyttöön samat valinnaiset käyttöliittymän oletusarvot; kukin ali-asetus voi ohittaa profiilin arvon.
Valinnaiset asetukset toimivat rekisteröitymisen portteina. Kun valinnainen ominaisuus on false, Blockstudio ei liitä kyseisen ominaisuuden käyttöliittymä-, ylläpito-, editori- tai REST-toimintoja eikä ajastettuja takaisinkutsuja. Early Serve- tai ajastetun lämmityksen poistaminen käytöstä sen käytön jälkeen suorittaa ominaisuuden omat siivoustoimet kerran; myöhemmät pyynnöt eivät tee mitään.
| Asetus | Tyyppi | Yhteensopivuuden oletusarvo | Nopeuden/tiukkuuden oletusarvo | Kuvaus |
|---|---|---|---|---|
profile |
merkkijono | "compat" |
Ei sovellu | compat, speed tai strict |
wordpress.headNoise |
totuusarvo | false |
true |
Poista yleinen head-havainnointi ja emojien tulostus |
wordpress.embeds |
totuusarvo | false |
true |
Poista oEmbed-havainnointi ja isäntäkoneen skriptit |
wordpress.xmlrpc |
totuusarvo | false |
true |
Poista käytöstä XML-RPC ja pingbackit |
wordpress.editor |
totuusarvo | false |
true |
Poista käytöstä etäeditorin löytämispinnat |
wordpress.frontendAssets |
totuusarvo | false |
true |
Poista yleiset coren käyttöliittymäresurssit |
wordpress.media |
totuusarvo | false |
true |
Käytä kuvien tulostuksen oletusarvoja |
wordpress.heartbeat |
totuusarvo | false |
true |
Rajoita Heartbeatin toimintaa editorien ulkopuolella |
preload.links |
merkkijono | "off" |
"intent" |
Esilataa saman alkuperän dokumentteja käyttäjän toiminnan jälkeen |
media.lazy |
totuusarvo | false |
true |
Käytä tunnisteen Blockstudio kuvien lataajaa |
media.skeleton |
totuusarvo | false |
true |
Näytä sisäänrakennettu latauksen paikkamerkki |
media.metadata |
totuusarvo | false |
true |
Ilmoita tunnisteen assets/media.json käytöstä |
media.rootMargin |
merkkijono | "300px" |
"300px" |
Laiskan lataajan leikkausalueen marginaali |
measurement.enabled |
totuusarvo | false |
false |
Ota käyttöön suorituksenaikaiset mittaus-API:t |
measurement.queryMonitor |
totuusarvo | false |
false |
Sisällytä kyselyt, joiden kesto on vähintään 50ms |
measurement.headers |
totuusarvo | false |
false |
Lähetä profiilin ja määrityksen hajautusarvo-otsakkeet |
measurement.timings |
totuusarvo | false |
false |
Lähetä suoritusaikaa koskeva otsake |
staticPrerender.enabled |
totuusarvo | false |
false |
Ota käyttöön anonyymisti turvallinen HTML-välimuisti |
staticPrerender.ttl |
kokonaisluku | 86400 |
86400 |
Välimuistiin tallennetun dokumentin enimmäisikä sekunteina |
staticPrerender.invalidate |
merkkijono | "signature" |
"signature" |
Käytä tunnistetta signature tai asteittaista graph-identiteettiä |
staticPrerender.earlyServe |
totuusarvo | false |
false |
Tarjoa turvalliset osumat ennen kuin WordPress käynnistyy |
staticPrerender.serveLoggedIn |
totuusarvo | false |
false |
Salli käyttäjien hyödyntää välimuistiosumia, mutta ei luoda niitä |
staticPrerender.dynamicPaths |
taulukko | [] |
[] |
Polkujen etuliitteet, joiden on pysyttävä dynaamisina |
staticPrerender.replayHeaders |
taulukko | ["Link"] |
["Link"] |
Välimuistiosumien yhteydessä tallennettavat ja lähetettävät vastausotsakkeet |
staticPrerender.warm.enabled |
totuusarvo | false |
false |
Ota käyttöön pysyvä ajastettu lämmitysjono |
staticPrerender.warm.interval |
kokonaisluku | 3600 |
3600 |
Lämmitysväli sekunteina |
staticPrerender.warm.concurrency |
kokonaisluku | 2 |
2 |
Yhdellä lämmityskerralla käsiteltävien töiden enimmäismäärä |
staticPrerender.warm.transport |
merkkijono | "http" |
"http" |
Käytä tunnistetta http tai isäntäkoneen tarjoamaa internal-renderöijää |
Staattinen esirenderöinti pysyy poissa käytöstä, ellei sitä erikseen oteta käyttöön. Kun pääkytkin on pois päältä, esirenderöintipyyntöjen koukkuja ei rekisteröidä, eikä käytöstä poistettuja earlyServe– ja warm.enabled-kytkimiä varten rekisteröidä ylläpito- tai cron-koukkuja. Allekirjoitustila käyttää tavallisissa pyynnöissä kevyttä aktivoitua identiteettiä. Graafitila on tarkoitettu erikseen käynnistettäviin koontiversioihin: se tallentaa sivukohtaiset lähderiippuvuudet, joten yhden sivun muuttaminen ei mitätöi muita dokumentteja. Katso Staattinen esirenderöinti lämmitystä, käyttöönottoa, varhaista tarjoilua ja turvallisuutta koskevat tiedot.
Mittaukset ovat saatavilla ohjelmallisesti:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Kun otsakkeet ovat käytössä, Blockstudio lähettää X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config ja valinnaisesti X-Blockstudio-Performance-Time. Toiminto blockstudio/performance/measurement_enabled saa ratkaistut suorituksenaikaiset asetukset.
Asetukset media ohjaavat bs_media_image()a, assets/media.json-manifestia ja käyttöliittymän laiskasti lataavaa apuria. Katso Media apufunktiota, manifestin koostajaa ja lataajan toimintaa varten.
content
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
enabled |
boolean | false |
Ota Content Sync -määritys käyttöön |
id |
string | "default" |
Synkronoituihin entiteetteihin tallennettava sisältöjoukon nimiavaruus |
path |
string | "content" |
Teeman suhteen määritetty sisältötiedostojen hakemisto |
includePageSyncManaged |
boolean | false |
Sisällytä Page Syncin hallitsemat artikkelit ottamatta niiden sisältöä omistukseen |
authors |
string | "ignore" |
Tekijän käsittely (ignore tai olemassa olevan käyttäjän login) |
postTypes |
array | [] |
Sallitut artikkelityypit |
meta.include |
array | [] |
Meta-avainten synkronoinnin glob-kuviot |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Meta-avainten poissulkemisen glob-kuviot |
meta.references |
object | {} |
Määritetyt metaviittaukset muunnetaan tunnusten ja UID-tunnusten välillä |
taxonomies |
array | [] |
Sallittujen rekisteröityjen taksonomioiden luettelo termeille ja suhteille |
media |
string | "manifest" |
Liiteviittausten toiminta (manifest tai none) |
Content Synciä hallitaan asetuksen wp bs content kautta, ja se vie sallitut artikkelit, artikkelimetatiedot ja määritetyt viittaukset siirrettäviin tiedostoihin. Katso Content Sync työnkulkua ja tiedostomuotoa varten.
editor
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
formatOnSave |
boolean | false |
Muotoile block.json tallennettaessa |
assets |
array | [] |
Lataa editoriin muita resursseja |
markup |
boolean | false |
Ota merkkauskoodin muokkaus käyttöön |
tailwind
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
enabled |
boolean | false |
Ota Tailwind CSS-käännös käyttöön |
config |
string | "" |
Tailwind v4 CSS-ensimmäinen määritys |
Katso Tailwind CSS käännöksen toimintaa ja CSS-ensimmäisen määrityksen muotoa varten.
blockTags
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
enabled |
boolean | false |
Ota sivukohtainen bs:-tunnisteiden renderöinti käyttöön artikkelien sisällössä ja vimpainten alueilla |
allow |
array | [] |
Lohkojen nimikuvioiden sallittujen luettelo; tukee fnmatch()-jokerimerkkejä |
deny |
array | [] |
Lohkojen nimikuvioiden estoluettelo; ohittaa allown |
prefixes |
object | {} |
Lyhytnimien etuliite nimiavaruuden määrittämiseen; kukin arvo on nimiavaruus tai järjestetty taulukko |
Mallipohjatason tunnisteiden renderöinti on aina aktiivinen; nämä asetukset ohjaavat sivutason korvaamista. Katso Renderöinti tunnistesyntaksia ja ratkaisusääntöjä varten.
ui
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
enabled |
boolean | false |
Rekisteröi mukana toimitetut bsui/* UI -komponentit ja app/*-esittelysovellukset |
blockEditor
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
disableLoading |
boolean | false |
Poista lohkojen lataaminen editorissa käytöstä |
enhance |
boolean | false |
Ota käyttöön Blockstudio-editorin osoitin- ja valintatoiminnot |
cssClasses |
array | [] |
Tyylitiedostojen URL-osoitteet, joista poimitaan CSS-luokat luokkakentän automaattista täydennystä varten |
cssVariables |
array | [] |
Tyylitiedostojen URL-osoitteet, joista poimitaan CSS-muuttujat koodikentän automaattista täydennystä varten |
blockEditor.blocks
Käytä asetusta blockEditor.blocks projektinlaajuiseen lohkonlisäyksen käytäntöön. allow ja deny hyväksyvät lohkojen nimiä ja jokerikuvioita, kuten core/*.
{
"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 poistaa rekisteröinnistä tyylit, jotka rekisteröitiin WordPress’
PHP lohkotyylirekisterin kautta:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Käytä asetusta blockEditor.patterns yleisten kuviolähteiden poistamiseen käytöstä ja kuvioluokkien suodattamiseen.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Käytä asetusta blockEditor.media yleisen medianlisäyksen käytäntöön.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
grab.enabled |
boolean | false |
Ota käyttöliittymän elementtien poimija käyttöön |
perf |
boolean | false |
Ota suorituskykyprofilointi käyttöön jokaisella sivulatauksella |
canvas.enabled |
boolean | false |
Ota kanvas käyttöön |
canvas.adminBar |
boolean | true |
Näytä WordPressn ylläpitopalkki kanvasta tarkasteltaessa |
githooks
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
commit |
boolean | false |
Luo analysointiin tarkoitetun esikäsittelykoukun, kun blockstudio-githooks sync suoritetaan |
Katso hallittu commit-koukku, mitä luotu koukku suorittaa ja miten se pidetään synkronoituna.
phpstan
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
preset |
string | "base" |
Analyysin esiasetus, kun komentorivillä ei valita asetusta: base, theme, extreme-theme tai wordpress-render |
configuration |
string | "" |
Projektin PHPStan-määritys, joka sisällytetään esiasetuksen rinnalle ja ratkaistaan lähteestä blockstudio.json |
roots |
array | ["."] |
Kanonisen komennon analysoimat teeman juurihakemistot |
excludePaths |
array | [] |
Muita skannerin poissulkemisia suhteessa kuhunkin määritettyyn juureen |
maxFiles |
integer | 10000 |
Teemaskannerin tarkastamien tiedostojen enimmäismäärä |
blockTags |
object | {} |
Elementtikartoitukset, tunnistealiakset ja scanPhp lohkon tunnistesäännölle |
Nämä asetukset ohjaavat kanonista blockstudio-phpstan-komentoa. Katso PHPStan esiasetuksia, kerroksia ja käyttöönottoa varten.
ai
| Valinta | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Luo yhdistetty kontekstitiedosto, joka sisältää lohkot, asetukset, skeemat ja dokumentaation LLM-työkaluille |
Katso Tekoälyintegraatio dokumentaation hakemistoa ja koko luotua tekstiä varten.
Ota käyttöön ja kokoa yhteen mukana toimitetut headless-UI-komponentit, jotka esiteltiin versiossa Blockstudio 7.3.