Tam yığın bloklar
Veritabanı, sunucu işlevleri, cron ve CLI tek klasörde.
db.php
Şemayı tanımlayın, CRUD uç noktalarını alın
<?php
return [
'storage' => 'sqlite',
'userScoped' => true,
'capability' => [
'create' => true,
'read' => true,
'update' => true,
'delete' => true,
],
'fields' => [
'text' => ['type' => 'string', 'required' => true],
'done' => ['type' => 'boolean', 'default' => false],
],
];rpc.php
Özel sunucu işlevleri
<?php
use Blockstudio\Db;
return [
'toggle' => function (array $params): array {
$db = Db::get('my-theme/todo');
$id = (int) ($params['id'] ?? 0);
$todo = $db->get_record($id);
if ($todo) {
$db->update($id, ['done' => !$todo['done']]);
}
return ['success' => (bool) $todo];
},
'clear_done' => function (): array {
$db = Db::get('my-theme/todo');
foreach ($db->list(['done' => true], 500) as $todo) {
$db->delete((int) $todo['id']);
}
return ['cleared' => true];
},
];Her özellik bir dosyadır
Her dosya bir özellik ekler. Yapılandırma ve kayıt kodu gerekmez.
Uygulama bloğu
blockstudio/
└── my-app/
├── block.json Blok tanımı
├── index.php Şablon + Interactivity API
├── style.css Kapsamı belirlenmiş stiller
├── script-inline.js İstemci mantığı
├── db.php Veri modeli + CRUD
├── rpc.php Sunucu işlevleri
├── cron.php Zamanlanmış görevler
└── db/default.sqlite
Veritabanı
Şemaları tanımlayın, CRUD uç noktalarını alın.
6 depolama modu
table, sqlite, jsonc, storh, meta, post_type. Taşınabilirlik ve sorgu gereksinimlerine göre seçin.
Storh dosya
Yüklemeler altında her kayıt için bir dosya; dizinler şemadan oluşturulur ve eşzamanlı yazmalar daha güvenlidir. wp bs db migrate –to=storh komutu JSONC kaydı taşır ve kimliklerini korur.
Tablolar ve yazı türleri
table depolama, dbDelta ile bir MySQL tablosunu yönetir ve yeni alanlar için sütunlar ekler. post_type depolama, her kaydı bir yazı olarak oluşturur; böylece WP_Query, REST API eklentileri ve GraphQL araçları bu kaydı okuyabilir.
Birden çok şema
Tek bir db.php üzerinden adlandırılmış şemalar döndürün. Her birinin kendi depolaması, uç noktaları ve erişim denetimi olur.
Kullanıcı kapsamlı veriler
Kayıtları elle filtrelemeden otomatik olarak yalıtmak için userScoped değerini ayarlayın.
Doğrulama ve kancalar
Türler, zorunlu değerler, enum’lar, biçimler, uzunluklar, geri çağrılar ve yaşam döngüsü kancaları.
RPC
Ön uçtan çağrılabilen sunucu işlevleri.
bs.fn() istemcisi
İşlevleri JavaScript üzerinden çağırın; satır içi betikler blok adını otomatik algılar.
Erişim denetimi
CSRF korumalı herkese açık erişim, webhook’lar için açık erişim veya işlev başına yetenek tabanlı erişim.
Bloklar arası çağrılar
JavaScript veya PHP üzerinden herhangi bir blok işlevini çağırın ve mantığı birleştirin.
İstemci veri katmanı
Kayıtları tarayıcıdan okuyun, önbelleğe alın ve yazın.
bs.db() istemcisi
JavaScript üzerinden kayıt oluşturun, listeleyin, alın, güncelleyin ve silin. list, alan filtrelerini, limit ve offset değerlerini alır.
bs.query()
Anahtara göre önbelleğe alınmış getirme işlemleri. Devam eden çağrılar tek bir promise’ı paylaşır; staleTime ise veriler güncelse isteği atlar.
bs.mutate()
Reaktif bir durum dizisinde iyimser kayıt oluşturma, güncelleme ve silme; istek başarısız olursa anlık görüntüye geri alınır.
bs.cache
bs.query() ve bs.mutate() arkasındaki bellek içi önbellek. Girdileri doğrudan okuyun, ayarlayın, geçersiz kılın veya temizleyin.
Gerçek zamanlı yoklama
db.php içinde gerçek zamanlıyı ayarlayın; istemci belirli aralıklarla veri karmasını karşılaştırır, ardından Interactivity API deposunu günceller. Gizli sekmelerde yoklama duraklatılır.
Önbelleğe alınmış sayfalar
bs.fn() ve bs.db(), ilk çağrıda önbelleğe alınmayan bir uç noktadan yeni kimlik bilgileri getirir; böylece sayfalar uzun süreli önbelleklerden sunulurken de genel çağrılar çalışmaya devam eder.
Formlar ve uygulama ekranları
Şemadan oluşturulan formlar ve üzerine inşa edilecek paketlenmiş UI.
Şema formları
Bir alana bileşen anahtarı verin; bs_db_form() formu bu bloklar üzerinden oluşturur ve her birine alan tanımını iletir.
Birleştirilmiş form
ui.enabled ile bsui/form block=”…”, alanlarını o bloğun create uç noktasına gönderir, her doğrulama hatasını ilgili alanın altında gösterir ve formsuccess veya formerror olayını tetikler.
Örnek uygulamalar
ui ayarı, aynı bsui bileşenlerinden oluşturulan app/kitchen-sink ve app/chat gibi app/* örneklerini de kaydeder.
Altyapı
Cron, CLI, kurulum kodu ve taşınabilirlik.
Zamanlanmış görevler
cron.php görevleri WP-Cron ile kaydedilir. Composer kaldırma işlemi bunları wp bs teardown komutuyla siler.
Veritabanı CLI
wp bs db, alan filtreleriyle kayıtları listeler, getirir, oluşturur, günceller ve siler; ayrıca tabloları, JSON veya CSV yazdırır.
Terminalden test edin
wp bs rpc call, –key=value parametreleriyle bir işlev çalıştırır; wp bs cron run ise zamanlaması ne olursa olsun bir işi hemen başlatır.
Başlatma dosyaları
init.php ve blok klasöründeki diğer init*.php dosyaları init sırasında bir kez çalışır; örneğin bir yazı türünü kaydetmek için.
PHP yerel tanımlar
rpc.php ve cron.php, #[Rpc] ve #[Cron] yöntemleri ile Access, Method ve Schedule enum’larını içeren bir sınıf döndürebilir. db.php, Schema::make() ve Field oluşturucularını kullanabilir.
Taşınabilirlik
SQLite ve JSONC kodla birlikte taşınır: uygulamayı dağıtmak için tek bir klasörü kopyalayın.
Resmî uzantı kiti
Premium site şablonları, yapay zekâ sistem talimatları ve özel bir Discord topluluğu. Tek seferlik satın alma, ömür boyu güncellemeler.
- 500+ site şablonu
- Yapay zekâ sistem talimatları
- Ömür boyu güncellemeler
- Özel Discord topluluğu