Ajustes
Blockstudio incluye una potente API de ajustes que permite establecer opciones mediante un archivo blockstudio.json en la carpeta del tema o mediante filtros. Además, los usuarios autorizados pueden cambiar visualmente los ajustes desde el área de administración.
Mediante JSON
Si hay un archivo blockstudio.json en la carpeta del tema, se usará para establecer las opciones predeterminadas del sitio actual. Hay disponible un esquema de JSON para validar el archivo y facilitar el autocompletado al usar un IDE.
El archivo es opcional. Si no está, Blockstudio usa los ajustes guardados en el área de administración junto con sus valores predeterminados integrados. La incorporación, modificación o eliminación del archivo se detecta automáticamente, por lo que no hace falta borrar la caché ni recargar manualmente.
Están disponibles las siguientes propiedades:
{
"$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
}
}
Mediante filtros
Como alternativa, puedes usar el filtro blockstudio/settings/${setting} para establecer opciones mediante PHP y tener más flexibilidad.
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');
Las opciones establecidas mediante el filtro blockstudio/settings/${setting} prevalecen sobre las establecidas en el archivo blockstudio.json. Puedes usar ambos métodos a la vez.
Los valores de ejecución también exponen filtros blockstudio/performance/${setting} y un filtro blockstudio/performance/config final. Este último debe devolver un objeto de configuración válido.
Cómo se combinan las fuentes
Cada fuente se carga y se combina, empezando por la de menor prioridad:
- Valores predeterminados integrados
- Ajustes guardados mediante UI en el área de administración (la opción
blockstudio_settings) blockstudio.jsonen el tema- Filtros
blockstudio/settings/*
blockstudio.json solo reemplaza las claves que declara. Antes sustituía por completo los ajustes guardados, por lo que un valor guardado en el área de administración y sin relación dejaba de aplicarse en cuanto aparecía el archivo; ahora se superpone a ellos. La otra cara es que un valor obsoleto guardado mediante UI en el área de administración sigue aplicándose hasta que el archivo declara esa clave o se elimina el valor guardado. Si un ajuste se comporta de forma distinta a lo que indica el archivo, comprueba la capa de valores guardados con wp bs settings o Settings::get_raw(), que devuelve solo lo que la fuente activa JSON u opciones declaró explícitamente.
Leer ajustes desde PHP
Blockstudio\Settings carga la fuente activa, informa de los JSON con formato incorrecto y se vuelve a cargar automáticamente cuando cambia blockstudio.json:
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);
}
Use Settings::get_raw() cuando una integración necesite únicamente los valores declarados explícitamente por la fuente JSON activa o por la fuente de opciones. Settings::fingerprint() devuelve una identidad determinista de la configuración efectiva. Los procesos de larga duración pueden llamar explícitamente a Settings::reload() para leer de inmediato los cambios de un archivo. En cada solicitud o proceso PHP de larga duración, el acceso normal comprueba el archivo como máximo una vez por segundo, incluso si las modificaciones conservan el tamaño. Los cambios en la ruta configurada se aplican en la siguiente lectura. Si no hay ningún archivo JSON activo, esta ventana no retrasa la configuración guardada en la base de datos.
El perfil de rendimiento resuelto está disponible mediante Blockstudio\Runtime_Settings::current(). Admite rutas con barras o puntos:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Ajustes disponibles
users
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
ids |
array | [] |
IDs de usuario con acceso al editor |
roles |
array | [] |
Roles de usuario con acceso al editor |
assets
| Opción | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
enqueue |
booleano | true |
Añadir automáticamente a la cola los recursos de bloque |
reset.enabled |
booleano | false |
Quitar los estilos de bloque del núcleo y aplicar el restablecimiento de utilidades del editor |
reset.fullWidth |
matriz | [] |
Tipos de entrada que usan el diseño del editor de ancho completo |
minify.css |
booleano | false |
Minificar la salida de CSS |
minify.js |
booleano | false |
Minificar la salida de JS |
process.scss |
booleano | false |
Procesar archivos SCSS |
output |
cadena | source |
Ubicación donde se escriben los recursos compilados: source o cache |
inlineLimit |
entero | 0 |
Bytes de CSS externo de bloque que se imprimen en línea por página |
output usa source de forma predeterminada, lo que crea un directorio _dist junto a cada bloque. Establécelo en cache para guardar los recursos compilados en el directorio de caché Blockstudio, de modo que el árbol de código fuente de los bloques se mantenga limpio y se pueda desplegar desde una copia de trabajo inmutable. Los archivos de código fuente Blockstudio que ya están configurados para redirigir se escriben en la caché independientemente de este ajuste.
inlineLimit está desactivado en 0, por lo que cada hoja de estilo externa conserva su etiqueta <link>. Establézcalo en un número de bytes para imprimir en línea las hojas de estilo externas de bloque más pequeñas de una página, siempre que el total no supere ese número. 40000 es el límite que WordPress del núcleo usa para la misma regla. Consulte Insertar hojas de estilo pequeñas.
Con reset.enabled activado, Blockstudio también copia los valores de body_class del frontend, una vez depurados, al lienzo del editor. Usa blockstudio/editor/canvas/body_class para ajustar la lista de clases que se aplica solo al editor.
cache
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
enabled |
boolean | true |
Activar las cachés basadas en archivos de Blockstudio |
path |
string | "blockstudio/cache" |
Ruta de la caché, relativa a WP_CONTENT_DIR o absoluta |
namespaceGrace |
integer | 86400 |
Segundos que se conserva un espacio de nombres de caché retirado antes de eliminarlo |
De forma predeterminada, los archivos de caché se escriben en wp-content/blockstudio/cache, fuera del directorio de subidas. Las rutas relativas de path se resuelven desde WP_CONTENT_DIR; las rutas absolutas se usan directamente. Esto es compatible con servidores que proporcionan un volumen de caché específico con permisos de escritura.
Cuando está activado, Blockstudio usa esta raíz única para las cargas de compilación, los datos de registro de bloques precompilados, los recursos del editor resueltos, Tailwind CSS, los documentos de renderizado, los fragmentos de islas, los prerenderizados estáticos, los índices de grafos, las colas y los diagnósticos. Cada objeto se aísla por red, sitio, identidad completa del entorno de ejecución y ámbito. Las identidades del entorno de ejecución incluyen Blockstudio, ajustes, WordPress, PHP, el tema activo, los plugins activos, las fuentes de descubrimiento lógico, el contexto del servidor y los hashes de dependencias explícitos proporcionados por la operación propietaria.
Los cambios en el contenido, los términos, los usuarios y los metadatos invalidan las opciones de campos almacenadas, pero no el descubrimiento estructural de bloques ni los recursos compilados. Las opciones se actualizan por separado bajo un bloqueo fijo de la ruta de compilación. Las ráfagas de escrituras, como una sincronización de traducciones o una importación, se agrupan: la primera escritura tras un periodo de inactividad actualiza las opciones de inmediato, y la última escritura de la ráfaga se refleja una vez transcurridos treinta segundos, ajustables con blockstudio/cache/populate_debounce. Los metadatos que WordPress escribe como registro contable, como el bloqueo de edición de una entrada, no cuentan como cambios; blockstudio/cache/populate_ignored_meta_keys amplía esa lista. El editor siempre consulta las opciones actuales, por lo que el intervalo solo afecta a las opciones almacenadas que se leen al renderizar. Los archivos de origen y los ajustes de compilación siguen invalidando la caché estructural con normalidad. Sobrescribir las opciones no vuelve a explorar el directorio de caché con cada cambio de contenido; la limpieza periódica sigue eliminando los archivos temporales huérfanos. Las identidades de ejecución específicas de cada idioma permanecen aisladas; la existencia de varios directorios de espacios de nombres de caché en un sitio multilingüe no demuestra por sí sola que haya fallado una búsqueda en caché.
La actividad del diario SQLite dentro del directorio de datos db de un bloque no descarta los metadatos del bloque almacenados en caché. Los cambios en db.php, los archivos de origen supervisados o la estructura de archivos de origen y subdirectorios del directorio de datos siguen invalidando la caché.
En las reconstrucciones simultáneas del entorno de ejecución, se elige un único proceso encargado de compilar. Las demás solicitudes esperan hasta cinco segundos y luego reutilizan los metadatos del bloque de la última compilación válida, siempre que sus archivos de código fuente y los recursos compilados necesarios sigan existiendo. Una solicitud en frío sin datos seguros devuelve HTTP 503 con Retry-After en vez de iniciar otra compilación. El filtro blockstudio/cache/build_wait_budget ajusta la espera en milisegundos tanto para las reconstrucciones estructurales como para las actualizaciones de opciones. En servidores sin bloqueos de archivos consultivos, las opciones se actualizan sin protección y se publican igualmente, de modo que la siguiente solicitud encuentra la caché.
Los archivos .build.lock de bloqueo específicos de una clave e inactivos que dejaron versiones anteriores se recopilan en todos los espacios de nombres de caché de este sitio mediante WP-Cron, a partir de cinco minutos después de la actualización y eliminando hasta 10,000 bloqueos por minuto dentro de un límite de diez segundos. wp bs cache status informa del recuento restante y wp bs cache cleanup vacía el trabajo pendiente de inmediato; wp bs cache clear purga la caché del entorno de ejecución. Si una tarea programada lleva más de diez minutos de retraso porque cron no se está ejecutando, las solicitudes recorren una cantidad limitada de bloqueos una vez por hora para evitar que la limpieza se detenga. Los bloqueos recientes o retenidos se dejan intactos, y los nuevos bloqueos con ruta fija nunca se recopilan. Una vez vaciado el trabajo pendiente, la misma tarea elimina los espacios de nombres de caché abandonados cuando haya transcurrido su namespaceGrace, como máximo una vez por hora en cada sitio, y mantiene una tarea diaria para ello. El período de gracia se cuenta desde el primer recorrido que detecta que un espacio de nombres está retirado, no desde su archivo más reciente; nunca se elimina un espacio de nombres que siga vigente para cualquiera de sus ámbitos.
La limpieza interna de la caché no ejecuta filtros de eliminación de adjuntos de WordPress. Los servidores con WP-Cron desactivado deben seguir ejecutando su proceso programado habitual de cron; no elimines indiscriminadamente archivos de bloqueo activos para vaciar el trabajo pendiente.
El filtro del ajuste blockstudio/settings/cache/path cambia el valor configurado. Para resolver rutas específicas del despliegue, blockstudio/cache/dir aplica filtros al directorio base resuelto:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Los servidores cuya identidad de inquilino difiera de los IDs de red o blog de WordPress pueden aplicar filtros a blockstudio/cache/site_key. El resultado se depura y se usa únicamente como segmento de directorio. blockstudio/cache/context sigue siendo el lugar adecuado para una variante serializable del entorno de ejecución que deba modificar las identidades de los objetos.
themeDefaults
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
titleTag |
boolean | false |
Activar la compatibilidad con etiquetas de título de WordPress |
suppressDirectoryUpdates |
boolean | false |
Quitar los temas secundarios y principales activos de los resultados de actualización de directorios |
Los patrones siguen usando el Blockstudio\Patterns API existente; estos valores predeterminados no incorporan fachadas alternativas para páginas o patrones.
performance
El perfil compat deja sin cambios el comportamiento genérico de WordPress. speed y strict activan los mismos valores predeterminados opcionales del frontend; cada ajuste secundario puede sobrescribir el valor de su perfil.
Los ajustes opcionales son controles de registro. Cuando se false una función opcional, Blockstudio no conecta sus callbacks de frontend, administración, editor, REST ni los programados. Si desactivas Early Serve o el calentamiento programado después de haberlos usado, se realiza una vez la limpieza correspondiente; las solicitudes posteriores no hacen nada.
| Opción | Tipo | Valor predeterminado de compatibilidad | Valor predeterminado de velocidad/estrictitud | Descripción |
|---|---|---|---|---|
profile |
string | "compat" |
No aplicable | compat, speed o strict |
wordpress.headNoise |
boolean | false |
true |
Elimina la detección genérica del encabezado y la salida de emoji |
wordpress.embeds |
boolean | false |
true |
Elimina la detección de oEmbed y los scripts del host |
wordpress.xmlrpc |
boolean | false |
true |
Desactiva XML-RPC y los pingbacks |
wordpress.editor |
boolean | false |
true |
Desactiva las superficies de detección del editor remoto |
wordpress.frontendAssets |
boolean | false |
true |
Elimina los recursos genéricos del frontend del núcleo |
wordpress.media |
boolean | false |
true |
Aplica valores predeterminados de salida de imagen |
wordpress.heartbeat |
boolean | false |
true |
Limita Heartbeat fuera de los editores |
preload.links |
string | "off" |
"intent" |
Precarga documentos del mismo origen tras la intención del usuario |
media.lazy |
boolean | false |
true |
Usa el cargador de imágenes de Blockstudio |
media.skeleton |
boolean | false |
true |
Muestra el esqueleto de carga integrado |
media.metadata |
boolean | false |
true |
Declara el uso de assets/media.json |
media.rootMargin |
string | "300px" |
"300px" |
Margen de intersección del cargador diferido |
measurement.enabled |
boolean | false |
false |
Habilita las API de medición en tiempo de ejecución |
measurement.queryMonitor |
boolean | false |
false |
Incluye consultas de al menos 50ms |
measurement.headers |
boolean | false |
false |
Envía encabezados de perfil y hash de configuración |
measurement.timings |
boolean | false |
false |
Envía el encabezado del tiempo de ejecución transcurrido |
staticPrerender.enabled |
boolean | false |
false |
Habilita el almacenamiento en caché HTML seguro para usuarios anónimos |
staticPrerender.ttl |
integer | 86400 |
86400 |
Antigüedad máxima del documento en caché, en segundos |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Usa la identidad signature o incremental graph |
staticPrerender.earlyServe |
boolean | false |
false |
Sirve resultados seguros antes de que arranque WordPress |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Permite que los usuarios consuman resultados de caché, pero nunca que los creen |
staticPrerender.dynamicPaths |
array | [] |
[] |
Prefijos de ruta que deben seguir siendo dinámicos |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Encabezados de respuesta almacenados y enviados en resultados de caché |
staticPrerender.warm.enabled |
boolean | false |
false |
Habilita la cola persistente de calentamiento programado |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Intervalo de calentamiento en segundos |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Número máximo de trabajos procesados en cada pasada de calentamiento |
staticPrerender.warm.transport |
string | "http" |
"http" |
Usa http o un renderizador proporcionado por el host internal |
La prerrepresentación estática permanece desactivada salvo que se habilite
explícitamente. Un interruptor maestro desactivado no registra ningún hook de
solicitud de prerrepresentación, y los interruptores desactivados earlyServe
y warm.enabled no registran hooks de administración ni de cron. El modo de firma usa
una identidad activada de bajo coste en las solicitudes habituales. El modo de
Grafo está pensado para compilaciones explícitas: registra las dependencias de
origen por página para que el cambio en una página no invalide documentos no
relacionados. Consulta Prerrepresentación estática para obtener información sobre el calentamiento,
el despliegue, el servicio anticipado y la seguridad.
Las mediciones están disponibles mediante programación:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Cuando los encabezados están habilitados, Blockstudio envía
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config y, opcionalmente,
X-Blockstudio-Performance-Time. La acción
blockstudio/performance/measurement_enabled recibe la configuración de tiempo de ejecución resuelta.
Las opciones de media controlan bs_media_image(), el manifiesto de
assets/media.json y el cargador diferido del frontend. Consulta Medios
para obtener información sobre el auxiliar, el generador del manifiesto y el comportamiento del cargador.
content
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
enabled |
boolean | false |
Habilitar la configuración de Content Sync |
id |
string | "default" |
Espacio de nombres del conjunto de contenido almacenado en las entidades sincronizadas |
path |
string | "content" |
Directorio de archivos de contenido relativo al tema |
includePageSyncManaged |
boolean | false |
Incluir entradas gestionadas por Page Sync sin controlar su contenido |
authors |
string | "ignore" |
Gestión de autores (ignore o usuario existente login) |
postTypes |
array | [] |
Tipos de contenido permitidos |
meta.include |
array | [] |
Patrones glob para sincronizar claves meta |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Patrones glob para excluir claves meta |
meta.references |
object | {} |
Referencias meta declaradas que se reescriben entre ID y UID |
taxonomies |
array | [] |
Taxonomías registradas permitidas para términos y relaciones |
media |
string | "manifest" |
Comportamiento de las referencias a adjuntos (manifest o none) |
Content Sync se gestiona mediante wp bs content y proyecta entradas permitidas,
postmeta y referencias declaradas en archivos portátiles. Consulta
Content Sync para conocer el flujo de trabajo y el formato de archivo.
editor
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
formatOnSave |
boolean | false |
Formatear block.json al guardar |
assets |
array | [] |
Recursos adicionales que se cargarán en el editor |
markup |
boolean | false |
Habilitar la edición de marcado |
tailwind
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
enabled |
boolean | false |
Habilitar la compilación de Tailwind CSS |
config |
string | "" |
Configuración Tailwind v4 CSS primero |
Consulta Tailwind CSS para conocer el comportamiento de la compilación y el formato de configuración que prioriza CSS.
blockTags
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
enabled |
boolean | false |
Habilitar la representación de etiquetas bs: a nivel de página en el contenido de las entradas y las áreas de widgets |
allow |
array | [] |
Lista de patrones de nombres de bloques permitidos; admite comodines fnmatch() |
deny |
array | [] |
Lista de patrones de nombres de bloques denegados; tiene prioridad sobre allow |
prefixes |
object | {} |
Prefijo para asignar un espacio de nombres a las abreviaturas; cada valor es un espacio de nombres o una matriz ordenada |
La representación de etiquetas a nivel de plantilla siempre está activa; estas opciones controlan el reemplazo a nivel de página. Consulta Representación para conocer la sintaxis de las etiquetas y las reglas de resolución.
ui
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
enabled |
boolean | false |
Registrar los componentes bsui/* UI incluidos y las aplicaciones de demostración app/* |
blockEditor
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
disableLoading |
boolean | false |
Desactivar la carga de bloques en el editor |
enhance |
boolean | false |
Habilitar las opciones de interacción para pasar el cursor y seleccionar en el editor de Blockstudio |
cssClasses |
array | [] |
URL de hojas de estilo de las que extraer clases CSS para el autocompletado del campo de clases |
cssVariables |
array | [] |
URL de hojas de estilo de las que extraer variables CSS para el autocompletado del campo de código |
blockEditor.blocks
Usa blockEditor.blocks para definir la política del insertador de bloques de todo el proyecto. allow y deny aceptan nombres de bloques y patrones comodín como 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 anula el registro de los estilos que se registraron mediante el registro de estilos de bloque WordPress’
PHP:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Usa blockEditor.patterns para desactivar las fuentes globales de patrones y filtrar
las categorías de patrones.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Usa blockEditor.media para definir la política global del insertador de medios.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
grab.enabled |
boolean | false |
Habilitar el selector de elementos del frontend |
perf |
boolean | false |
Habilitar el perfilador de rendimiento en cada carga de página |
canvas.enabled |
boolean | false |
Habilitar el lienzo |
canvas.adminBar |
boolean | true |
Mostrar la barra de administración de WordPress al ver el lienzo |
githooks
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
commit |
boolean | false |
Generar un hook de precommit solo de análisis cuando se ejecute blockstudio-githooks sync |
Consulta el hook de confirmación gestionado para saber qué ejecuta el hook generado y cómo se mantiene sincronizado.
phpstan
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
preset |
string | "base" |
Ajuste preestablecido de análisis si la línea de comandos no selecciona uno: base, theme, extreme-theme o wordpress-render |
configuration |
string | "" |
Configuración PHPStan del proyecto incluida junto al ajuste preestablecido, resuelta desde blockstudio.json |
roots |
array | ["."] |
Raíces de temas analizadas por el comando canónico |
excludePaths |
array | [] |
Exclusiones adicionales del analizador, relativas a cada raíz configurada |
maxFiles |
integer | 10000 |
Número máximo de archivos que inspecciona el analizador de temas |
blockTags |
object | {} |
Asignaciones de elementos, alias de etiquetas y scanPhp para la regla de etiquetas de bloque |
Estos ajustes controlan el comando canónico blockstudio-phpstan. Consulta
PHPStan para conocer los ajustes preestablecidos, las capas y la adopción.
ai
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Generar un archivo de contexto combinado con bloques, ajustes, esquemas y documentación para herramientas de LLM |
Consulta Integración de IA para ver el índice de documentación y el texto generado completo.
Habilita y combina los componentes headless incluidos de UI, incorporados en Blockstudio 7.3.