Siirry sisältöön

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ä:

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

Suodattimien kautta

Vaihtoehtoisesti voit käyttää blockstudio/settings/${setting}-suodatinta asetusten määrittämiseen PHP-arvoilla, jolloin saat enemmän joustavuutta.

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

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ä:

  1. Sisäänrakennetut oletusarvot
  2. Hallinnan kautta tallennetut asetukset UI (valinta blockstudio_settings)
  3. Teeman blockstudio.json
  4. 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:

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

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:

PHP
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:

PHP
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:

PHP
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/*.

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 poistaa rekisteröinnistä tyylit, jotka rekisteröitiin WordPress’ PHP lohkotyylirekisterin kautta:

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

UI Komponentit

Ota käyttöön ja kokoa yhteen mukana toimitetut headless-UI-komponentit, jotka esiteltiin versiossa Blockstudio 7.3.