Pāriet uz saturu

Iestatījumi

Blockstudio ietver jaudīgu iestatījumu API, kas ļauj iestatīt opcijas, izmantojot blockstudio.json failu savas tēmas mapē un/vai filtrus. Turklāt lietotāji ar atļaujām var vizuāli mainīt iestatījumus administrēšanas sadaļā.

Ar JSON

Ja tēmas mapē ir blockstudio.json fails, tas tiks izmantots, lai iestatītu pašreizējās vietnes noklusējuma opcijas. Ir pieejama JSONshēma, kas pārbauda failu un palīdz automātiski pabeigt kodu IDE.

Šis fails nav obligāts. Ja tā nav, Blockstudio izmanto administrēšanas sadaļā saglabātos iestatījumus kopā ar iebūvētajiem noklusējuma iestatījumiem. Faila pievienošana, maiņa vai noņemšana tiek noteikta automātiski, tāpēc kešatmiņa nav jādzēš un lapa nav manuāli jāpārlādē.

Pieejami šādi rekvizīti:

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

Ar filtriem

Varat arī izmantot filtru blockstudio/settings/${setting}, lai iestatītu opcijas, izmantojot PHP, un iegūtu lielāku elastību.

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

Ar filtru blockstudio/settings/${setting} iestatītās opcijas aizstās tās, kas iestatītas failā blockstudio.json. Abas metodes var izmantot kopā.

Izpildlaika vērtības nodrošina arī blockstudio/performance/${setting} filtrus un vienu gala filtru blockstudio/performance/config. Tam jāatgriež derīgs konfigurācijas objekts.

Kā tiek apvienoti avoti

