Réglages
Blockstudio comprend une puissante API de réglages, qui permet de définir des options via un fichier blockstudio.json dans le dossier de votre thème et/ou des filtres. De plus, les utilisateurs autorisés peuvent modifier les réglages visuellement dans l’espace d’administration.
Via JSON
Si un fichier blockstudio.json se trouve dans le dossier de votre thème, il servira à définir les options par défaut du site actuel. Un schéma JSON permet de valider le fichier et d’activer la saisie semi-automatique dans un IDE.
Ce fichier est facultatif. En son absence, Blockstudio utilise les réglages enregistrés dans l’espace d’administration, en plus de ses valeurs par défaut intégrées. L’ajout, la modification ou la suppression du fichier est détecté automatiquement ; aucun vidage du cache ni rechargement manuel n’est nécessaire.
Les propriétés suivantes sont disponibles :
{
"$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 des filtres
Vous pouvez aussi utiliser le filtre blockstudio/settings/${setting} pour définir des options via PHP avec plus de flexibilité.
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');
Les options définies via le filtre blockstudio/settings/${setting} remplacent celles définies dans le fichier blockstudio.json. Les deux méthodes peuvent être utilisées ensemble.
Les valeurs d’exécution exposent également des filtres blockstudio/performance/${setting} et un filtre blockstudio/performance/config final. Ce dernier doit renvoyer un objet de configuration valide.
Comment les sources sont combinées
Chaque source est chargée et fusionnée, en commençant par celle de priorité la plus faible :
- Valeurs par défaut intégrées
- Réglages enregistrés via UI d’administration (option
blockstudio_settings) blockstudio.jsondans le thème- Filtres
blockstudio/settings/*
blockstudio.json remplace uniquement les clés qu’il déclare. Auparavant, il remplaçait entièrement les réglages enregistrés : dès que le fichier apparaissait, toute valeur sans rapport enregistrée par l’administration cessait de s’appliquer. Il s’ajoute désormais à ces réglages. En contrepartie, une ancienne valeur enregistrée via UI continue de s’appliquer jusqu’à ce que le fichier déclare cette clé ou que la valeur enregistrée soit supprimée. Si un réglage ne correspond pas au contenu du fichier, vérifiez la couche enregistrée avec wp bs settings ou Settings::get_raw(), qui ne renvoie que ce qui a été explicitement déclaré par la source JSON ou celle des options active.
Lecture des réglages depuis PHP
Blockstudio\Settings charge la source active, signale les fichiers JSON mal formés et se recharge automatiquement lorsque blockstudio.json change :
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);
}
Utilisez Settings::get_raw() lorsqu’une intégration ne nécessite que les valeurs explicitement
indiquées par la source JSON active ou la source d’options. Settings::fingerprint() renvoie une identité déterministe des paramètres effectifs. Les processus de longue durée peuvent appeler explicitement Settings::reload() pour prendre immédiatement en compte une modification de fichier. Lors d’un accès normal, le fichier est vérifié au maximum une fois par seconde dans une requête ou un processus PHP de longue durée, y compris en cas de modification de même taille. Toute modification du chemin configuré prend effet à la lecture suivante. Lorsqu’aucun fichier JSON n’est actif, la fenêtre de vérification ne retarde pas les paramètres enregistrés dans la base de données.
Le profil de performances résolu est accessible via Blockstudio\Runtime_Settings::current(). Les chemins avec barre oblique ou point sont pris en charge :
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Réglages disponibles
users
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
ids |
array | [] |
Identifiants des utilisateurs ayant accès à l’éditeur |
roles |
array | [] |
Rôles des utilisateurs ayant accès à l’éditeur |
assets
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
enqueue |
boolean | true |
Mise en file d’attente automatique des ressources des blocs |
reset.enabled |
boolean | false |
Supprimer les styles des blocs du cœur et appliquer la réinitialisation des utilitaires de l’éditeur |
reset.fullWidth |
array | [] |
Types de publication utilisant la mise en page d’éditeur pleine largeur |
minify.css |
boolean | false |
Réduire la sortie CSS |
minify.js |
boolean | false |
Réduire la sortie JS |
process.scss |
boolean | false |
Traiter les fichiers SCSS |
output |
string | source |
Emplacement des ressources compilées : source ou cache |
inlineLimit |
integer | 0 |
Octets de CSS de blocs externes imprimés en ligne par page |
output utilise source par défaut, ce qui crée un répertoire _dist à côté de chaque bloc. Définissez-le sur cache pour écrire les ressources compilées dans le répertoire de cache Blockstudio afin de garder l’arborescence source des blocs propre et déployable depuis une extraction immuable. Les sources Blockstudio qui ne peuvent pas écrire redirigent déjà leurs fichiers vers le cache, quel que soit ce réglage.
inlineLimit est désactivé à 0, chaque feuille de style externe conserve donc sa balise <link>. Indiquez un nombre d’octets pour intégrer à la place les plus petites feuilles de style externes des blocs d’une page, tant que leur taille totale reste dans cette limite. 40000 correspond à la limite utilisée par le cœur de WordPress pour la même règle. Consultez Intégrer les petites feuilles de style.
Lorsque reset.enabled est actif, Blockstudio copie également les valeurs body_class assainies de l’interface publique vers le canevas de l’éditeur. Utilisez blockstudio/editor/canvas/body_class pour ajuster la liste des classes propres à l’éditeur.
cache
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
enabled |
boolean | true |
Activer les caches adossés à des fichiers Blockstudio |
path |
string | "blockstudio/cache" |
Chemin du cache, relatif à WP_CONTENT_DIR ou absolu |
namespaceGrace |
integer | 86400 |
Nombre de secondes pendant lesquelles un espace de noms de cache retiré est conservé avant son nettoyage |
Par défaut, les fichiers de cache sont écrits dans wp-content/blockstudio/cache, en dehors du répertoire des téléversements. Un chemin path relatif est résolu à partir de WP_CONTENT_DIR ; un chemin absolu est utilisé tel quel. Cela convient aux hébergeurs qui fournissent un volume de cache dédié et accessible en écriture.
Lorsque cette option est activée, Blockstudio utilise cette racine unique pour les charges utiles de compilation, les données précompilées d’enregistrement des blocs, les ressources résolues de l’éditeur, Tailwind CSS, les documents de rendu, les fragments d’îlots, les pré-rendus statiques, les index de graphes, les files d’attente et les diagnostics. Chaque objet est isolé par réseau, site, identité d’exécution complète et portée. Les identités d’exécution couvrent Blockstudio, les réglages, WordPress, PHP, le thème actif, les extensions actives, les sources logiques de découverte, le contexte de l’hôte et les hachages explicites des dépendances fournis par l’opération propriétaire.
Les modifications de contenu, de terme, d’utilisateur et de métadonnées invalident les choix de champs renseignés, mais pas la découverte structurelle des blocs ni les ressources compilées. Les choix sont actualisés séparément sous un verrou fixe sur le chemin de compilation. Une série d’écritures, par exemple une synchronisation de traductions ou un import, est regroupée : la première écriture après une période d’inactivité déclenche une actualisation immédiate, et la dernière écriture de la série est prise en compte une fois trente secondes écoulées ; ce délai peut être ajusté avec blockstudio/cache/populate_debounce. Les métadonnées que WordPress écrit à des fins de suivi, comme le verrou de modification d’un article, ne comptent pas comme une modification ; blockstudio/cache/populate_ignored_meta_keys complète cette liste. L’éditeur interroge toujours les options en direct : cette période n’affecte que les choix mis en cache et lus au moment du rendu. Les fichiers sources et les paramètres de compilation continuent d’invalider normalement le cache structurel. Le remplacement des choix ne relance pas l’analyse du répertoire de cache à chaque modification de contenu ; le nettoyage périodique supprime toujours les fichiers temporaires orphelins. Les identités d’exécution propres à chaque langue restent isolées ; la présence de plusieurs répertoires d’espaces de noms de cache sur un site multilingue ne prouve pas, à elle seule, qu’il y a un échec de cache.
L’activité de journalisation de SQLite dans le répertoire de données db d’un bloc ne supprime pas les métadonnées du bloc mises en cache. Les modifications de db.php, des fichiers sources surveillés, ou de la structure des fichiers sources et des sous-répertoires du répertoire de données invalident toujours le cache.
Lors des reconstructions d’exécution simultanées, un seul processus est désigné pour effectuer la compilation. Les autres requêtes attendent jusqu’à cinq secondes, puis réutilisent les dernières métadonnées de bloc valides si leurs fichiers source et les ressources compilées requises existent encore. Une requête à froid sans charge utile sûre renvoie HTTP 503 avec Retry-After au lieu de lancer une autre compilation. Le filtre blockstudio/cache/build_wait_budget ajuste le délai d’attente en millisecondes pour les reconstructions structurelles et l’actualisation des choix. Un hôte sans verrouillage consultatif de fichiers actualise les choix sans verrou et les publie tout de même ; la requête suivante obtient donc un résultat en cache.
Les anciens fichiers .build.lock propres à une clé et laissés par des versions précédentes sont collectés dans les espaces de noms de cache de ce site par WP-Cron, à partir de cinq minutes après la mise à niveau, à raison de 10,000 verrous au maximum par minute dans une fenêtre de dix secondes. wp bs cache status indique le nombre restant et wp bs cache cleanup vide immédiatement la file d’attente ; wp bs cache clear purge le cache d’exécution. Si une tâche planifiée a plus de dix minutes de retard parce que cron ne se déclenche pas, les requêtes balaient un nombre limité de verrous une fois par heure afin que le nettoyage ne reste pas bloqué. Les verrous récents ou détenus sont laissés intacts, et les nouveaux verrous à chemin fixe ne sont jamais collectés. Une fois la file d’attente vidée, la même tâche collecte les espaces de noms de cache abandonnés lorsque leur namespaceGrace est dépassée, au plus une fois par heure et par site, et maintient une vérification quotidienne. Le délai de grâce commence lors du premier balayage qui détecte le retrait d’un espace de noms, et non à la date de son fichier le plus récent ; un espace de noms toujours actif pour l’une de ses portées n’est jamais collecté.
Le nettoyage interne du cache n’appelle pas les filtres de suppression des pièces jointes WordPress.
Les hôtes ayant désactivé WP-Cron doivent continuer à exécuter leur tâche planifiée habituelle cron ; ne supprimez pas sans discernement les fichiers de verrouillage actifs pour vider une file d’attente.
Le filtre de réglage blockstudio/settings/cache/path modifie la valeur configurée. Pour résoudre un chemin propre au déploiement, blockstudio/cache/dir filtre le répertoire de base résolu :
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Les hébergeurs dont l’identité de locataire diffère des identifiants de réseau/blog WordPress peuvent filtrer blockstudio/cache/site_key. Le résultat est assaini et utilisé uniquement comme segment de répertoire. blockstudio/cache/context reste l’endroit approprié pour une variante d’exécution sérialisable qui doit modifier les identités des objets.
themeDefaults
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
titleTag |
boolean | false |
Activer la prise en charge des balises de titre de thème WordPress |
suppressDirectoryUpdates |
boolean | false |
Exclure les thèmes enfant et parent actifs des résultats de mise à jour des répertoires |
Les motifs continuent d’utiliser le Blockstudio\Patterns API existant ; ces valeurs par défaut n’introduisent pas d’autres façades de pages ou de motifs.
performance
Le profil compat laisse le comportement générique de WordPress inchangé. speed et strict activent les mêmes valeurs par défaut facultatives pour l’interface publique ; chaque réglage enfant peut remplacer la valeur de son profil.
Les réglages facultatifs servent de conditions d’enregistrement. Lorsqu’une fonctionnalité facultative est false, Blockstudio n’attache pas les rappels correspondants à l’interface publique, à l’administration, à l’éditeur, à REST ou aux tâches planifiées. Après utilisation, la désactivation de Early Serve ou du préchauffage planifié effectue une fois le nettoyage associé ; les requêtes suivantes restent inactives.
| Option | Type | Valeur par défaut de compatibilité | Valeur par défaut de rapidité/strict | Description |
|---|---|---|---|---|
profile |
chaîne | "compat" |
Sans objet | compat, speed ou strict |
wordpress.headNoise |
booléen | false |
true |
Supprimer la découverte générique dans l’en-tête et l’affichage des émojis |
wordpress.embeds |
booléen | false |
true |
Supprimer la découverte oEmbed et les scripts d’hôte |
wordpress.xmlrpc |
booléen | false |
true |
Désactiver XML-RPC et les pings de rétrolien |
wordpress.editor |
booléen | false |
true |
Désactiver les mécanismes distants de découverte de l’éditeur |
wordpress.frontendAssets |
booléen | false |
true |
Supprimer les ressources génériques de l’interface publique de base |
wordpress.media |
booléen | false |
true |
Appliquer les paramètres par défaut de sortie des images |
wordpress.heartbeat |
booléen | false |
true |
Limiter Heartbeat en dehors des éditeurs |
preload.links |
chaîne | "off" |
"intent" |
Précharger les documents de même origine après une action de l’utilisateur |
media.lazy |
booléen | false |
true |
Utiliser le chargeur d’images de Blockstudio |
media.skeleton |
booléen | false |
true |
Afficher le squelette de chargement intégré |
media.metadata |
booléen | false |
true |
Déclarer l’utilisation de assets/media.json |
media.rootMargin |
chaîne | "300px" |
"300px" |
Marge d’intersection du chargeur différé |
measurement.enabled |
booléen | false |
false |
Activer les API de mesure à l’exécution |
measurement.queryMonitor |
booléen | false |
false |
Inclure les requêtes d’au moins 50ms |
measurement.headers |
booléen | false |
false |
Envoyer les en-têtes de profil et de hachage de configuration |
measurement.timings |
booléen | false |
false |
Envoyer l’en-tête de durée d’exécution |
staticPrerender.enabled |
booléen | false |
false |
Activer la mise en cache HTML sans risque pour les utilisateurs anonymes |
staticPrerender.ttl |
entier | 86400 |
86400 |
Âge maximal des documents mis en cache, en secondes |
staticPrerender.invalidate |
chaîne | "signature" |
"signature" |
Utiliser signature ou une identité graph incrémentale |
staticPrerender.earlyServe |
booléen | false |
false |
Diffuser les réponses du cache sûres avant le démarrage de WordPress |
staticPrerender.serveLoggedIn |
booléen | false |
false |
Autoriser les utilisateurs à consulter les réponses du cache, sans pouvoir les créer |
staticPrerender.dynamicPaths |
tableau | [] |
[] |
Préfixes de chemin qui doivent rester dynamiques |
staticPrerender.replayHeaders |
tableau | ["Link"] |
["Link"] |
En-têtes de réponse enregistrés avec les entrées du cache et envoyés lors de leur diffusion |
staticPrerender.warm.enabled |
booléen | false |
false |
Activer la file persistante de préchauffage planifié |
staticPrerender.warm.interval |
entier | 3600 |
3600 |
Intervalle de préchauffage en secondes |
staticPrerender.warm.concurrency |
entier | 2 |
2 |
Nombre maximal de tâches traitées par cycle de préchauffage |
staticPrerender.warm.transport |
chaîne | "http" |
"http" |
Utiliser http ou un moteur de rendu fourni par l’hôte internal |
Le pré-rendu statique reste désactivé tant qu’il n’est pas explicitement activé. Un interrupteur principal désactivé n’enregistre aucun hook de requête de pré-rendu, et les interrupteurs earlyServe et warm.enabled désactivés n’enregistrent aucun hook d’administration ni cron. Le mode signature utilise une identité activée à faible coût lors des requêtes ordinaires. Le mode graphe est conçu pour les compilations explicites : il enregistre les dépendances de source par page, de sorte que la modification d’une page n’invalide pas les documents sans lien. Consultez Pré-rendu statique pour en savoir plus sur le préchauffage, le déploiement, le service anticipé et la sécurité.
Les mesures sont disponibles par programmation :
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Lorsque les en-têtes sont activés, Blockstudio envoie
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config, et éventuellement
X-Blockstudio-Performance-Time. L’action
blockstudio/performance/measurement_enabled reçoit les paramètres d’exécution résolus.
Les options media pilotent bs_media_image(), le manifeste
assets/media.json et le chargeur différé du frontend. Consultez Média pour découvrir l’assistant, le générateur de manifeste et le comportement du chargeur.
content
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
enabled |
boolean | false |
Activer la configuration de Content Sync |
id |
string | "default" |
Espace de noms de l’ensemble de contenus stocké sur les entités synchronisées |
path |
string | "content" |
Répertoire des fichiers de contenu relatif au thème |
includePageSyncManaged |
boolean | false |
Inclure les publications gérées par Page Sync sans en gérer le contenu |
authors |
string | "ignore" |
Gestion des auteurs (ignore ou login utilisateur existant) |
postTypes |
array | [] |
Types de publications autorisés |
meta.include |
array | [] |
Motifs glob pour les clés de métadonnées à synchroniser |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Motifs glob pour les clés de métadonnées à exclure |
meta.references |
object | {} |
Références de métadonnées déclarées réécrites entre identifiants et UID |
taxonomies |
array | [] |
Taxonomies enregistrées autorisées pour les termes et les relations |
media |
string | "manifest" |
Comportement des références de pièces jointes (manifest ou none) |
Content Sync est géré par wp bs content et exporte les publications autorisées,
postmeta et les références déclarées vers des fichiers portables. Consultez
Synchronisation du contenu pour découvrir le processus et le format des
fichiers.
editor
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
formatOnSave |
boolean | false |
Formater block.json à l’enregistrement |
assets |
array | [] |
Ressources supplémentaires à charger dans l’éditeur |
markup |
boolean | false |
Activer la modification du balisage |
tailwind
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
enabled |
boolean | false |
Activer la compilation de Tailwind CSS |
config |
string | "" |
Configuration Tailwind v4 CSS d’abord |
Consultez Tailwind CSS pour le comportement de compilation et le format de configuration axé sur CSS.
blockTags
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
enabled |
boolean | false |
Activer le rendu des balises bs: à l’échelle de la page dans le contenu des publications et les zones de widgets |
allow |
array | [] |
Liste d’autorisation des motifs de noms de blocs ; prend en charge les jokers fnmatch() |
deny |
array | [] |
Liste de blocage des motifs de noms de blocs ; prioritaire sur allow |
prefixes |
object | {} |
Préfixe pour les raccourcis de noms ; chaque valeur est un nom de domaine ou un tableau ordonné |
Le rendu des balises au niveau des modèles est toujours actif ; ces options contrôlent le remplacement à l’échelle de la page. Consultez Rendu pour la syntaxe des balises et les règles de résolution.
ui
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
enabled |
boolean | false |
Enregistrer les composants bsui/* UI intégrés et les applications de démonstration app/* |
blockEditor
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
disableLoading |
boolean | false |
Désactiver le chargement des blocs dans l’éditeur |
enhance |
boolean | false |
Activer les commandes de survol et de sélection de l’éditeur Blockstudio |
cssClasses |
array | [] |
URL des feuilles de style dont extraire les classes CSS pour la saisie semi-automatique du champ des classes |
cssVariables |
array | [] |
URL des feuilles de style dont extraire les variables CSS pour la saisie semi-automatique du champ de code |
blockEditor.blocks
Utilisez blockEditor.blocks pour définir la politique globale d’insertion des blocs. allow et deny acceptent les noms de blocs et les motifs génériques tels que core/*.
{
"blockEditor": {
"blocks": {
"allow": ["core/*", "my-theme/*"],
"deny": ["core/embed", "core/freeform"],
"directory": false,
"categories": {
"rename": {
"text": "Writing",
"design": "Layout"
},
"order": ["my-theme", "text", "media"]
},
"legacyWidgets": {
"hide": ["archives", "calendar"]
}
}
}
}
blocks.styles.deny désenregistre les styles enregistrés via le registre de styles de blocs WordPress PHP :
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Utilisez blockEditor.patterns pour désactiver les sources de motifs globales et filtrer les catégories de motifs.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Utilisez blockEditor.media pour définir la politique globale d’insertion des médias.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
grab.enabled |
boolean | false |
Activer le sélecteur d’éléments du frontend |
perf |
boolean | false |
Activer le profileur de performances à chaque chargement de page |
canvas.enabled |
boolean | false |
Activer le canevas |
canvas.adminBar |
boolean | true |
Afficher la barre d’administration WordPress lorsque le canevas est affiché |
githooks
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
commit |
boolean | false |
Générer un hook de prévalidation limité à l’analyse lorsque blockstudio-githooks sync s’exécute |
Consultez le hook de commit géré pour savoir ce qu’exécute le hook généré et comment il reste synchronisé.
phpstan
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
preset |
string | "base" |
Préréglage d’analyse utilisé si la ligne de commande n’en sélectionne aucun : base, theme, extreme-theme ou wordpress-render |
configuration |
string | "" |
Configuration PHPStan du projet incluse avec le préréglage, résolue depuis blockstudio.json |
roots |
array | ["."] |
Racines de thèmes analysées par la commande canonique |
excludePaths |
array | [] |
Exclusions supplémentaires du scanner, relatives à chaque racine configurée |
maxFiles |
integer | 10000 |
Nombre maximal de fichiers inspectés par le scanner de thèmes |
blockTags |
object | {} |
Correspondances d’éléments, alias de balises et scanPhp pour la règle des balises de bloc |
Ces paramètres pilotent la commande canonique blockstudio-phpstan. Consultez
PHPStan pour découvrir les préréglages, les couches et l’adoption.
ai
| Option | Type | Valeur par défaut | Description |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Générer un fichier de contexte combiné regroupant les blocs, les réglages, les schémas et la documentation pour les outils LLM |
Consultez Intégration de l’IA pour l’index de la documentation et le texte complet généré.
Activez et composez les composants headless intégrés de UI, introduits dans Blockstudio 7.3.