Full-Stack-Blöcke
Datenbank, Serverfunktionen, cron und CLI in einem Ordner.
db.php
Schema definieren, CRUD-Endpunkte erhalten
<?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
Benutzerdefinierte Serverfunktionen
<?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];
},
];Jede Funktion ist eine Datei
Jede Datei fügt eine Funktion hinzu. Keine Konfiguration und kein Registrierungscode.
Anwendungsblock
blockstudio/
└── my-app/
├── block.json Blockdefinition
├── index.php Vorlage + Interactivity API
├── style.css Gekapselte Styles
├── script-inline.js Clientlogik
├── db.php Datenmodell + CRUD
├── rpc.php Serverfunktionen
├── cron.php Geplante Aufgaben
└── db/default.sqlite
Datenbank
Schemas definieren und CRUD-Endpunkte erhalten.
6 Speichermodi
table, sqlite, jsonc, storh, meta, post_type. Wähle nach Portabilität und Abfragebedarf.
Storh-Dateien
Eine Datei pro Datensatz unter uploads, mit anhand des Schemas erstellten Indizes und sichereren gleichzeitigen Schreibvorgängen. wp bs db migrate –to=storh verschiebt JSONC Datensätze und behält ihre IDs bei.
Tabellen und Inhaltstypen
Der Tabellenspeicher verwaltet eine MySQL-Tabelle mit dbDelta und fügt Spalten für neue Felder hinzu. Der post_type-Speicher macht jeden Datensatz zu einem Beitrag, sodass WP_Query, REST- API-Plugins und GraphQL-Tools darauf zugreifen können.
Mehrere Schemata
Gib benannte Schemata von einem einzigen db.php zurück. Jedes erhält eigenen Speicher, eigene Endpunkte und eigene Zugriffskontrolle.
Benutzerbezogene Daten
Setze userScoped, um Datensätze automatisch und ohne manuelle Filterung zu isolieren.
Validierung und Hooks
Typen, Pflichtwerte, Enums, Formate, Längen, Callbacks und Lifecycle-Hooks.
RPC
Serverfunktionen, die vom Frontend aufgerufen werden können.
bs.fn()-Client
Funktionen von JavaScript aus aufrufen; Inline-Skripte erkennen den Blocknamen automatisch.
Zugriffskontrolle
Pro Funktion: öffentlich mit CSRF, offen für Webhooks oder über Berechtigungen gesteuert.
Aufrufe zwischen Blöcken
Beliebige Blockfunktionen von JavaScript oder PHP aus aufrufen und Logik kombinieren.
Client-Datenebene
Datensätze im Browser lesen, zwischenspeichern und schreiben.
bs.db()-Client
Datensätze über JavaScript erstellen, auflisten, abrufen, aktualisieren und löschen. list akzeptiert Feldfilter, Limit und Offset.
bs.query()
Abfragen werden nach Schlüssel zwischengespeichert. Gleichzeitige Aufrufe teilen sich ein Promise, und staleTime überspringt die Anfrage, solange die Daten aktuell sind.
bs.mutate()
Optimistisches Erstellen, Aktualisieren und Löschen in einem reaktiven Zustandsarray; schlägt die Anfrage fehl, wird der vorherige Snapshot wiederhergestellt.
bs.cache
Der In-Memory-Cache hinter bs.query() und bs.mutate(). Einträge direkt lesen, setzen, ungültig machen oder leeren.
Echtzeit-Abfragen
Aktiviere Echtzeit in db.php. Der Client vergleicht regelmäßig einen Daten-Hash und aktualisiert anschließend den Interactivity-API-Store. In ausgeblendeten Tabs pausieren die Abfragen.
Zwischengespeicherte Seiten
bs.fn() und bs.db() rufen beim ersten Aufruf aktuelle Zugangsdaten von einem nicht zwischengespeicherten Endpunkt ab, damit öffentliche Aufrufe auch auf Seiten funktionieren, die aus langlebigen Caches bereitgestellt werden.
Formulare und App-Bildschirme
Aus dem Schema gerenderte Formulare und gebündelte UI als Grundlage.
Schemaformulare
Gib einem Feld einen Komponentenschlüssel, und bs_db_form() rendert das Formular mithilfe dieser Blöcke und übergibt jedem seine Felddefinition.
Gebündeltes Formular
Mit ui.enabled sendet bsui/form block=”…” seine Felder an den Erstellungsendpunkt dieses Blocks, zeigt jeden Validierungsfehler unter dem zugehörigen Feld an und löst formsuccess oder formerror aus.
Beispiel-Apps
Die ui-Einstellung registriert auch die app/*-Beispiele wie app/kitchen-sink und app/chat, die auf denselben bsui-Komponenten basieren.
Infrastruktur
Cron, CLI, Einrichtungscode und Portabilität.
Geplante Aufgaben
cron.php-Jobs werden bei WP-Cron registriert. Composer-Deinstallationen entfernen sie mit wp bs teardown.
Datenbank-CLI
wp bs db listet Datensätze mit Feldfiltern auf, ruft sie ab, erstellt, aktualisiert und löscht sie und gibt Tabellen, JSON oder CSV aus.
Im Terminal testen
wp bs rpc call führt eine Funktion mit –key=value-Parametern aus, und wp bs cron run startet einen Job sofort, unabhängig von seinem Zeitplan.
Init-Dateien
init.php und andere init*.php-Dateien in einem Blockordner werden einmal bei init ausgeführt, etwa für die Einrichtung und Registrierung eines Inhaltstyps.
PHP-native Definitionen
rpc.php und cron.php können eine Klasse mit #[Rpc]- und #[Cron]-Methoden sowie den Access-, Method- und Schedule-Enums zurückgeben. db.php kann Schema::make() und Field-Builder verwenden.
Portabilität
SQLite und JSONC kommen mit dem Code: Kopiere einen Ordner, um die App bereitzustellen.
Das offizielle Erweiterungspaket
Premium-Websitevorlagen, KI-Systemanweisungen und eine private Discord-Community. Einmaliger Kauf, Updates auf Lebenszeit.
- 500+ Website-Vorlagen
- KI-Systemanweisungen
- Updates auf Lebenszeit
- Private Discord-Community