Orígenes de descubrimiento lógico
Blockstudio suele descubrir archivos en los directorios físicos de los temas. Las herramientas de ejecución pueden sustituir esos directorios por un inventario lógico. Esto resulta útil para vistas previas, capas superpuestas, temas generados, montajes remotos y otros entornos en los que los archivos relacionados no comparten una misma raíz física.
Blockstudio sigue analizando y registrando bloques, páginas, colecciones, patrones, campos, plantillas y partes de plantillas. El origen solo determina qué archivos lógicos son visibles y desde dónde se puede leer cada archivo visible.
Orígenes del inventario
Use el filtro blockstudio/discovery/sources para reemplazar los objetos Filesystem_Discovery_Source predeterminados:
use Blockstudio\Inventory_Discovery_Source;
add_filter(
'blockstudio/discovery/sources',
function (array $sources, string $context, array $paths): array {
if ('blocks' !== $context) {
return $sources;
}
return [
new Inventory_Discovery_Source(
'preview:feature-card',
'/runtime-preview/feature-card/blockstudio',
[
'card/block.json' => [
'path' => '/theme/blockstudio/card/block.json',
'provenance' => [
'layer' => 'parent',
'inherited' => true,
],
],
'card/index.php' => [
'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
'provenance' => [
'layer' => 'preview',
],
],
],
'parent-and-preview-fingerprint',
['/theme/blockstudio', '/runtime-preview/feature-card/blockstudio']
),
];
},
10,
3
);
Los contextos disponibles son:
blocksfieldspagespatternssite-templatessite-template-parts
Un inventario es el árbol visible definitivo. Combine las capas antes de devolverlo:
- Use una entrada por cada ruta lógica visible.
- Deje que la capa seleccionada proporcione la ruta física.
- Omita las rutas lógicas eliminadas.
- Devuelva las entradas en cualquier orden. Blockstudio las ordena por ruta lógica.
- Incluya los directorios lógicos vacíos en el sexto argumento opcional del constructor cuando la visibilidad de los directorios sea relevante.
Inventory_Discovery_Source es práctico para inventarios basados en matrices.
Las integraciones pueden implementar la interfaz Discovery_Source cuando las entradas
se resuelven de forma diferida o proceden de otro sistema de almacenamiento.
Resolución de elementos del mismo nivel
Los elementos lógicos del mismo nivel pueden resolverse en distintas raíces físicas. Un padre
block.json puede usar una superposición index.php, y una página superpuesta puede heredar de su padre
pages.json, cargador o diseño. Blockstudio resuelve estas relaciones
mediante la ruta lógica antes de leer los archivos físicos seleccionados.
Las rutas de cargadores que quedan fuera de una colección mantienen el límite de seguridad existente de blockstudio/pages/allow_external_loader_path.
Identidad e invalidación
Cada origen proporciona:
- Un ID de origen estable para el entorno de ejecución seleccionado.
- Una huella digital que cambia cuando cambia el inventario visible.
- Rutas físicas que se observan para la recarga en caliente y la validación de la caché.
- Procedencia y metadatos para cada entrada.
Blockstudio incluye los ID de origen y las huellas digitales en las identidades de las cachés de ejecución, del manifiesto de páginas, de plantillas del editor del sitio, de lienzo y de Tailwind.
Use blockstudio/cache/context cuando la misma selección de origen pueda generarse en
varias variantes de ejecución:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
El valor de contexto debe poder serializarse y ser estable en solicitudes equivalentes. Tailwind mantiene CSS en buen estado en un espacio de nombres específico del contexto, para que una vista previa no reciba el CSS alternativo de otra.
Recursos generados
Marque las entradas heredadas o de solo lectura con inherited: true, readOnly: true,
o writable: false en la procedencia o los metadatos. Así, Blockstudio escribe
los recursos compilados en un ámbito generated específico del contexto, dentro de la raíz de caché Blockstudio configurada, en lugar de hacerlo junto al origen principal. Por tanto, los recursos generados,
la salida de Tailwind, los documentos renderizados y los prerenderizados estáticos comparten
el mismo límite de escritura del anfitrión.
Dos filtros cubren el enrutamiento de ejecución personalizado:
add_filter(
'blockstudio/generated_output/path',
function (string $path, string $source, string $scope, array $metadata) {
return $path;
},
10,
4
);
add_filter(
'blockstudio/files/url',
function (string $url, string $path, string $scope) {
return $url;
},
10,
3
);
Use el filtro URL cuando los archivos seleccionados estén fuera de wp-content o se sirvan
mediante un punto de conexión de ejecución.