Blok full-stack
Basis data, fungsi server, cron, dan CLI dalam satu folder.
db.php
Tentukan skema, dapatkan endpoint CRUD
<?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
Fungsi server kustom
<?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];
},
];Setiap kapabilitas berupa berkas
Setiap berkas menambahkan satu kapabilitas. Tanpa konfigurasi dan kode registrasi.
Blok aplikasi
blockstudio/
└── my-app/
├── block.json Definisi blok
├── index.php Template + Interactivity API
├── style.css Gaya tercakup
├── script-inline.js Logika klien
├── db.php Model data + CRUD
├── rpc.php Fungsi server
├── cron.php Tugas terjadwal
└── db/default.sqlite
Basis Data
Tentukan skema, dapatkan endpoint CRUD.
6 mode penyimpanan
table, sqlite, jsonc, storh, meta, post_type. Pilih berdasarkan portabilitas dan kebutuhan kueri.
file Storh
Satu file untuk tiap rekaman di bawah uploads, dengan indeks yang dibuat dari skema dan penulisan serentak yang lebih aman. wp bs db migrate –to=storh memindahkan rekaman JSONC dan mempertahankan ID-nya.
Tabel dan tipe pos
Penyimpanan table mengelola tabel MySQL dengan dbDelta dan menambahkan kolom untuk bidang baru. Penyimpanan post_type menjadikan setiap rekaman sebagai pos, sehingga WP_Query, plugin REST API, dan alat GraphQL dapat membacanya.
Beberapa skema
Kembalikan skema bernama dari satu db.php. Masing-masing mendapat penyimpanan, endpoint, dan kontrol akses sendiri.
Data dengan cakupan pengguna
Atur userScoped untuk mengisolasi catatan secara otomatis, tanpa pemfilteran manual.
Validasi dan hook
Tipe, nilai wajib, enum, format, panjang, callback, dan hook siklus hidup.
RPC
Fungsi server yang dapat dipanggil dari frontend.
Lapisan data klien
Baca, simpan dalam cache, dan tulis rekaman dari browser.
Klien bs.db()
Buat, tampilkan daftar, ambil, perbarui, dan hapus rekaman dari JavaScript. list menerima filter bidang, limit, dan offset.
bs.query()
Pengambilan yang di-cache berdasarkan kunci. Panggilan yang sedang berlangsung berbagi satu promise, dan staleTime melewati permintaan selama data masih segar.
bs.mutate()
Pembuatan, pembaruan, dan penghapusan optimistis pada array status reaktif, yang dikembalikan ke snapshot jika permintaan gagal.
bs.cache
Cache dalam memori di balik bs.query() dan bs.mutate(). Baca, tetapkan, invalidasi, atau hapus entri secara langsung.
Polling waktu nyata
Atur realtime di db.php, lalu klien membandingkan hash data secara berkala dan memperbarui store Interactivity API. Polling dijeda di tab tersembunyi.
Halaman yang di-cache
bs.fn() dan bs.db() mengambil kredensial baru dari endpoint yang tidak di-cache pada panggilan pertama, sehingga panggilan publik tetap berfungsi pada halaman yang disajikan dari cache berumur panjang.
Formulir dan layar aplikasi
Formulir yang dirender dari skema, serta UI siap pakai untuk dikembangkan.
Formulir skema
Beri bidang kunci komponen, lalu bs_db_form() merender formulir melalui blok-blok tersebut dan meneruskan definisi bidang kepada masing-masing blok.
Formulir yang dibundel
Dengan ui.enabled, bsui/form block=”…” mengirim bidangnya ke endpoint create blok tersebut, menampilkan setiap kesalahan validasi di bawah bidangnya, serta memicu formsuccess atau formerror.
Contoh aplikasi
Pengaturan ui juga mendaftarkan contoh app/*, seperti app/kitchen-sink dan app/chat, yang dibuat dari komponen bsui yang sama.
Infrastruktur
Cron, CLI, kode penyiapan, dan portabilitas.
Tugas terjadwal
Tugas cron.php didaftarkan ke WP-Cron. Penghapusan instalasi Composer menghapusnya dengan wp bs teardown.
CLI basis data
wp bs db menampilkan daftar rekaman dengan filter bidang, mengambil, membuat, memperbarui, dan menghapusnya, serta mencetak tabel, JSON, atau CSV.
Uji dari terminal
wp bs rpc call menjalankan fungsi dengan parameter –key=value, dan wp bs cron run langsung menjalankan tugas, apa pun jadwalnya.
File init
init.php dan file init*.php lainnya di folder blok dijalankan sekali saat init, untuk penyiapan seperti mendaftarkan tipe pos.
Definisi bawaan PHP
rpc.php dan cron.php dapat mengembalikan kelas dengan metode #[Rpc] dan #[Cron], serta enum Access, Method, dan Schedule. db.php dapat menggunakan Schema::make() dan pembuat Field.
Portabilitas
SQLite dan JSONC ikut berpindah bersama kode: salin satu folder untuk menerapkan aplikasi.
Kit ekstensi resmi
Template situs premium, instruksi sistem AI, dan komunitas Discord privat. Pembelian satu kali, pembaruan seumur hidup.
- 500+ templat situs
- Instruksi sistem AI
- Pembaruan seumur hidup
- Komunitas privat Discord