Przejdź do treści

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

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
);

Dostępne konteksty:

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

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

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
);

Użyj filtra URL, gdy wybrane pliki znajdują się poza wp-content lub są udostępniane przez punkt końcowy środowiska uruchomieniowego.