Логически източници за откриване
Blockstudio обикновено открива файлове във физическите директории на темите. Инструментите по време на изпълнение могат да заменят тези директории с логически списък. Това е полезно за визуализации, наслагвания, генерирани теми, отдалечени монтирания и други среди, в които свързаните файлове нямат общ физически корен.
Blockstudio продължава да анализира и регистрира блокове, страници, колекции, шаблони, полета, темплейти и части от темплейти. Източникът определя само кои логически файлове са видими и откъде може да бъде прочетен всеки видим файл.
Източници на списъка с файлове
Използвайте филтъра blockstudio/discovery/sources, за да замените обектите 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
);
Наличните контексти са:
blocksfieldspagespatternssite-templatessite-template-parts
Списъкът с файлове представлява крайното видимо дърво. Съставете слоевете, преди да го върнете:
- Използвайте по един запис за всеки видим логически път.
- Нека избраният слой задава физическия път.
- Пропускайте изтритите логически пътища.
- Връщайте записите в произволен ред. Blockstudio ги сортира по логически път.
- Включвайте празните логически директории в незадължителния шести аргумент на конструктора, когато видимостта на директориите е от значение.
Inventory_Discovery_Source е удобен за списъци с файлове, изградени от масиви. Интеграциите могат да реализират интерфейса Discovery_Source, когато записите се разрешават лениво или идват от друга система за съхранение.
Разрешаване на съседни файлове
Логически съседни файлове могат да се разрешават към различни физически корени. Родителски block.json може да използва наслагване index.php, а страница от наслагването може да наследи родителския си pages.json, зареждащ механизъм или оформление. Blockstudio разрешава тези връзки по логически път, преди да прочете избраните физически файлове.
Пътищата на зареждащите механизми извън колекция запазват съществуващата граница за сигурност на blockstudio/pages/allow_external_loader_path.
Идентичност и обезсилване
Всеки източник предоставя:
- Стабилен ID на източника за избраната среда за изпълнение.
- Отпечатък, който се променя при промяна на видимия списък с файлове.
- Физически файлове за наблюдение при презареждане в реално време и проверка на кеша.
- Произход и метаданни за всеки запис.
Blockstudio включва ID на източниците и отпечатъците в идентичностите на кешовете за средата за изпълнение, манифеста на страницата, шаблона на Site Editor, Canvas и Tailwind.
Използвайте blockstudio/cache/context, когато един и същ избор на източник може да се визуализира в множество варианти на средата за изпълнение:
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 записва компилираните ресурси в обхват generated, специфичен за контекста, под конфигурирания корен на кеша Blockstudio, вместо до родителския източник. Така генерираните ресурси, изходът Tailwind, документите за визуализация и статично предварително генерираните страници споделят една и съща граница на хоста с възможност за запис.
Два филтъра покриват персонализираното маршрутизиране по време на изпълнение:
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
);
Използвайте филтъра URL, когато избраните файлове се намират извън wp-content или се предоставят чрез крайна точка на средата за изпълнение.