Saltar al contenido

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:

PHP
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:

  • blocks
  • fields
  • pages
  • patterns
  • site-templates
  • site-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:

PHP
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:

PHP
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.