Katrs avots tiek ielādēts un apvienots, sākot ar zemāko prioritāti:

  1. Iebūvētie noklusējuma iestatījumi
  2. Administrēšanas sadaļā UI saglabātie iestatījumi (opcija blockstudio_settings)
  3. Tēmas blockstudio.json
  4. blockstudio/settings/* filtri

blockstudio.json aizstāj tikai tās atslēgas, ko tas deklarē. Agrāk tas pilnībā aizstāja saglabātos iestatījumus, tāpēc, tiklīdz fails parādījās, nesaistīta administrēšanas sadaļā saglabāta vērtība vairs netika lietota; tagad faila vērtības tiek piemērotas virs tām. Taču administrēšanas sadaļā UI saglabāta novecojusi vērtība turpina darboties, līdz fails deklarē attiecīgo atslēgu vai saglabātā vērtība tiek noņemta. Ja iestatījums darbojas citādi, nekā norādīts failā, pārbaudiet saglabāto slāni ar wp bs settings vai Settings::get_raw(), kas atgriež tikai to, ko aktīvais JSON vai opciju avots ir skaidri deklarējis.

Iestatījumu nolasīšana no PHP

Blockstudio\Settings ielādē aktīvo avotu, ziņo par nederīgu JSON un automātiski atkārtoti ielādējas, kad mainās 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);
}

Izmantojiet Settings::get_raw(), ja integrācijai nepieciešamas tikai vērtības, kas ir skaidri deklarētas aktīvajā JSON vai opciju avotā. Settings::fingerprint() atgriež deterministisku efektīvo iestatījumu identifikatoru. Ilgstoši darbojošies procesi var tieši izsaukt Settings::reload(), lai nekavējoties nolasītu faila izmaiņas. Parastās piekļuves laikā fails tiek pārbaudīts ne biežāk kā reizi sekundē vienā pieprasījumā vai ilgstoši darbojošā PHP procesā, tostarp, ja fails ir mainīts, bet tā izmērs palicis nemainīgs. Konfigurētā ceļa maiņa stājas spēkā nākamajā lasīšanas reizē. Ja aktīva JSON faila nav, šis intervāls nekavē saglabātos datubāzes iestatījumus.

Atrisinātajam veiktspējas profilam var piekļūt, izmantojot Blockstudio\Runtime_Settings::current(). Tas atbalsta ceļus ar slīpsvītrām vai punktiem:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

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

Pieejamie iestatījumi

users

Opcija Tips Noklusējums Apraksts
ids masīvs [] Lietotāju ID ar redaktora piekļuvi
roles masīvs [] Lietotāju lomas ar redaktora piekļuvi

assets

Opcija Veids Noklusējums Apraksts
enqueue Būla vērtība true Automātiski iekļaut bloku resursus rindā
reset.enabled Būla vērtība false Noņemt kodola bloku stilus un lietot redaktora utilītu atiestatījumu
reset.fullWidth Masīvs [] Ierakstu veidi, kuros izmantot pilna platuma redaktora izkārtojumu
minify.css Būla vērtība false Samazināt CSS izvadi
minify.js Būla vērtība false Samazināt JS izvadi
process.scss Būla vērtība false Apstrādāt SCSS failus
output Virkne source Kur tiek rakstīti kompilētie resursi: source vai cache
inlineLimit Vesels skaitlis 0 Vienā lapā iekļauto ārējo bloku CSS baitu skaits

output noklusējuma vērtība ir source, kas blakus katram blokam izveido mapi _dist. Iestatiet vērtību uz cache, lai kompilētos resursus rakstītu Blockstudio kešatmiņas mapē un bloku avota koks būtu tīrs un izvietojams no nemaināmas koda kopijas. Avoti Blockstudio, kuros nevar rakstīt, neatkarīgi no šī iestatījuma jau tagad tiek novirzīti uz kešatmiņu.

inlineLimit ir izslēgts pie 0, tāpēc katra ārējā stila lapa saglabā savu <link> tagu. Iestatiet baitu skaitu, lai tā vietā lapas mazākās ārējās bloka stila lapas ievietotu iekļauti, ja vien to kopējais izmērs nepārsniedz šo skaitu. 40000 ir ierobežojums, ko WordPress core izmanto tam pašam noteikumam. Skatiet Iekļaut mazas stila lapas.

Ja ir aktīvs reset.enabled, Blockstudio redaktora kanvā iekopē arī attīrītās priekšgala body_class vērtības. Izmantojiet blockstudio/editor/canvas/body_class, lai pielāgotu tikai redaktorā izmantoto klašu sarakstu.

cache

Opcija Tips Noklusējums Apraksts
enabled loģiskā vērtība true Iespējot kešatmiņas, kuru pamatā ir Blockstudio faili
path virkne "blockstudio/cache" Kešatmiņas ceļš: relatīvs pret WP_CONTENT_DIR vai absolūts
namespaceGrace vesels skaitlis 86400 Sekundes, cik ilgi saglabā novecojušu kešatmiņas nosaukumvietu pirms tās tīrīšanas

Pēc noklusējuma kešatmiņas faili tiek rakstīti mapē wp-content/blockstudio/cache, ārpus augšupielāžu mapes. Relatīvs path tiek noteikts attiecībā pret WP_CONTENT_DIR; absolūts ceļš tiek izmantots tieši. Tas ir piemērots mitināšanas pakalpojumiem, kas nodrošina atsevišķu rakstāmu kešatmiņas sējumu.

Ja šī funkcija ir iespējota, Blockstudio izmanto šo vienīgo saknes mapi būvēšanas datiem, iepriekš sagatavotiem bloku reģistrācijas datiem, atrisinātiem redaktora resursiem, Tailwind CSS, renderēšanas dokumentiem, salu fragmentiem, statiskām iepriekš renderētām lapām, grafu indeksiem, rindām un diagnostikas datiem. Katrs objekts ir izolēts pēc tīkla, vietnes, pilnas izpildlaika identitātes un tvēruma. Izpildlaika identitātes ietver Blockstudio, iestatījumus, WordPress, PHP, aktīvo tēmu, aktīvos spraudņus, loģiskos atklāšanas avotus, mitinātāja kontekstu un skaidri norādītas atkarību jaucējvērtības, ko nodrošina attiecīgā darbība.

Satura, terminu, lietotāju un metadatu izmaiņas padara nederīgas aizpildītās lauku izvēles, bet ne strukturālo bloku noteikšanu vai kompilētos resursus. Izvēles tiek atjauninātas atsevišķi, izmantojot fiksētu būvēšanas ceļa bloķētāju. Vairāki strauji secīgi ieraksti, piemēram, tulkojumu sinhronizācija vai imports, tiek apvienoti: pirmais ieraksts pēc klusuma perioda uzreiz atsvaidzina izvēles, un pēdējais ieraksts šajā sērijā tiek atspoguļots pēc trīsdesmit sekundēm; šo laiku var mainīt ar blockstudio/cache/populate_debounce. Metadati, ko WordPress ieraksta kā uzskaites datus, piemēram, pēc rediģēšanas iestatītā bloķēšana, netiek uzskatīti par izmaiņām; blockstudio/cache/populate_ignored_meta_keys paplašina šo sarakstu. Redaktors vienmēr vaicā aktuālās opcijas, tāpēc šis laika periods ietekmē tikai renderēšanas brīdī nolasītās kešotās izvēles. Avota faili un būvēšanas iestatījumi joprojām parastajā veidā padara nederīgu strukturālo kešatmiņu. Izvēļu pārrakstīšana neizraisa kešatmiņas direktorija atkārtotu skenēšanu pēc katrām satura izmaiņām; periodiska tīrīšana joprojām dzēš pamestos pagaidu failus. Konkrētai valodai paredzētās izpildlaika identitātes paliek izolētas; vairākas kešatmiņas nosaukumvietas direktorijas daudzvalodu vietnē pašas par sevi neliecina, ka kešatmiņa nav izmantota.

SQLite žurnāla darbības bloka db datu direktorijā neizdzēš kešotos bloka metadatus. Izmaiņas db.php, uzraudzītajos avota failos vai datu direktorijas avota failu un apakšdirektoriju struktūrā joprojām padara kešatmiņu nederīgu.

Vienlaicīgas izpildlaika pārbūves laikā tiek ievēlēts viens būvētājs. Pārējie pieprasījumi gaida līdz piecām sekundēm un pēc tam izmanto pēdējos derīgos bloku metadatus, ja to avota faili un nepieciešamie kompilētie resursi joprojām pastāv. Auksts pieprasījums bez droši izmantojamiem datiem atgriež HTTP 503 ar Retry-After, nevis sāk vēl vienu būvēšanu. Filtrs blockstudio/cache/build_wait_budget pielāgo gaidīšanas laiku milisekundēs gan strukturālajām pārbūvēm, gan izvēļu atsvaidzināšanai. Mitinātājs bez konsultatīvām failu slēdzenēm atsvaidzina izvēles bez aizsardzības un tik un tā tās publicē, tāpēc nākamais pieprasījums izmanto kešatmiņu.

Iepriekšējo versiju atstātās neaktīvās, konkrētai atslēgai paredzētās .build.lock datnes tiek savāktas visās šīs vietnes kešatmiņas nosaukumvietās, izmantojot WP-Cron. Tīrīšana sākas piecas minūtes pēc jaunināšanas un desmit sekunžu laikā noņem līdz 10,000 slēdzenēm minūtē. wp bs cache status parāda atlikušo skaitu, wp bs cache cleanup nekavējoties iztukšo atlikumu, bet wp bs cache clear iztīra izpildlaika kešatmiņu. Ja plānotā partija kavējas vairāk nekā desmit minūtes, jo cron nedarbojas, pieprasījumi reizi stundā pārmeklē ierobežotu skaitu slēdzeņu, lai tīrīšana neapstātos. Nesen izmantotās vai aizņemtās slēdzenes tiek atstātas neskartas, un jaunās fiksētā ceļa slēdzenes nekad netiek savāktas. Kad atlikums ir iztukšots, tā pati partija savāc pamestās kešatmiņas nosaukumvietas, kad ir pagājis to namespaceGrace; katrā vietnē tas notiek ne biežāk kā reizi stundā, un šai darbībai tiek saglabāts dienas cikls. Atļautais laiks tiek skaitīts no pirmās pārbaudes, kurā nosaukumvieta konstatēta kā novecojusi, nevis no tās jaunākā faila izveides; nosaukumvieta, kas joprojām ir aktuāla kādā no tās tvērumiem, nekad netiek savākta. Iekšējā kešatmiņas tīrīšana neizsauc WordPress pielikumu dzēšanas filtrus. Mitinātājiem, kuros WP-Cron ir atspējots, jāturpina darbināt ierastais plānotais cron darbprocess; neizdzēsiet bez izšķirības aktīvās slēdzeņu datnes, lai iztukšotu atlikumu.

Iestatījuma filtrs blockstudio/settings/cache/path maina konfigurēto vērtību. Lai atrisinātu izvietošanai specifiskus ceļus, filtrs blockstudio/cache/dir atrisina pamata direktoriju:

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

Mitinātāji, kuros nomnieka identitāte atšķiras no WordPress tīkla/vietnes ID, var filtrēt blockstudio/cache/site_key. Rezultāts tiek attīrīts un izmantots tikai kā direktorijas segments. blockstudio/cache/context joprojām ir īstā vieta serializējamai izpildlaika variācijai, kurai jāmaina objektu identitātes.

themeDefaults

Opcija Tips Noklusējums Apraksts
titleTag loģiskā vērtība false Iespējot WordPress tēmas atbalstu title tagam
suppressDirectoryUpdates loģiskā vērtība false Noņemt aktīvās bērntēmas un vecāktēmas no direktoriju atjauninājumu rezultātiem

Rakstos joprojām tiek izmantots esošais Blockstudio\Patterns API; šie noklusējuma iestatījumi nerada alternatīvas lapu vai rakstu fasādes.

performance

Profils compat nemaina vispārīgo WordPress darbību. speed un strict iespējo tos pašus izvēles priekšgala noklusējuma iestatījumus; katrs bērniestatījums var pārrakstīt sava profila vērtību.

Izvēles iestatījumi ir reģistrācijas vārti. Ja neobligāta funkcija ir false, Blockstudio nepievieno šīs funkcijas priekšgala, administrēšanas, redaktora, REST vai plānotos atzvanus. Pēc Early Serve vai plānotās iesildīšanas izmantošanas to atspējošana vienreiz veic attiecīgo tīrīšanu; turpmākie pieprasījumi paliek neaktīvi.

Opcija Tips Saderības noklusējums Ātruma/strict noklusējums Apraksts
profile virkne "compat" Nav piemērojams compat, speed vai strict
wordpress.headNoise Būla vērtība false true Noņemt vispārīgo galvenes noteikšanu un emocijzīmju izvadi
wordpress.embeds Būla vērtība false true Noņemt oEmbed noteikšanu un saimniekdatora skriptus
wordpress.xmlrpc Būla vērtība false true Atspējot XML-RPC un pingback pieprasījumus
wordpress.editor Būla vērtība false true Atspējot attālās redaktora noteikšanas saskarnes
wordpress.frontendAssets Būla vērtība false true Noņemt vispārīgos WordPress priekšgala resursus
wordpress.media Būla vērtība false true Lietot attēlu izvades noklusējuma iestatījumus
wordpress.heartbeat Būla vērtība false true Ierobežot Heartbeat ārpus redaktoriem
preload.links virkne "off" "intent" Pēc lietotāja darbības priekšielādēt tās pašas izcelsmes dokumentus
media.lazy Būla vērtība false true Izmantot Blockstudio attēlu ielādētāju
media.skeleton Būla vērtība false true Rādīt iebūvēto ielādes skeletu
media.metadata Būla vērtība false true Deklarēt assets/media.json izmantošanu
media.rootMargin virkne "300px" "300px" Slinkās ielādes krustpunkta mala
measurement.enabled Būla vērtība false false Iespējot izpildlaika mērīšanas API
measurement.queryMonitor Būla vērtība false false Iekļaut vaicājumus, kas aizņem vismaz 50ms
measurement.headers Būla vērtība false false Sūtīt profila un konfigurācijas jaucējvērtības galvenes
measurement.timings Būla vērtība false false Sūtīt pagājušā izpildlaika galveni
staticPrerender.enabled Būla vērtība false false Iespējot anonīmiem lietotājiem drošu HTML kešatmiņu
staticPrerender.ttl vesels skaitlis 86400 86400 Dokumenta maksimālais vecums kešatmiņā sekundēs
staticPrerender.invalidate virkne "signature" "signature" Izmantot signature vai pakāpenisku graph identitāti
staticPrerender.earlyServe Būla vērtība false false Apkalpot drošus kešatmiņas trāpījumus, pirms tiek palaists WordPress
staticPrerender.serveLoggedIn Būla vērtība false false Atļaut lietotājiem izmantot, bet ne veidot kešatmiņas trāpījumus
staticPrerender.dynamicPaths masīvs [] [] Ceļu prefiksi, kuriem jāsaglabā dinamiska darbība
staticPrerender.replayHeaders masīvs ["Link"] ["Link"] Atbildes galvenes, kas tiek saglabātas un nosūtītas kopā ar kešatmiņas trāpījumiem
staticPrerender.warm.enabled Būla vērtība false false Iespējot pastāvīgu ieplānotu iesildīšanas rindu
staticPrerender.warm.interval vesels skaitlis 3600 3600 Iesildīšanas intervāls sekundēs
staticPrerender.warm.concurrency vesels skaitlis 2 2 Maksimālais darbu skaits vienā iesildīšanas reizē
staticPrerender.warm.transport virkne "http" "http" Izmantot http vai saimniekdatora nodrošinātu internal renderētāju

Statiskā iepriekšējā renderēšana paliek atspējota, ja vien tā nav skaidri iespējota. Ja galvenais slēdzis ir atspējots, netiek reģistrēti iepriekšējās renderēšanas pieprasījumu āķi, un atspējotie earlyServe un warm.enabled slēdži nereģistrē administrēšanas vai cron āķus. Paraksta režīmā parastos pieprasījumos tiek izmantota lēta aktivizēta identitāte. Grafu režīms paredzēts skaidri palaistām būvēm: tas reģistrē katras lapas avota atkarības, lai vienas lapas maiņa nepadarītu nederīgus nesaistītus dokumentus. Informāciju par iesildīšanu, izvietošanu, agrīnu apkalpošanu un drošību skatiet sadaļā Statiskā iepriekšējā renderēšana.

Mērījumi ir pieejami programmatiski:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Kad galvenes ir iespējotas, Blockstudio nosūta X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config un pēc izvēles X-Blockstudio-Performance-Time. Darbība blockstudio/performance/measurement_enabled saņem atrisinātos izpildlaika iestatījumus.

media opcijas vada bs_media_image(), assets/media.json manifestu un priekšgala slinko ielādētāju. Palīgfunkciju, manifesta veidotāju un ielādētāja darbību skatiet sadaļā Multivide.

content

Opcija Tips Noklusējums Apraksts
enabled boolean false Iespējot Content Sync konfigurāciju
id string "default" Satura kopas nosaukumvieta, kas saglabāta sinhronizētajās entītijās
path string "content" Tēmai relatīva satura failu mape
includePageSyncManaged boolean false Iekļaut Page Sync pārvaldītās ziņas, nepārņemot to pamattekstu
authors string "ignore" Autora apstrāde (ignore vai esoša lietotāja login)
postTypes array [] Atļauto ziņu tipu saraksts
meta.include array [] Glob raksti sinhronizējamo meta atslēgu atlasei
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Glob raksti izslēdzamo meta atslēgu atlasei
meta.references object {} Deklarētas meta atsauces, kas pārrakstītas starp ID un UID
taxonomies array [] Atļauto reģistrēto taksonomiju saraksts terminiem un attiecībām
media string "manifest" Pielikuma atsauces uzvedība (manifest vai none)

Content Sync tiek pārvaldīts ar wp bs content, un tas eksportē atļautās ziņas, postmeta un deklarētās atsauces uz pārnesamiem failiem. Darbplūsmu un faila formātu skatiet sadaļā Content Sync.

editor

Opcija Tips Noklusējums Apraksts
formatOnSave boolean false Formatēt block.json saglabājot
assets array [] Papildu resursi, kas jāielādē redaktorā
markup boolean false Iespējot iezīmējuma rediģēšanu

tailwind

Opcija Tips Noklusējums Apraksts
enabled boolean false Iespējot Tailwind CSS kompilāciju
config string "" Tailwind v4 CSS konfigurācija ar pirmo …

Kompilācijas darbību un konfigurācijas formātu ar pirmo CSS skatiet: Tailwind CSS.

blockTags

Opcija Tips Noklusējums Apraksts
enabled boolean false Iespējot lapas līmeņa bs: tagu renderēšanu ziņas saturā un logrīku apgabalos
allow array [] Bloku nosaukumu rakstu atļaušanas saraksts; atbalsta fnmatch() aizstājējzīmes
deny array [] Bloku nosaukumu rakstu aizliegšanas saraksts; tam ir priekšroka pār allow
prefixes object {} Prefikss saīsinājumu nosaukumvietām; katra vērtība ir nosaukumvieta vai sakārtots masīvs

Veidnes līmeņa tagu renderēšana vienmēr ir aktīva; šīs opcijas nosaka aizstāšanu lapas līmenī. Tagu sintaksi un atrisināšanas noteikumus skatiet sadaļā Renderēšana.

ui

Opcija Tips Noklusējums Apraksts
enabled boolean false Reģistrēt komplektā iekļautos bsui/* UI komponentus un app/* demonstrācijas lietotnes

blockEditor

Opcija Tips Noklusējums Apraksts
disableLoading boolean false Atspējot bloku ielādi redaktorā
enhance boolean false Iespējot Blockstudio redaktora norādes, kas saistītas ar novietošanu un atlasi
cssClasses array [] Stila lapu URL, no kurām iegūt CSS klases klašu lauka automātiskajai pabeigšanai
cssVariables array [] Stila lapu URL, no kurām iegūt CSS mainīgos koda lauka automātiskajai pabeigšanai

blockEditor.blocks

Izmantojiet blockEditor.blocks projekta līmeņa bloku ievietošanas politikai. allow un deny pieņem bloku nosaukumus un aizstājējzīmju rakstus, piemēram, 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 atceļ stilus, kas reģistrēti, izmantojot WordPress PHP bloku stilu reģistru:

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

blockEditor.patterns

Izmantojiet blockEditor.patterns, lai atspējotu globālos rakstu avotus un filtrētu rakstu kategorijas.

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

blockEditor.media

Izmantojiet blockEditor.media globālajai multivides ievietotāja politikai.

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

dev

Opcija Tips Noklusējums Apraksts
grab.enabled boolean false Iespējot priekšgala elementu atlasītāju
perf boolean false Iespējot veiktspējas profilu katrā lapas ielādē
canvas.enabled boolean false Iespējot audeklu
canvas.adminBar boolean true Rādīt WordPress administrēšanas joslu audekla skatā

githooks

Opcija Tips Noklusējums Apraksts
commit boolean false Ģenerēt tikai analīzei paredzētu pirms-commit āķi, kad darbojas blockstudio-githooks sync

Informāciju par ģenerētā āķa darbību un tā sinhronizācijas uzturēšanu skatiet sadaļā pārvaldītais commit āķis.

phpstan

Opcija Tips Noklusējums Apraksts
preset string "base" Analīzes sākotnējais iestatījums, ja komandrindā nav izvēlēts neviens: base, theme, extreme-theme vai wordpress-render
configuration string "" Projekta PHPStan konfigurācija, kas iekļauta kopā ar sākotnējo iestatījumu un atrisināta no blockstudio.json
roots array ["."] Tēmu saknes, ko analizē kanoniskā komanda
excludePaths array [] Papildu skenera izņēmumi attiecībā pret katru konfigurēto sakni
maxFiles integer 10000 Maksimālais failu skaits, ko pārbauda tēmu skeneris
blockTags object {} Elementu kartējumi, tagu aizstājvārdi un scanPhp bloka taga noteikumam

Šie iestatījumi vada kanonisko komandu blockstudio-phpstan. Sākotnējos iestatījumus, slāņus un ieviešanu skatiet sadaļā PHPStan.

ai

Opcija Tips Noklusējums Apraksts
enableContextGeneration boolean false Ģenerēt apvienotu konteksta failu ar blokiem, iestatījumiem, shēmām un dokumentāciju LLM rīkiem

Dokumentācijas rādītāju un pilnu ģenerēto tekstu skatiet sadaļā MI integrācija.

UI Komponenti

Iespējojiet un apvienojiet komplektā iekļautos bezgalvas UI komponentus, kas ieviesti Blockstudio 7.3.