Mantıksal Keşif Kaynakları
Blockstudio normalde dosyaları fiziksel tema dizinlerinden keşfeder. Çalışma zamanı araçları bu dizinleri mantıksal bir envanterle değiştirebilir. Bu; önizlemeler, katmanlar, oluşturulmuş temalar, uzak bağlamalar ve ilişkili dosyaların tek bir fiziksel kökü paylaşmadığı diğer ortamlar için kullanışlıdır.
Blockstudio blokları, sayfaları, koleksiyonları, desenleri, alanları, şablonları ve şablon parçalarını ayrıştırıp kaydetmeye devam eder. Kaynak yalnızca hangi mantıksal dosyaların görünür olduğunu ve görünür her dosyanın nereden okunabileceğini belirler.
Envanter kaynakları
Varsayılan Filesystem_Discovery_Source nesnelerini değiştirmek için blockstudio/discovery/sources filtresini kullanın:
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
);
Kullanılabilir bağlamlar şunlardır:
blocksfieldspagespatternssite-templatessite-template-parts
Envanter, görünür durumdaki son ağaçtır. Döndürmeden önce katmanları birleştirin:
- Görünür her mantıksal yol için bir girdi kullanın.
- Fiziksel yolu seçilen katmanın sağlamasını sağlayın.
- Silinmiş mantıksal yolları dahil etmeyin.
- Girdileri istediğiniz sırada döndürebilirsiniz. Blockstudio bunları mantıksal yola göre sıralar.
- Dizin görünürlüğü önemliyse, boş mantıksal dizinleri oluşturucunun isteğe bağlı altıncı bağımsız değişkenine ekleyin.
Inventory_Discovery_Source dizi tabanlı envanterler için kullanışlıdır. Girdilerin geç çözümlendiği veya başka bir depolama sisteminden geldiği durumlarda entegrasyonlar Discovery_Source arayüzünü uygulayabilir.
Kardeş çözümleme
Mantıksal kardeşler farklı fiziksel köklere çözümlenebilir. Bir üst block.json, bir katman index.php kullanabilir; katman sayfası ise üst pages.json, yükleyici veya düzenden devralabilir. Blockstudio, seçilen fiziksel dosyaları okumadan önce bu ilişkileri mantıksal yola göre çözümler.
Koleksiyon dışındaki yükleyici yolları, mevcut blockstudio/pages/allow_external_loader_path güvenlik sınırını korur.
Kimlik ve geçersizleştirme
Her kaynak şunları sağlar:
- Seçilen çalışma zamanı için kararlı bir kaynak kimliği.
- Görünür envanter değiştiğinde değişen bir parmak izi.
- Sıcak yeniden yükleme ve önbellek doğrulaması için fiziksel izleme girdileri.
- Her girdi için kaynak bilgileri ve meta veriler.
Blockstudio; kaynak kimliklerini ve parmak izlerini çalışma zamanı, sayfa manifesti, Site Düzenleyicisi şablonu, Tuval ve Tailwind önbellek kimliklerine ekler.
Aynı kaynak seçiminin birden fazla çalışma zamanı varyantında görüntülenebildiği durumlarda blockstudio/cache/context kullanın:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Bağlam değeri serileştirilebilir ve eşdeğer istekler için kararlı olmalıdır. Tailwind son iyi CSS değerini bağlama özgü bir ad alanında tutar; böylece bir önizleme başka bir önizlemenin yedek CSS değerini alamaz.
Oluşturulan varlıklar
Devralınan veya salt okunur girdileri kaynak bilgisi ya da meta verilerde inherited: true, readOnly: true veya writable: false ile işaretleyin. Ardından Blockstudio, derlenmiş varlıkları üst kaynağın yanına yazmak yerine yapılandırılmış Blockstudio önbellek kökünün altında, bağlama özgü bir generated kapsamına yazar. Böylece oluşturulan varlıklar, Tailwind çıktısı, görüntüleme belgeleri ve statik önceden oluşturma işlemleri aynı yazılabilir ana bilgisayar sınırını paylaşır.
Özel çalışma zamanı yönlendirmesini iki filtre kapsar:
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
);
Seçilen dosyalar wp-content dışında bulunuyorsa veya bir çalışma zamanı uç noktası üzerinden sunuluyorsa URL filtresini kullanın.