본문으로 건너뛰기

논리적 검색 소스

Blockstudio는 일반적으로 실제 테마 디렉터리에서 파일을 검색합니다. 런타임 도구는 해당 디렉터리를 논리적 목록으로 대체할 수 있습니다. 이는 미리 보기, 오버레이, 생성된 테마, 원격 마운트 및 관련 파일이 하나의 실제 루트를 공유하지 않는 다른 환경에서 유용합니다.

Blockstudio는 계속해서 블록, 페이지, 컬렉션, 패턴, 필드, 템플릿 및 템플릿 파트를 파싱하고 등록합니다. 소스는 어떤 논리적 파일을 볼 수 있는지, 각 파일을 어디에서 읽을 수 있는지만 결정합니다.

목록 소스

blockstudio/discovery/sources 필터를 사용해 기본 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
);

사용 가능한 컨텍스트는 다음과 같습니다:

  • blocks
  • fields
  • pages
  • patterns
  • site-templates
  • site-template-parts

목록은 최종적으로 보이는 트리입니다. 반환하기 전에 계층을 구성하세요:

  • 보이는 논리 경로마다 항목 하나를 사용합니다.
  • 선택된 계층이 실제 경로를 제공하도록 합니다.
  • 삭제된 논리 경로는 제외합니다.
  • 항목 순서는 자유롭게 지정할 수 있습니다. Blockstudio가 논리 경로별로 정렬합니다.
  • 디렉터리 표시 여부가 중요하다면 생성자의 선택적 여섯 번째 인수에 빈 논리 디렉터리를 포함합니다.

Inventory_Discovery_Source는 배열 기반 목록에 편리합니다. 항목을 지연 확인하거나 다른 저장소 시스템에서 가져오는 경우 통합 기능에서 Discovery_Source 인터페이스를 구현할 수 있습니다.

형제 파일 확인

논리적 형제 파일은 서로 다른 실제 루트에 있을 수 있습니다. 상위 block.json은 오버레이 index.php를 사용할 수 있으며, 오버레이 페이지는 상위 pages.json, 로더 또는 레이아웃을 상속할 수 있습니다. Blockstudio는 선택된 실제 파일을 읽기 전에 논리 경로를 기준으로 이러한 관계를 확인합니다.

컬렉션 외부의 로더 경로에는 기존 blockstudio/pages/allow_external_loader_path 보안 경계가 유지됩니다.

ID 및 무효화

각 소스는 다음을 제공합니다:

  • 선택한 런타임의 안정적인 소스 ID.
  • 보이는 목록이 바뀌면 변경되는 지문.
  • 핫 리로드 및 캐시 검증을 위한 실제 감시 입력.
  • 각 항목의 출처와 메타데이터.

Blockstudio는 런타임, 페이지 매니페스트, 사이트 편집기 템플릿, 캔버스 및 Tailwind 캐시 ID에 소스 ID와 지문을 포함합니다.

동일한 소스 선택을 여러 런타임 변형에서 렌더링할 수 있을 때 blockstudio/cache/context를 사용하세요:

PHP
add_filter(
    'blockstudio/cache/context',
    fn ($context, string $scope) => [
        'preview' => 'feature-card',
        'site' => get_current_blog_id(),
    ],
    10,
    2
);

컨텍스트 값은 직렬화할 수 있어야 하며 동일한 요청에 대해 안정적이어야 합니다. Tailwind는 이전에 정상 작동한 CSS를 컨텍스트별 네임스페이스에 보관하므로 한 미리 보기에 다른 미리 보기의 대체 CSS가 표시되지 않습니다.

생성된 에셋

상속되거나 읽기 전용인 항목은 출처 또는 메타데이터에서 inherited: true, readOnly: true 또는 writable: false로 표시하세요. 그러면 Blockstudio는 컴파일된 에셋을 상위 소스 옆이 아니라 구성된 Blockstudio 캐시 루트 아래의 컨텍스트별 generated 범위에 기록합니다. 따라서 생성된 에셋, Tailwind 출력, 렌더 문서 및 정적 사전 렌더링은 동일한 쓰기 가능 호스트 경계를 공유합니다.

사용자 정의 런타임 라우팅에는 두 가지 필터를 사용합니다:

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

선택된 파일이 wp-content 외부에 있거나 런타임 엔드포인트를 통해 제공될 때 URL 필터를 사용하세요.