Blocs full-stack
Base de données, fonctions serveur, cron et CLI dans un seul dossier.
db.php
Définissez un schéma, obtenez des points de terminaison 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
Fonctions serveur personnalisées
<?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];
},
];Chaque fonctionnalité est un fichier
Chaque fichier ajoute une fonctionnalité. Aucune configuration ni code d’enregistrement.
Bloc d’application
blockstudio/
└── my-app/
├── block.json Définition du bloc
├── index.php Modèle + interactivité API
├── style.css Styles délimités
├── script-inline.js Logique côté client
├── db.php Modèle de données + CRUD
├── rpc.php Fonctions serveur
├── cron.php Tâches planifiées
└── db/default.sqlite
Base de données
Définissez des schémas, obtenez des points de terminaison CRUD.
6 modes de stockage
table, sqlite, jsonc, storh, meta, post_type. Choisissez selon les besoins de portabilité et de requêtes.
fichiers Storh
Un fichier par enregistrement dans uploads, avec des index générés à partir du schéma et des écritures simultanées plus sûres. wp bs db migrate –to=storh transfère JSONC enregistrements et conserve leurs identifiants.
Tables et types de publication
Le stockage en table gère une table MySQL avec dbDelta et ajoute des colonnes pour les nouveaux champs. Le stockage en post_type crée un article pour chaque enregistrement, que WP_Query, les extensions REST API et les outils GraphQL peuvent lire.
Schémas multiples
Renvoyez des schémas nommés depuis un seul db.php. Chacun dispose de son propre stockage, de ses points de terminaison et de son contrôle d’accès.
Données associées à l’utilisateur
Définissez userScoped pour isoler automatiquement les enregistrements, sans filtrage manuel.
Validation et hooks
Types, valeurs requises, énumérations, formats, longueurs, fonctions de rappel et hooks de cycle de vie.
RPC
Fonctions serveur appelables depuis l’interface frontend.
Client bs.fn()
Appelez les fonctions depuis JavaScript ; les scripts intégrés détectent automatiquement le nom du bloc.
Contrôle d’accès
Public avec CSRF, ouvert aux webhooks ou fondé sur les capacités, selon la fonction.
Appels entre blocs
Appelez toute fonction de bloc depuis JavaScript ou PHP et composez votre logique.
Couche de données client
Lire, mettre en cache et écrire des enregistrements depuis le navigateur.
Client bs.db()
Créer, lister, récupérer, mettre à jour et supprimer des enregistrements depuis JavaScript. list accepte des filtres de champs, une limite et un décalage.
bs.query()
Récupérations mises en cache par clé. Les appels en cours partagent une promesse, et staleTime évite la requête tant que les données sont à jour.
bs.mutate()
Création, mise à jour et suppression optimistes dans un tableau d’état réactif, avec retour à un instantané en cas d’échec de la requête.
bs.cache
Le cache en mémoire derrière bs.query() et bs.mutate(). Lisez, définissez, invalidez ou effacez directement ses entrées.
Interrogation périodique en temps réel
Activez le mode temps réel dans db.php : le client compare un hachage des données à intervalle régulier, puis met à jour le magasin Interactivity API. L’interrogation périodique s’interrompt dans les onglets masqués.
Pages mises en cache
bs.fn() et bs.db() récupèrent des identifiants à jour auprès d’un point de terminaison non mis en cache lors du premier appel. Ainsi, les appels publics continuent de fonctionner sur les pages servies depuis des caches de longue durée.
Formulaires et écrans d’application
Des formulaires générés à partir du schéma et des éléments UI intégrés pour démarrer.
Formulaires de schéma
Attribuez une clé de composant à un champ et bs_db_form() génère le formulaire à l’aide de ces blocs, en transmettant à chacun la définition de son champ.
Formulaire groupé
Avec ui.enabled, bsui/form block=”…” envoie ses champs au point de terminaison de création de ce bloc, affiche chaque erreur de validation sous le champ concerné et déclenche formssuccess ou formerror.
Applications d’exemple
Le paramètre ui enregistre aussi les exemples app/*, comme app/kitchen-sink et app/chat, construits à partir des mêmes composants bsui.
Infrastructure
Cron, CLI, code de configuration et portabilité.
Tâches planifiées
Les tâches cron.php sont enregistrées auprès de WP-Cron. Les installations de Composer les suppriment avec wp bs teardown.
CLI de base de données
wp bs db liste les enregistrements avec des filtres de champs, les récupère, les crée, les met à jour et les supprime, puis affiche des tableaux, JSON ou CSV.
Tester depuis le terminal
wp bs rpc call exécute une fonction avec des paramètres –key=value, et wp bs cron run lance immédiatement une tâche, quel que soit son calendrier.
Fichiers d’initialisation
init.php et les autres fichiers init*.php d’un dossier de bloc s’exécutent une fois lors de init, pour des opérations de configuration comme l’enregistrement d’un type de publication.
Définitions natives PHP
rpc.php et cron.php peuvent renvoyer une classe avec des méthodes #[Rpc] et #[Cron], ainsi que les énumérations Access, Method et Schedule. db.php peut utiliser Schema::make() et des constructeurs de champs.
Portabilité
SQLite et JSONC accompagnent le code : copiez un dossier pour déployer l’application.
Le kit d’extension officiel
Modèles de site premium, instructions système pour l’IA et communauté privée Discord. Achat unique, mises à jour à vie.
- 500+ modèles de sites
- Instructions système de l’IA
- Mises à jour à vie
- Communauté privée Discord