Źródła logicznego wykrywania
Blockstudio zwykle wykrywa pliki w fizycznych katalogach motywów. Narzędzia środowiska uruchomieniowego mogą zastąpić te katalogi logicznym spisem. Przydaje się to w podglądach, nakładkach, generowanych motywach, zdalnych montowaniach i innych środowiskach, w których powiązane pliki nie mają wspólnego katalogu fizycznego.
Blockstudio nadal analizuje i rejestruje bloki, strony, kolekcje, rutyny, pola, szablony i części szablonów. Źródło określa tylko, które pliki logiczne są widoczne i skąd można odczytać każdy widoczny plik.
Źródła spisu
Użyj filtra blockstudio/discovery/sources, aby zastąpić domyślne
obiekty Filesystem_Discovery_Source:
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
);
Dostępne konteksty:
blocksfieldspagespatternssite-templatessite-template-parts
Spis przedstawia końcowe widoczne drzewo. Połącz warstwy przed jego zwróceniem:
- Użyj jednego wpisu dla każdej widocznej ścieżki logicznej.
- Pozwól, aby wybrana warstwa określała ścieżkę fizyczną.
- Pomiń usunięte ścieżki logiczne.
- Zwróć wpisy w dowolnej kolejności. Blockstudio sortuje je według ścieżki logicznej.
- Uwzględnij puste katalogi logiczne w opcjonalnym szóstym argumencie konstruktora, jeśli widoczność katalogów ma znaczenie.
Inventory_Discovery_Source sprawdza się w przypadku spisów opartych na tablicach.
Integracje mogą implementować interfejs Discovery_Source, gdy wpisy są
rozwiązywane na żądanie lub pochodzą z innego systemu przechowywania.
Rozpoznawanie elementów sąsiadujących
Logiczne elementy sąsiadujące mogą wskazywać różne katalogi fizyczne. Nadrzędny
block.json może korzystać z nakładki index.php, a strona w nakładce może dziedziczyć z nadrzędnego
pages.json, moduł ładujący lub układ. Blockstudio rozpoznaje te zależności
według ścieżki logicznej, zanim odczyta wybrane pliki fizyczne.
Ścieżki modułów ładujących poza kolekcją zachowują dotychczasową
granicę bezpieczeństwa blockstudio/pages/allow_external_loader_path.
Tożsamość i unieważnianie
Każde źródło udostępnia:
- Stabilny identyfikator źródła dla wybranego środowiska uruchomieniowego.
- Odcisk palca zmieniający się wraz z widocznym spisem.
- Fizyczne ścieżki monitorowane na potrzeby ponownego ładowania i weryfikacji pamięci podręcznej.
- Pochodzenie i metadane każdego wpisu.
Blockstudio uwzględnia identyfikatory źródeł i odciski palców w tożsamościach środowiska uruchomieniowego, manifestu strony, szablonu edytora witryny, Canvas i pamięci podręcznej Tailwind.
Użyj blockstudio/cache/context, gdy ten sam wybór źródła może być renderowany
w wielu wariantach środowiska uruchomieniowego:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Wartość kontekstu musi być możliwa do serializacji i stabilna dla równoważnych żądań. Tailwind przechowuje ostatni poprawny CSS w przestrzeni nazw właściwej dla kontekstu, dzięki czemu jeden podgląd nie otrzyma zapasowego CSS z innego podglądu.
Wygenerowane zasoby
Oznacz odziedziczone lub tylko do odczytu wpisy za pomocą inherited: true, readOnly: true
lub writable: false w informacjach o pochodzeniu lub metadanych. Wtedy Blockstudio zapisuje
skompilowane zasoby w zakresie generated właściwym dla kontekstu, pod skonfigurowanym
katalogiem głównym pamięci podręcznej Blockstudio, zamiast obok źródła nadrzędnego. Wygenerowane zasoby,
wynik Tailwind, dokumenty renderowania i wstępnie wygenerowane strony statyczne korzystają zatem
z tej samej zapisywalnej granicy hosta.
Dwa filtry obsługują niestandardowe kierowanie środowiska uruchomieniowego:
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
);
Użyj filtra URL, gdy wybrane pliki znajdują się poza wp-content lub są udostępniane
przez punkt końcowy środowiska uruchomieniowego.