Ga naar de inhoud

Instellingen

Blockstudio bevat een uitgebreide instellingenAPI waarmee je opties kunt instellen via een bestand blockstudio.json in je themamap en/of filters. Daarnaast kunnen bevoegde gebruikers de instellingen visueel aanpassen in het beheergedeelte.

Via JSON

Als er een bestand blockstudio.json in je themamap staat, wordt dit gebruikt om de standaardopties voor de huidige site in te stellen. Er is een schema beschikbaarJSON om het bestand te valideren en automatische aanvulling in een IDE mogelijk te maken.

Het bestand is optioneel. Zonder dit bestand gebruikt Blockstudio de instellingen die in het beheergedeelte zijn opgeslagen, boven op de ingebouwde standaardwaarden. Het toevoegen, wijzigen of verwijderen van het bestand wordt automatisch gedetecteerd; de cache wissen of handmatig opnieuw laden is dus niet nodig.

De volgende eigenschappen zijn beschikbaar:

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

Via filters

Je kunt ook het filter blockstudio/settings/${setting} gebruiken om opties via PHP in te stellen, voor meer flexibiliteit.

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

Opties die via het filter blockstudio/settings/${setting} zijn ingesteld, overschrijven de opties uit het bestand blockstudio.json. Je kunt beide methoden samen gebruiken.

Runtimewaarden bieden ook blockstudio/performance/${setting}-filters en één laatste filter blockstudio/performance/config. Dit laatste filter moet een geldig configuratieobject teruggeven.

Hoe de bronnen worden samengevoegd

