Pereiti prie turinio

Nustatymai

Blockstudio turi galingą nustatymų API, leidžiantį nustatyti parinktis naudojant blockstudio.json failą temos aplanke ir (arba) filtrus. Be to, teises turintys naudotojai gali keisti nustatymus vizualiai administravimo srityje.

Per JSON

Jei temos aplanke yra blockstudio.json failas, jis bus naudojamas numatytosioms dabartinės svetainės parinktims nustatyti. Failo tikrinimui ir automatinio užbaigimo palaikymui IDE aplinkoje galima naudoti JSON schemą.

Šis failas neprivalomas. Jei jo nėra, Blockstudio naudoja administravimo srityje išsaugotus nustatymus ir savo įtaisytąsias numatytąsias reikšmes. Failo pridėjimas, keitimas ar pašalinimas aptinkamas automatiškai, todėl nereikia išvalyti talpyklos ar perkrauti rankiniu būdu.

Galimos šios savybės:

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

Per filtrus

Arba galite naudoti filtrą blockstudio/settings/${setting} ir nustatyti parinktis per PHP, kad turėtumėte daugiau lankstumo.

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

Per filtrą blockstudio/settings/${setting} nustatytos parinktys turi pirmenybę prieš nustatytas faile blockstudio.json. Abu būdus galima naudoti kartu.

Vykdymo metu pasiekiami ir blockstudio/performance/${setting} filtrai, taip pat vienas baigiamasis filtras blockstudio/performance/config. Pastarasis turi grąžinti galiojantį konfigūracijos objektą.

Kaip sluoksniuojami šaltiniai

