Fontes de descoberta lógica
Blockstudio normalmente descobre arquivos em diretórios físicos de temas. Ferramentas de runtime podem substituir esses diretórios por um inventário lógico. Isso é útil para pré-visualizações, sobreposições, temas gerados, montagens remotas e outros ambientes em que arquivos relacionados não compartilham uma única raiz física.
Blockstudio ainda analisa e registra blocos, páginas, coleções, padrões, campos, templates e partes de template. A origem só determina quais arquivos lógicos ficam visíveis e onde cada arquivo visível pode ser lido.
Origens do inventário
Use o filtro blockstudio/discovery/sources para substituir os objetos Filesystem_Discovery_Source padrão:
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
);
Os contextos disponíveis são:
blocksfieldspagespatternssite-templatessite-template-parts
Um inventário é a árvore visível final. Combine as camadas antes de retorná-lo:
- Use uma entrada para cada caminho lógico visível.
- Deixe a camada selecionada fornecer o caminho físico.
- Omita caminhos lógicos excluídos.
- Retorne as entradas em qualquer ordem. Blockstudio as ordena pelo caminho lógico.
- Inclua diretórios lógicos vazios no sexto argumento opcional do construtor quando a visibilidade dos diretórios for relevante.
Inventory_Discovery_Source é prático para inventários baseados em arrays.
Integrações podem implementar a interface Discovery_Source quando as entradas são
resolvidas sob demanda ou vêm de outro sistema de armazenamento.
Resolução de arquivos irmãos
Arquivos lógicos irmãos podem ser resolvidos para raízes físicas diferentes. Um block.json pai pode usar uma index.php sobreposta, e uma página sobreposta pode herdar seu pages.json pai, carregador ou layout. Blockstudio resolve essas relações pelo caminho lógico antes de ler os arquivos físicos selecionados.
Caminhos do carregador fora de uma coleção mantêm o limite de segurança existente de blockstudio/pages/allow_external_loader_path.
Identidade e invalidação
Cada origem fornece:
- Um ID de origem estável para o runtime selecionado.
- Uma impressão digital que muda conforme o inventário visível.
- Entradas físicas observadas para recarga a quente e validação de cache.
- Proveniência e metadados para cada entrada.
Blockstudio inclui IDs de origem e impressões digitais nas identidades de runtime, manifesto de páginas, template do Editor do Site, Canvas e cache Tailwind.
Use blockstudio/cache/context quando a mesma seleção de origem puder ser renderizada em
múltiplas variantes de runtime:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
O valor de contexto deve ser serializável e estável para solicitações equivalentes. Tailwind mantém a última CSS válida em um namespace específico do contexto, para que uma pré-visualização não receba a alternativa de outra pré-visualização CSS.
Recursos gerados
Marque entradas herdadas ou somente leitura com inherited: true, readOnly: true,
ou writable: false na proveniência ou nos metadados. Blockstudio então grava
os recursos compilados em um escopo generated específico do contexto, abaixo da raiz de cache Blockstudio configurada, em vez de junto à origem pai. Assim, os recursos gerados,
a saída de Tailwind, os documentos de renderização e as pré-renderizações estáticas compartilham
os mesmos limites de gravação do host.
Dois filtros abrangem o roteamento personalizado de runtime:
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 o filtro URL quando os arquivos selecionados estiverem fora de wp-content ou forem servidos
por um endpoint de runtime.