Elke bron wordt geladen en samengevoegd, van laagste naar hoogste prioriteit:

  1. Ingebouwde standaardwaarden
  2. Instellingen opgeslagen via de admin-UI (de optie blockstudio_settings)
  3. blockstudio.json in het thema
  4. blockstudio/settings/*-filters

blockstudio.json overschrijft alleen de sleutels die erin zijn vastgelegd. Voorheen verving het de opgeslagen instellingen volledig, waardoor een niet-gerelateerde, via de admin opgeslagen waarde niet meer werd toegepast zodra het bestand verscheen. Nu wordt het boven op die instellingen toegepast. De keerzijde: een verouderde waarde die via de admin-UI is opgeslagen, blijft van kracht totdat de sleutel in het bestand wordt vastgelegd of de opgeslagen waarde wordt verwijderd. Als een instelling anders werkt dan het bestand aangeeft, controleer dan de opgeslagen laag met wp bs settings of Settings::get_raw(). Deze geeft alleen terug wat de actieve JSON- of optiebron expliciet heeft vastgelegd.

Instellingen uitlezen uit PHP

Blockstudio\Settings laadt de actieve bron, meldt ongeldige JSON en wordt automatisch opnieuw geladen wanneer blockstudio.json verandert:

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

Gebruik Settings::get_raw() wanneer een integratie alleen waarden nodig heeft die expliciet zijn gedeclareerd door de actieve JSON of de optiesbron. Settings::fingerprint() retourneert een deterministische identiteit van de effectieve instellingen. Langlopende processen kunnen expliciet Settings::reload() aanroepen om een bestandswijziging direct te lezen. Normale toegang controleert het bestand maximaal één keer per seconde binnen een verzoek of langlopend PHP- proces, ook bij wijzigingen met dezelfde bestandsgrootte. Een wijziging van het geconfigureerde pad wordt bij de volgende lezing van kracht. Als er geen actief JSON-bestand is, worden opgeslagen database-instellingen niet vertraagd door dit interval.

Het opgeloste prestatieprofiel is beschikbaar via Blockstudio\Runtime_Settings::current(). Je kunt slash- of puntnotatie gebruiken:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

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

Beschikbare instellingen

users

Optie Type Standaard Beschrijving
ids array [] Gebruikers-ID’s met editortoegang
roles array [] Gebruikersrollen met editortoegang

assets

Optie Type Standaard Beschrijving
enqueue boolean true Blokassets automatisch in de wachtrij plaatsen
reset.enabled boolean false Coreblokstijlen verwijderen en de editorhulpmiddelenreset toepassen
reset.fullWidth array [] Berichttypen die de editorindeling over de volledige breedte gebruiken
minify.css boolean false CSS-uitvoer verkleinen
minify.js boolean false JS-uitvoer verkleinen
process.scss boolean false SCSS-bestanden verwerken
output string source Waar gecompileerde assets worden weggeschreven: source of cache
inlineLimit integer 0 Bytes aan externe blok-CSS die inline per pagina worden afgedrukt

output is standaard ingesteld op source, waarmee naast elk blok een map _dist wordt aangemaakt. Stel dit in op cache om gecompileerde assets op te slaan in de cachemap Blockstudio, zodat de bronstructuur van de blokken schoon blijft en vanuit een onveranderlijke checkout kan worden uitgerold. Bronnen Blockstudio kunnen niet schrijven naar de cache en worden ongeacht deze instelling omgeleid.

inlineLimit staat uit op 0, dus elke externe stylesheet behoudt zijn <link>– tag. Stel dit in op een aantal bytes om in plaats daarvan de kleinste externe blokstijlen van een pagina inline af te drukken, zolang het totaal binnen dat aantal blijft. 40000 is de limiet die WordPress core voor dezelfde regel gebruikt. Zie Kleine stylesheets inline plaatsen.

Wanneer reset.enabled actief is, kopieert Blockstudio ook opgeschoonde frontendwaarden body_class naar het editorcanvas. Gebruik blockstudio/editor/canvas/body_class om de lijst met editor-only-klassen aan te passen.

cache

Optie Type Standaard Beschrijving
enabled boolean true Caches op basis van bestanden Blockstudio inschakelen
path string "blockstudio/cache" Cachepad, relatief aan WP_CONTENT_DIR of absoluut
namespaceGrace integer 86400 Aantal seconden dat een gepensioneerde cachenamespace wordt bewaard voordat deze wordt opgeschoond

Standaard worden cachebestanden geschreven naar wp-content/blockstudio/cache, buiten de uploadsmap. Een relatief path wordt opgelost vanaf WP_CONTENT_DIR; een absoluut pad wordt rechtstreeks gebruikt. Dit ondersteunt hosts met een speciaal schrijfbaar cachevolume.

Indien ingeschakeld gebruikt Blockstudio deze ene hoofdmap voor buildpayloads, vooraf gebouwde blokregistratiegegevens, opgeloste editorassets, Tailwind CSS, renderdocumenten, eilandfragmenten, statische prerenders, grafiekindexen, wachtrijen en diagnostische gegevens. Elk object wordt geïsoleerd op basis van netwerk, site, volledige runtime-identiteit en scope. Runtime-identiteiten omvatten Blockstudio, instellingen, WordPress, PHP, het actieve thema, actieve plugins, logische detectiebronnen, hostcontext en expliciete afhankelijkheidshashes die door de betreffende bewerking zijn opgegeven.

Wijzigingen in inhoud, termen, gebruikers en metadata maken ingevulde veldkeuzes ongeldig, maar niet de structurele blokdetectie of gecompileerde assets. Keuzes worden afzonderlijk vernieuwd onder een vaste buildpadvergrendeling. Een reeks schrijfbewerkingen, zoals een synchronisatie van vertalingen of een import, wordt samengevoegd: de eerste bewerking na een rustige periode vernieuwt direct en de laatste bewerking van de reeks wordt verwerkt zodra er dertig seconden zijn verstreken, aanpasbaar met blockstudio/cache/populate_debounce. Meta die WordPress als boekhouding wegschrijft, zoals de vergrendeling van een berichtbewerking, geldt niet als wijziging; blockstudio/cache/populate_ignored_meta_keys breidt die lijst uit. De editor raadpleegt altijd actuele opties, dus het tijdvenster heeft alleen invloed op gecachte keuzes die tijdens het renderen worden gelezen. Bronbestanden en buildinstellingen maken de structurele cache nog steeds op de normale manier ongeldig. Bij het overschrijven van keuzes wordt de cachemap niet bij elke inhoudswijziging opnieuw gescand; periodieke opschoning verwijdert nog steeds verweesde tijdelijke bestanden. Runtime-identiteiten die bij een taal horen, blijven gescheiden; meerdere cache-naamruimtemappen op een meertalige site zijn op zichzelf geen bewijs van een cachemisser.

SQLite-journalactiviteit in de db-gegevensmap van een blok verwijdert gecachte blokmetadata niet. Wijzigingen in db.php, bewaakte bronbestanden of de structuur van bronbestanden en submappen in de gegevensmap maken de cache nog steeds ongeldig.

Bij gelijktijdige runtime-herbouw wordt één bouwer gekozen. Andere verzoeken wachten maximaal vijf seconden en gebruiken daarna de laatst bekende goede blokmetadata, zolang de bronbestanden en vereiste gecompileerde assets nog bestaan. Een koud verzoek zonder veilige payload geeft HTTP 503 met Retry-After terug in plaats van een nieuwe build te starten. Het filter blockstudio/cache/build_wait_budget past de wachttijd in milliseconden aan, zowel voor structurele herbouw als voor het vernieuwen van keuzes. Een host zonder adviserende bestandsvergrendeling vernieuwt keuzes zonder vergrendeling en publiceert ze alsnog, zodat het volgende verzoek een cachetreffer oplevert.

Inactieve, sleutelgebonden .build.lock-bestanden die door eerdere versies zijn achtergelaten, worden in de cachenamespaces van deze site opgeruimd door WP-Cron. Dit begint vijf minuten na de upgrade en verwijdert maximaal 10,000 vergrendelingen per minuut binnen een tijdslimiet van tien seconden. wp bs cache status geeft het resterende aantal terug en wp bs cache cleanup werkt de achterstand direct weg; wp bs cache clear leegt de runtimecache. Als een geplande batch meer dan tien minuten achterloopt omdat cron niet wordt uitgevoerd, ruimen verzoeken eenmaal per uur een beperkt aantal vergrendelingen op, zodat het opruimen niet vastloopt. Recente of vastgehouden vergrendelingen blijven ongemoeid; de nieuwe vergrendelingen met een vast pad worden nooit opgeruimd. Zodra de achterstand is weggewerkt, ruimt dezelfde batch verlaten cachenamespaces op zodra hun namespaceGrace is verstreken, maximaal eenmaal per uur per site, en blijft hiervoor een dagelijkse taak ingepland. De respijtperiode begint bij de eerste controle waarbij een namespace als verlaten wordt aangemerkt, niet bij het nieuwste bestand. Een namespace die voor een van de scopes nog actueel is, wordt nooit opgeruimd. Interne cacheopruiming roept geen filters voor het verwijderen van WordPress-bijlagen aan. Hosts waarop WP-Cron is uitgeschakeld, moeten hun gebruikelijke geplande cron-worker blijven uitvoeren; verwijder niet zomaar actieve vergrendelingsbestanden om een achterstand weg te werken.

Het instellingenfilter blockstudio/settings/cache/path wijzigt de ingestelde waarde. Voor padresolutie die afhankelijk is van de implementatie, filtert blockstudio/cache/dir de opgeloste basismap:

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

Hosts met een tenantidentiteit die afwijkt van de netwerk-/blog-ID’s van WordPress kunnen blockstudio/cache/site_key filteren. Het resultaat wordt opgeschoond en alleen als mapsegment gebruikt. blockstudio/cache/context blijft de juiste plek voor een serialiseerbare runtimevariant die objectidentiteiten moet wijzigen.

themeDefaults

Optie Type Standaard Beschrijving
titleTag boolean false Ondersteuning voor de titel-tag van thema’s WordPress inschakelen
suppressDirectoryUpdates boolean false Actieve child- en parentthema’s uit directory-updateresultaten verwijderen

Patronen blijven de bestaande Blockstudio\Patterns API gebruiken; deze standaardwaarden introduceren geen alternatieve pagina- of patroonfacades.

performance

Het profiel compat laat het algemene gedrag van WordPress ongewijzigd. speed en strict schakelen dezelfde optionele frontendstandaardwaarden in; elke onderliggende instelling kan de profielwaarde overschrijven.

Instellingen waarvoor je je kunt aanmelden, fungeren als registratiepoorten. Wanneer een optionele functie false is, koppelt Blockstudio de frontend-, admin- en editorcallbacks, REST-callbacks of geplande callbacks van die functie niet. Als je Early Serve of geplande warming uitschakelt nadat je deze hebt gebruikt, wordt de bijbehorende opschoning eenmaal uitgevoerd; latere verzoeken doen niets.

Optie Type Compatibiliteitsstandaard Snelheids-/strikte standaard Beschrijving
profile string "compat" Niet van toepassing compat, speed of strict
wordpress.headNoise boolean false true Generieke head-detectie en emoji-uitvoer verwijderen
wordpress.embeds boolean false true oEmbed-detectie en hostscripts verwijderen
wordpress.xmlrpc boolean false true XML-RPC en pingbacks uitschakelen
wordpress.editor boolean false true Externe detectieoppervlakken van de editor uitschakelen
wordpress.frontendAssets boolean false true Generieke frontend-assets van core verwijderen
wordpress.media boolean false true Standaardinstellingen voor afbeeldingsuitvoer toepassen
wordpress.heartbeat boolean false true Heartbeat buiten editors afremmen
preload.links string "off" "intent" Documenten van dezelfde oorsprong vooraf ophalen na gebruikersintentie
media.lazy boolean false true De afbeeldingsloader van Blockstudio gebruiken
media.skeleton boolean false true De ingebouwde laad-placeholder tonen
media.metadata boolean false true Gebruik van assets/media.json aangeven
media.rootMargin string "300px" "300px" Intersectiemarge van de lazy-loader
measurement.enabled boolean false false Runtime-meet-API’s inschakelen
measurement.queryMonitor boolean false false Query’s opnemen die minstens 50ms duren
measurement.headers boolean false false Headers met profiel- en configuratiehash verzenden
measurement.timings boolean false false De header met verstreken runtime verzenden
staticPrerender.enabled boolean false false Anoniem veilige HTML-caching inschakelen
staticPrerender.ttl integer 86400 86400 Maximale leeftijd van een gecacht document in seconden
staticPrerender.invalidate string "signature" "signature" signature of incrementele graph-identiteit gebruiken
staticPrerender.earlyServe boolean false false Veilige treffers serveren voordat WordPress opstart
staticPrerender.serveLoggedIn boolean false false Gebruikers toestaan cachetreffers te gebruiken, maar nooit te maken
staticPrerender.dynamicPaths array [] [] Padprefixen die dynamisch moeten blijven
staticPrerender.replayHeaders array ["Link"] ["Link"] Responseheaders die bij cachetreffers worden opgeslagen en verzonden
staticPrerender.warm.enabled boolean false false De duurzame geplande opwarmwachtrij inschakelen
staticPrerender.warm.interval integer 3600 3600 Opwarminterval in seconden
staticPrerender.warm.concurrency integer 2 2 Maximumaantal taken per opwarmronde
staticPrerender.warm.transport string "http" "http" http of een door de host geleverde internal-renderer gebruiken

Statisch prerenderen blijft uitgeschakeld tenzij dit expliciet wordt ingeschakeld. Een uitgeschakelde hoofdschakelaar registreert geen hooks voor prerenderverzoeken, en uitgeschakelde schakelaars earlyServe en warm.enabled registreren geen admin- of cron-hooks. De handtekeningmodus gebruikt een goedkope geactiveerde identiteit bij gewone verzoeken. De grafiekmodus is bedoeld voor expliciete builds: deze registreert bronafhankelijkheden per pagina, zodat het wijzigen van één pagina geen ongerelateerde documenten ongeldig maakt. Zie Statisch prerenderen voor informatie over opwarming, implementatie, vroeg aanbieden en veiligheid.

Metingen zijn programmatisch beschikbaar:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Wanneer headers zijn ingeschakeld, verzendt Blockstudio X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config en optioneel X-Blockstudio-Performance-Time. De actie blockstudio/performance/measurement_enabled ontvangt de opgeloste runtime-instellingen.

De opties van media sturen bs_media_image(), het manifest van assets/media.json en de lazy-loader van de frontend aan. Zie Media voor de helper, de manifestbouwer en het gedrag van de loader.

content

Optie Type Standaard Beschrijving
enabled boolean false Content Sync-configuratie inschakelen
id string "default" Namespace van de contentset die bij gesynchroniseerde entiteiten wordt opgeslagen
path string "content" Map met contentbestanden relatief aan het thema
includePageSyncManaged boolean false Door Page Sync beheerde berichten opnemen zonder de inhoud ervan te beheren
authors string "ignore" Auteursafhandeling (ignore of bestaande gebruiker login)
postTypes array [] Toegestane berichttypen
meta.include array [] Glob-patronen voor metasleutels om te synchroniseren
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Glob-patronen voor metasleutels om uit te sluiten
meta.references object {} Aangegeven metaverwijzingen die tussen ID’s en UID’s worden herschreven
taxonomies array [] Toegestane geregistreerde taxonomieën voor termen en relaties
media string "manifest" Gedrag van bijlageverwijzingen (manifest of none)

Content Sync wordt beheerd via wp bs content en exporteert toegestane berichten, postmeta en aangegeven verwijzingen naar overdraagbare bestanden. Zie Content Sync voor de workflow en bestandsindeling.

editor

Optie Type Standaard Beschrijving
formatOnSave boolean false block.json opmaken bij opslaan
assets array [] Aanvullende assets om in de editor te laden
markup boolean false Markup bewerken inschakelen

tailwind

Optie Type Standaard Beschrijving
enabled boolean false Tailwind CSS-compilatie inschakelen
config string "" Tailwind v4-eerst-configuratie voor CSS

Zie Tailwind CSS voor compilatiegedrag en de configuratie-indeling waarbij CSS vooropstaat.

blockTags

Optie Type Standaard Beschrijving
enabled boolean false Schakel paginaniveau bs:-tagweergave in de inhoud van berichten en widgetgebieden in
allow array [] Toegestane lijst met bloknaampatronen; ondersteunt fnmatch()-wildcards
deny array [] Blokkeerlijst met bloknaampatronen; heeft voorrang op allow
prefixes object {} Prefix om afkortingen een namespace te geven; elke waarde is een namespace of geordende array

Rendering van tags op sjabloonniveau is altijd actief; deze opties bepalen vervanging op paginaniveau. Zie Rendering voor de tagsyntaxis en resolutieregels.

ui

Optie Type Standaard Beschrijving
enabled boolean false De meegeleverde componenten van bsui/* UI en demo-apps van app/* registreren

blockEditor

Optie Type Standaard Beschrijving
disableLoading boolean false Blokken laden in de editor uitschakelen
enhance boolean false Hover- en selectiemogelijkheden van de editor van Blockstudio inschakelen
cssClasses array [] Stylesheet-URL’s waaruit CSS-klassen worden gehaald voor automatisch aanvullen van het klassenveld
cssVariables array [] Stylesheet-URL’s waaruit variabelen van CSS worden gehaald voor automatisch aanvullen van het codeveld

blockEditor.blocks

Gebruik blockEditor.blocks voor het projectbrede beleid voor de blokinvoeger. allow en deny accepteren bloknamen en jokerpatronen zoals 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 verwijdert stijlen die zijn geregistreerd via het blokstijlenregister van WordPress’ PHP:

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

blockEditor.patterns

Gebruik blockEditor.patterns om globale patroonbronnen uit te schakelen en patrooncategorieën te filteren.

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

blockEditor.media

Gebruik blockEditor.media voor het globale beleid voor de media-invoeger.

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

dev

Optie Type Standaard Beschrijving
grab.enabled boolean false De elementgrijper van de frontend inschakelen
perf boolean false De prestatieprofiler bij elke paginalading inschakelen
canvas.enabled boolean false Het canvas inschakelen
canvas.adminBar boolean true De adminbalk van WordPress weergeven bij het bekijken van het canvas

githooks

Optie Type Standaard Beschrijving
commit boolean false Een analyse-only pre-commit-hook genereren wanneer blockstudio-githooks sync wordt uitgevoerd

Zie de beheerde commit-hook voor informatie over wat de gegenereerde hook uitvoert en hoe deze gesynchroniseerd blijft.

phpstan

Optie Type Standaard Beschrijving
preset string "base" Analysevoorinstelling wanneer de opdrachtregel er geen kiest: base, theme, extreme-theme of wordpress-render
configuration string "" Projectconfiguratie van PHPStan die naast de voorinstelling wordt opgenomen, opgelost vanuit blockstudio.json
roots array ["."] Themawortels die door de canonieke opdracht worden geanalyseerd
excludePaths array [] Aanvullende scanneruitsluitingen relatief aan elke geconfigureerde hoofdmap
maxFiles integer 10000 Maximumaantal bestanden dat door de themascanner wordt geïnspecteerd
blockTags object {} Elementtoewijzingen, tagaliassen en scanPhp voor de bloktagregel

Deze instellingen sturen de canonieke opdracht blockstudio-phpstan aan. Zie PHPStan voor voorinstellingen, lagen en gebruik.

ai

Optie Type Standaard Beschrijving
enableContextGeneration boolean false Een gecombineerd contextbestand genereren met blokken, instellingen, schema’s en documentatie voor LLM-tools

Zie AI-integratie voor de documentatie-index en de volledige gegenereerde tekst.

UI Componenten

Schakel de meegeleverde headless-componenten van UI in en combineer ze; geïntroduceerd in Blockstudio 7.3.