Sumber Penemuan Logis
Blockstudio biasanya menemukan file dari direktori tema fisik. Alat runtime dapat mengganti direktori tersebut dengan inventaris logis. Ini berguna untuk pratinjau, overlay, tema yang dibuat secara otomatis, mount jarak jauh, dan lingkungan lain di mana file terkait tidak berada dalam satu root fisik.
Blockstudio tetap mengurai dan mendaftarkan blok, halaman, koleksi, pola, field, templat, dan bagian templat. Sumber hanya menentukan file logis mana yang terlihat dan lokasi pembacaan setiap file yang terlihat.
Sumber inventaris
Gunakan filter blockstudio/discovery/sources untuk mengganti objek Filesystem_Discovery_Source
default:
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
);
Konteks yang tersedia adalah:
blocksfieldspagespatternssite-templatessite-template-parts
Inventaris adalah pohon akhir yang terlihat. Gabungkan lapisan sebelum mengembalikannya:
- Gunakan satu entri untuk setiap jalur logis yang terlihat.
- Biarkan lapisan yang dipilih menyediakan jalur fisik.
- Hilangkan jalur logis yang dihapus.
- Kembalikan entri dalam urutan apa pun. Blockstudio mengurutkannya berdasarkan jalur logis.
- Sertakan direktori logis kosong dalam argumen opsional keenam konstruktor jika visibilitas direktori penting.
Inventory_Discovery_Source praktis untuk inventaris berbasis array.
Integrasi dapat mengimplementasikan antarmuka Discovery_Source jika entri
diselesaikan secara malas atau berasal dari sistem penyimpanan lain.
Resolusi berkas sejawat
Berkas sejawat logis dapat mengarah ke root fisik yang berbeda. block.json induk
dapat menggunakan index.php overlay, dan halaman overlay dapat mewarisi pages.json induknya, pemuat, atau tata letaknya. Blockstudio menyelesaikan hubungan ini
berdasarkan jalur logis sebelum membaca file fisik yang dipilih.
Jalur pemuat di luar koleksi tetap mengikuti batas keamanan
blockstudio/pages/allow_external_loader_path yang sudah ada.
Identitas dan invalidasi
Setiap sumber menyediakan:
- ID sumber yang stabil untuk runtime terpilih.
- Fingerprint yang berubah mengikuti inventaris yang terlihat.
- Input pantauan fisik untuk pemuatan ulang langsung dan validasi cache.
- Asal dan metadata untuk setiap entri.
Blockstudio menyertakan ID sumber dan fingerprint dalam identitas cache runtime, manifes halaman, templat Site Editor, Canvas, dan Tailwind.
Gunakan blockstudio/cache/context saat pilihan sumber yang sama dapat dirender dalam
beberapa varian runtime:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Nilai konteks harus dapat diserialisasi dan stabil untuk permintaan yang setara. Tailwind menyimpan CSS terakhir yang baik dalam namespace khusus konteks, sehingga satu pratinjau tidak menerima CSS cadangan milik pratinjau lain.
Aset yang dibuat
Tandai entri yang diwarisi atau hanya-baca dengan inherited: true, readOnly: true,
atau writable: false dalam asal atau metadata. Blockstudio kemudian menulis
aset yang dikompilasi ke cakupan generated khusus konteks di bawah root cache Blockstudio yang dikonfigurasi, bukan di samping sumber induk. Karena itu, aset yang dihasilkan,
keluaran Tailwind, dokumen render, dan prarender statis menggunakan batas host yang dapat ditulisi sama.
Dua filter menangani perutean runtime kustom:
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
);
Gunakan filter URL jika file terpilih berada di luar wp-content atau disajikan
melalui endpoint runtime.