Kiekvienas šaltinis įkeliamas ir sujungiamas, pradedant mažiausio prioriteto šaltiniu:

  1. Įtaisytosios numatytosios reikšmės
  2. Administravimo srityje išsaugoti nustatymai UI (parinktis blockstudio_settings)
  3. Temoje esantis blockstudio.json
  4. Filtrai blockstudio/settings/*

blockstudio.json pakeičia tik tas raktų reikšmes, kurias apibrėžia. Anksčiau jis visiškai pakeisdavo išsaugotus nustatymus, tad vos atsiradus failui, nustodavo galioti nesusijusi administravimo srityje išsaugota reikšmė; dabar failo nustatymai taikomi virš jų. Kita vertus, pasenusi reikšmė, išsaugota administravimo srityje per UI, lieka galioti, kol failas apibrėžia tą raktą arba išsaugota reikšmė pašalinama. Jei nustatymas veikia kitaip, nei nurodyta faile, patikrinkite išsaugotų nustatymų sluoksnį naudodami wp bs settings arba Settings::get_raw(); šis grąžina tik tai, ką aiškiai apibrėžė aktyvus JSON arba parinkčių šaltinis.

Nustatymų skaitymas iš PHP

Blockstudio\Settings įkelia aktyvų šaltinį, praneša apie netaisyklingą JSON ir automatiškai įkelia iš naujo, kai pasikeičia 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);
}

Naudokite Settings::get_raw(), kai integracijai reikia tik aktyvaus JSON arba parinkčių šaltinio aiškiai deklaruotų reikšmių. Settings::fingerprint() grąžina deterministinį efektyvių nustatymų identifikatorių. Ilgai veikiančiuose procesuose galima aiškiai iškviesti Settings::reload(), kad failo pakeitimas būtų pastebėtas iškart. Įprastos prieigos metu failas patikrinamas ne dažniau kaip kartą per sekundę užklausos arba ilgai veikiančiame PHP procese, įskaitant atvejus, kai redaguoto failo dydis nepasikeičia. Konfigūruoto kelio pakeitimas įsigalioja kitą kartą skaitant. Jei aktyvaus JSON failo nėra, šis intervalas neatideda duomenų bazėje išsaugotų nustatymų nuskaitymo.

Nustatytas našumo profilis pasiekiamas per Blockstudio\Runtime_Settings::current(). Palaikomi keliai su pasviruoju brūkšniu arba tašku:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

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

Galimi nustatymai

users

Parinktis Tipas Numatytoji reikšmė Aprašymas
ids masyvas [] Naudotojų ID, turintys prieigą prie redaktoriaus
roles masyvas [] Naudotojų vaidmenys, turintys prieigą prie redaktoriaus

assets

Parinktis Tipas Numatytoji reikšmė Aprašymas
enqueue loginis true Automatiškai įtraukti blokų išteklius į eilę
reset.enabled loginis false Pašalinti pagrindinius blokų stilius ir pritaikyti redaktoriaus paslauginių klasių nustatymą iš naujo
reset.fullWidth masyvas [] Įrašų tipai, kuriuose naudojamas viso pločio redaktoriaus išdėstymas
minify.css loginis false Sumažinti CSS išvesties dydį
minify.js loginis false Sumažinti JS išvesties dydį
process.scss loginis false Apdoroti SCSS failus
output eilutė source Kur įrašomi sukompiliuoti ištekliai: source arba cache
inlineLimit sveikasis skaičius 0 Į eilutę įterpiamų išorinių blokų CSS baitų skaičius kiekviename puslapyje

output numatytoji reikšmė yra source; taip šalia kiekvieno bloko sukuriamas katalogas _dist. Nustatykite cache, kad sukompiliuoti ištekliai būtų įrašomi į Blockstudio talpyklos katalogą ir bloko šaltinio medis liktų švarus bei tinkamas diegti iš nekintamos kopijos. Šaltiniai Blockstudio ir taip negali rašyti į nurodytą vietą, todėl visada nukreipiami į talpyklą, neatsižvelgiant į šį nustatymą.

inlineLimit pagal numatytuosius nustatymus išjungta 0, todėl kiekviena išorinė stiliaus lentelė išlaiko savo <link> žymą. Vietoj to nustatykite baitų skaičių, kad mažiausios puslapio išorinės blokų stiliaus lentelės būtų įterptos į puslapį, jei jų bendras dydis neviršija šio skaičiaus. 40000 yra riba, kurią tai pačiai taisyklei naudoja WordPress. Žr. Mažų stiliaus lentelių įterpimas.

Kai aktyvus reset.enabled, Blockstudio į redaktoriaus drobę taip pat nukopijuoja išvalytas išorinės sąsajos body_class reikšmes. Redaktoriuje naudojamų klasių sąrašą koreguokite su blockstudio/editor/canvas/body_class.

cache

Parinktis Tipas Numatytoji reikšmė Aprašymas
enabled loginė true Įjungti failais pagrįstas Blockstudio talpyklas
path eilutė "blockstudio/cache" Talpyklos kelias, santykinis su WP_CONTENT_DIR arba absoliutus
namespaceGrace sveikasis skaičius 86400 Kiek sekundžių po pašalinimo išlaikyti seną talpyklos vardų sritį prieš ją išvalant

Pagal numatytuosius nustatymus talpyklos failai įrašomi į wp-content/blockstudio/cache, už įkėlimų katalogo ribų. Santykinis path sprendžiamas nuo WP_CONTENT_DIR, o absoliutus kelias naudojamas tiesiogiai. Taip palaikomi serveriai, kuriuose yra atskiras įrašomas talpyklos diskas.

Įjungus, Blockstudio šiame pagrindiniame kataloge saugo kūrimo duomenis, iš anksto paruoštus blokų registracijos duomenis, išspręstus redaktoriaus išteklius, Tailwind CSS, atvaizdavimo dokumentus, salų fragmentus, statinius išankstinio atvaizdavimo rezultatus, grafų indeksus, eiles ir diagnostikos duomenis. Kiekvienas objektas atskiriamas pagal tinklą, svetainę, visą vykdymo aplinkos tapatybę ir apimtį. Vykdymo aplinkos tapatybė apima Blockstudio, nustatymus, WordPress, PHP, aktyvią temą, aktyvius papildinius, loginius aptikimo šaltinius, pagrindinio kompiuterio kontekstą ir operacijos savininko pateiktas aiškias priklausomybių maišos reikšmes.

Turinio, termino, naudotojo ir metaduomenų pakeitimai panaikina užpildytus laukų pasirinkimus, bet nepaveikia struktūrinių blokų paieškos ar sukompiliuotų išteklių. Pasirinkimai atnaujinami atskirai, taikant fiksuoto kūrimo kelio užraktą. Keli iš eilės atliekami įrašymai, pavyzdžiui, vertimų sinchronizavimas ar importavimas, sujungiami: pirmasis įrašymas po ramybės laikotarpio atnaujina pasirinkimus iš karto, o paskutinis šios sekos įrašymas atsispindi praėjus trisdešimčiai sekundžių; šį laiką galima keisti naudojant blockstudio/cache/populate_debounce. Metaduomenys, kuriuos WordPress įrašo kaip apskaitos duomenis, pavyzdžiui, įrašo redagavimo užraktą, nelaikomi pakeitimu; blockstudio/cache/populate_ignored_meta_keys papildo šį sąrašą. Redaktorius visada užklausia naujausių parinkčių, todėl šis laikotarpis turi įtakos tik atvaizdavimo metu skaitomiems podėlyje saugomiems pasirinkimams. Šaltinio failai ir kūrimo nustatymai kaip įprasta panaikina struktūrinį podėlį. Perrašant pasirinkimus, podėlio katalogas nenuskaitomas kaskart pasikeitus turiniui; periodiškai vykdomas valymas vis tiek pašalina našlaičiais tapusius laikinuosius failus. Konkrečiai kalbai būdingos vykdymo aplinkos tapatybės išlieka atskirtos; kelios podėlio vardų srities direktorijos daugiakalbėje svetainėje savaime nereiškia, kad podėlis praleistas.

SQLite žurnalo įrašai bloko db duomenų direktorijoje nepanaikina podėlyje saugomų bloko metaduomenų. Pakeitimai, susiję su db.php, stebimais šaltinio failais arba duomenų direktorijos šaltinio failų ir pakatalogių struktūra, vis tiek panaikina podėlį.

Lygiagrečiai atkuriant vykdymo aplinką išrenkamas vienas kūrimo procesas. Kitos užklausos laukia iki penkių sekundžių, tada pakartotinai naudoja paskutinius tinkamus blokų metaduomenis, jei jų šaltinio failai ir reikalingi sukompiliuoti ištekliai vis dar yra. Šaltoji užklausa, neturinti saugių duomenų, grąžina HTTP 503 su Retry-After, o ne pradeda kitą kūrimo procesą. Filtras blockstudio/cache/build_wait_budget nustato laukimo trukmę milisekundėmis tiek atkuriant struktūrą, tiek atnaujinant pasirinkimus. Serveryje be patariamųjų failų užraktų pasirinkimai atnaujinami be apsaugos, bet vis tiek paskelbiami, todėl kita užklausa juos ras.

Ankstesnių versijų palikti nenaudojami konkretaus rakto .build.lock failai pašalinami iš visų šios svetainės talpyklos vardų sričių, naudojant WP-Cron; procesas pradedamas praėjus penkioms minutėms po naujinimo ir per dešimties sekundžių laikotarpį kas minutę pašalinama iki 10,000 užraktų. wp bs cache status pateikia likusių užraktų skaičių, o wp bs cache cleanup iškart išvalo eilę; wp bs cache clear išvalo vykdymo aplinkos talpyklą. Jei suplanuotas paketas vėluoja daugiau nei dešimt minučių, nes neveikia cron, užklausos kartą per valandą patikrina ribotą skaičių užraktų, kad valymas neužstrigtų. Naujausi ar laikomi užraktai neliečiami, o nauji fiksuoto kelio užraktai niekada nešalinami. Išvalius eilę, tame pačiame pakete pašalinamos ir apleistos talpyklos vardų sritys, kai sueina jų namespaceGrace; tai daroma ne dažniau kaip kartą per valandą kiekvienai svetainei, o procesui palaikyti kasdien paliekamas suplanuotas paleidimas. Laikotarpis skaičiuojamas nuo pirmojo patikrinimo, aptikus pašalintą vardų sritį, o ne nuo naujausio jos failo; vis dar naudojama bent vienos apimties vardų sritis niekada nešalinama. Vidinis talpyklos valymas nekviečia WordPress priedų trynimo filtrų. Serveriuose, kuriuose WP-Cron išjungtas, įprastas suplanuotas cron darbinis procesas turi veikti toliau; nešalinkite visų aktyvių užraktų failų vien tam, kad išvalytumėte eilę.

Nustatymo filtras blockstudio/settings/cache/path pakeičia sukonfigūruotą reikšmę. Jei kelią reikia nustatyti konkrečiai diegimo aplinkai, naudokite blockstudio/cache/dir filtrą išspręstam pagrindiniam katalogui:

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

Serveriai, kurių nuomininko tapatybė skiriasi nuo WordPress tinklo ar tinklaraščio ID, gali filtruoti blockstudio/cache/site_key. Rezultatas išvalomas ir naudojamas tik kaip katalogo segmento pavadinimas. blockstudio/cache/context išlieka tinkama vieta serializuojamam vykdymo aplinkos variantui, kuris turi pakeisti objektų tapatybes.

themeDefaults

Parinktis Tipas Numatytoji reikšmė Aprašymas
titleTag loginė false Įjungti WordPress temos palaikymą pavadinimo žymai
suppressDirectoryUpdates loginė false Pašalinti aktyvias antrines ir pagrindines temas iš katalogo naujinimų rezultatų

Šablonai ir toliau naudoja esamą Blockstudio\Patterns API; šios numatytosios reikšmės nesukuria alternatyvių puslapių ar šablonų sąsajų.

performance

Profilis compat nekeičia bendrojo WordPress veikimo. speed ir strict įjungia tas pačias pasirenkamas išorinės sąsajos numatytąsias reikšmes; kiekvienas antrinis nustatymas gali pakeisti savo profilio reikšmę.

Pasirenkami nustatymai yra registracijos sąlygos. Kai pasirenkama funkcija yra false, Blockstudio neprijungia jos išorinės sąsajos, administravimo, redaktoriaus, REST ar suplanuotų atgalinių iškvietimų. Išjungus „Early Serve“ arba suplanuotą įšilimą, prieš tai panaudojus šią funkciją, vieną kartą atliekamas jai skirtas išvalymas; vėlesnės užklausos nieko nedaro.

Parinktis Tipas Suderinamumo numatytoji reikšmė Greičio ir griežto režimo numatytoji reikšmė Aprašymas
profile string "compat" Netaikoma compat, speed arba strict
wordpress.headNoise boolean false true Pašalinti bendrąją antraštės aptikimo ir jaustukų išvestį
wordpress.embeds boolean false true Pašalinti oEmbed aptikimą ir prieglobos scenarijus
wordpress.xmlrpc boolean false true Išjungti XML-RPC ir pingbacks
wordpress.editor boolean false true Išjungti nuotolinio redaktoriaus aptikimo sąsajas
wordpress.frontendAssets boolean false true Pašalinti bendruosius pagrindinius priekinės dalies išteklius
wordpress.media boolean false true Taikyti numatytuosius vaizdų išvesties nustatymus
wordpress.heartbeat boolean false true Riboti Heartbeat dažnį ne redaktoriuose
preload.links string "off" "intent" Iš anksto gauti tos pačios kilmės dokumentus po naudotojo veiksmo
media.lazy boolean false true Naudoti Blockstudio vaizdų įkėliklį
media.skeleton boolean false true Rodyti integruotą įkėlimo karkasą
media.metadata boolean false true Deklaruoti assets/media.json naudojimą
media.rootMargin string "300px" "300px" Atidėtojo įkėliklio susikirtimo paraštė
measurement.enabled boolean false false Įjungti veikimo metu naudojamas matavimo API
measurement.queryMonitor boolean false false Įtraukti užklausas, trunkančias bent 50ms
measurement.headers boolean false false Siųsti profilio ir konfigūracijos maišos antraštes
measurement.timings boolean false false Siųsti veikimo trukmės antraštę
staticPrerender.enabled boolean false false Įjungti anoniminiams naudotojams saugų HTML spartinimą podėlyje
staticPrerender.ttl integer 86400 86400 Maksimalus podėlyje saugomo dokumento amžius sekundėmis
staticPrerender.invalidate string "signature" "signature" Naudoti signature arba laipsniškai kintančią graph tapatybę
staticPrerender.earlyServe boolean false false Pateikti saugius podėlio rezultatus prieš paleidžiant WordPress
staticPrerender.serveLoggedIn boolean false false Leisti naudotojams naudoti podėlio rezultatus, bet jų nekaupti
staticPrerender.dynamicPaths array [] [] Kelių prefiksai, kurie turi išlikti dinaminiai
staticPrerender.replayHeaders array ["Link"] ["Link"] Atsakymo antraštės, saugomos kartu su podėlio rezultatais ir siunčiamos juos pateikus
staticPrerender.warm.enabled boolean false false Įjungti patvarią suplanuotą pašildymo eilę
staticPrerender.warm.interval integer 3600 3600 Pašildymo intervalas sekundėmis
staticPrerender.warm.concurrency integer 2 2 Didžiausias vieno pašildymo etapo apdorojamų užduočių skaičius
staticPrerender.warm.transport string "http" "http" Naudoti http arba prieglobos teikėjo pateiktą internal atvaizduoklį

Statinis išankstinis generavimas lieka išjungtas, nebent jis aiškiai įjungiamas. Išjungtas pagrindinis jungiklis neužregistruoja jokių išankstinio generavimo užklausų kabliukų, o išjungti earlyServe ir warm.enabled jungikliai neužregistruoja jokių administravimo ar cron kabliukų. Parašo režimas įprastose užklausose naudoja nebrangią aktyvuotą tapatybę. Grafų režimas skirtas aiškiai inicijuojamoms versijoms kurti: jis įrašo kiekvieno puslapio šaltinio priklausomybes, todėl pakeitus vieną puslapį nesugadinami nesusiję dokumentai. Informacijos apie apšildymą, diegimą, ankstyvą pateikimą ir saugą rasite Statinio išankstinio generavimo puslapyje.

Matavimus galima gauti programiškai:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Kai antraštės įjungtos, Blockstudio siunčia X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config ir pasirinktinai X-Blockstudio-Performance-Time. Veiksmas blockstudio/performance/measurement_enabled gauna išspręstus vykdymo aplinkos nustatymus.

Parinktys media valdo bs_media_image(), assets/media.json manifestą ir sąsajos tingiojo įkėlimo įrankį. Pagalbinės funkcijos, manifesta kūrimo įrankio ir įkėlimo veikimo aprašą rasite puslapyje Medija.

content

Parinktis Tipas Numatytoji reikšmė Aprašymas
enabled boolean false Įjungti turinio sinchronizavimo konfigūraciją
id string "default" Sinchronizuotuose objektuose saugoma turinio rinkinio vardų sritis
path string "content" Su tema susietas turinio failų katalogas
includePageSyncManaged boolean false Įtraukti „Page Sync“ valdomus įrašus, neperimant jų turinio
authors string "ignore" Autorių tvarkymas (ignore arba esamas naudotojo login)
postTypes array [] Leidžiamų įrašų tipų sąrašas
meta.include array [] Sinchronizuojamų meta raktų globalieji šablonai
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Neįtraukiamų meta raktų globalieji šablonai
meta.references object {} Deklaruotos meta nuorodos, perrašomos tarp ID ir UID
taxonomies array [] Leidžiamų registruotų taksonomijų terminams ir ryšiams sąrašas
media string "manifest" Priedo nuorodos veiksena (manifest arba none)

Turinio sinchronizavimas valdomas per wp bs content ir eksportuoja leidžiamus įrašus, įrašo meta duomenis ir deklaruotas nuorodas į perkeliamus failus. Darbo eigą ir failo formatą rasite puslapyje Turinio sinchronizavimas.

editor

Parinktis Tipas Numatytoji reikšmė Aprašymas
formatOnSave boolean false Formatuoti block.json įrašant
assets array [] Papildomi ištekliai, įkeliami redaktoriuje
markup boolean false Įjungti žymėjimo redagavimą

tailwind

Parinktis Tipas Numatytoji reikšmė Aprašymas
enabled boolean false Įjungti Tailwind CSS kompiliavimą
config string "" Tailwind v4 konfigūracija, kurioje pirmiausia naudojamas CSS

Kompiliavimo veikimo ir konfigūracijos formato, kuriame pirmiausia naudojamas CSS, aprašą rasite puslapyje Tailwind CSS.

blockTags

Parinktis Tipas Numatytoji reikšmė Aprašymas
enabled boolean false Įjungti puslapio lygmens bs: žymų atvaizdavimą įrašų turinyje ir valdiklių srityse
allow array [] Leidžiamų blokų pavadinimų šablonų sąrašas; palaikomos fnmatch() pakaitos
deny array [] Draudžiamų blokų pavadinimų šablonų sąrašas; turi pirmenybę prieš allow
prefixes object {} Priešdėlis trumpiniams priskirti vardų sričiai; kiekviena reikšmė yra vardų sritis arba surikiuotas masyvas

Šablonų lygmens žymų atvaizdavimas visada aktyvus; šios parinktys valdo pakeitimą puslapio lygmeniu. Žymų sintaksę ir sprendimo taisykles rasite puslapyje Atvaizdavimas.

ui

Parinktis Tipas Numatytoji reikšmė Aprašymas
enabled boolean false Registruoti komplekte esančius bsui/* UI komponentus ir app/* demonstracines programas

blockEditor

Parinktis Tipas Numatytoji reikšmė Aprašymas
disableLoading boolean false Išjungti blokų įkėlimą redaktoriuje
enhance boolean false Įjungti Blockstudio redaktoriaus užvedimo ir pasirinkimo valdiklius
cssClasses array [] Stilių lentelių URL, iš kurių ištraukiamos CSS klasės klasės lauko automatinio užbaigimo funkcijai
cssVariables array [] Stilių lentelių URL, iš kurių ištraukiami CSS kintamieji kodo lauko automatinio užbaigimo funkcijai

blockEditor.blocks

Naudokite blockEditor.blocks viso projekto blokų įterpimo politikai nustatyti. allow ir deny priima blokų pavadinimus ir pakaitos šablonus, pvz., 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 išregistruoja stilius, užregistruotus per WordPress’ PHP blokų stilių registrą:

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

blockEditor.patterns

Naudokite blockEditor.patterns, kad išjungtumėte visuotinius šablonų šaltinius ir filtruotumėte šablonų kategorijas.

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

blockEditor.media

Naudokite blockEditor.media visuotinio medijos įterpimo politikai nustatyti.

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

dev

Parinktis Tipas Numatytoji reikšmė Aprašymas
grab.enabled boolean false Įjungti sąsajos elementų fiksavimo įrankį
perf boolean false Įjungti našumo profiliavimo įrankį kiekvieno puslapio įkėlimo metu
canvas.enabled boolean false Įjungti drobę
canvas.adminBar boolean true Rodant drobę, rodyti WordPress administravimo juostą

githooks

Parinktis Tipas Numatytoji reikšmė Aprašymas
commit boolean false Kai vykdoma blockstudio-githooks sync, generuoti tik analizę atliekantį išankstinio patvirtinimo kabliuką

Apie tai, ką vykdo sugeneruotas kabliukas ir kaip jis sinchronizuojamas, skaitykite puslapyje valdomas įrašymo kabliukas.

phpstan

Parinktis Tipas Numatytoji reikšmė Aprašymas
preset string "base" Analizės išankstinis nustatymas, kai komandinė eilutė nepasirenka jokio: base, theme, extreme-theme arba wordpress-render
configuration string "" Projekto PHPStan konfigūracija, įtraukiama kartu su išankstiniu nustatymu ir nustatoma pagal blockstudio.json
roots array ["."] Temos šakniniai katalogai, analizuojami kanonine komanda
excludePaths array [] Papildomos skaitytuvo išimtys, taikomos kiekvienam sukonfigūruotam šakniniam katalogui
maxFiles integer 10000 Didžiausias temų skaitytuvo tikrinamų failų skaičius
blockTags object {} Elementų susiejimai, žymų pseudonimai ir scanPhp, skirti blokų žymų taisyklei

Šie nustatymai valdo kanoninę komandą blockstudio-phpstan. Išankstinius nustatymus, sluoksnius ir pritaikymą rasite puslapyje PHPStan.

ai

Parinktis Tipas Numatytoji reikšmė Aprašymas
enableContextGeneration boolean false Generuoti bendrą blokų, nustatymų, schemų ir dokumentacijos konteksto failą LLM įrankiams

Dokumentacijos rodyklę ir visą sugeneruotą tekstą rasite puslapyje DI integracija.

UI Komponentai

Įjunkite ir komponuokite komplekte esančius bemodulius UI komponentus, pristatytus Blockstudio 7.3 versijoje.