Blocs personnalisés en 3 fichiers
Pas de JavaScript, pas d’étape de compilation, pas de code passe-partout.
Définir les champs dans JSON
Ajoutez une clé blockstudio à block.json. Définissez des attributs avec des types tels que text, toggle et color. Blockstudio génère automatiquement l’éditeur UI, avec des types de champs 27 allant des champs de saisie de texte aux répéteurs et aux éditeurs de code, ainsi que les types de champs que vous enregistrez vous-même.
La prise en charge complète du schéma JSON offre la complétion automatique et la validation dans VS Code, PhpStorm et tous les éditeurs compatibles.
Chaque champ peut définir un default pour les nouveaux blocs et un fallback que le modèle reçoit lorsque le champ est vide.
{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "id": "showCta", "type": "toggle", "label": "Show CTA" },
{ "id": "background", "type": "color", "label": "Background" }
]
}
}Flux de travail en 3 fichiers
block.json pour les champs, un modèle pour le balisage et une feuille de style facultative.
React dans PHP
RichText, InnerBlocks et useBlockProps fonctionnent directement dans PHP, Twig ou Blade.
SCSS et Tailwind
Utilisez CSS, SCSS ou Tailwind. SCSS prend en charge les chemins d’importation et un préambule partagé ; la modification d’un fragment imbriqué recompile tous les fichiers qui l’importent.
27 types de champs
Texte, couleur, image, répéteur, sélection, éditeur de code et plus encore, configurés dans JSON.
JSON Schema
Complétion automatique et validation dans VS Code, PhpStorm et les éditeurs compatibles.
Trois langages de modèle
PHP, Twig et Blade partagent les mêmes variables et composants.
Imports npm
Importez des paquets dans script.js ; ils sont locaux en production et s’appuient sur CDN dans l’éditeur.
Interactivity API
Activez l’WordPress Interactivity API avec un seul indicateur.
Composants React dans les modèles PHP
Utilisez <RichText /> pour la modification en ligne et le HTML statique du frontend, <InnerBlocks /> pour les blocs enfants et useBlockProps pour le conteneur, le tout dans un seul modèle.
Dans l’éditeur, ils deviennent de véritables composants React. Sur le frontend, ils sont rendus en HTML côté serveur, sans que le JavaScript soit transmis aux visiteurs.
<div useBlockProps class="container">
<RichText
class="text-xl font-semibold"
tag="h1"
attribute="headline"
placeholder="Enter headline"
/>
<?php if ($a['showCta']): ?>
<a href="<?= esc_url($a['ctaUrl']) ?>">
<?= esc_html($a['ctaLabel']) ?>
</a>
<?php endif; ?>
<InnerBlocks class="mt-4 p-4 border" />
</div>Écrivez en PHP, Twig ou Blade
Utilisez le langage de modèles que vous connaissez. PHP fonctionne sans configuration, Twig s’exécute dès que Timber est installé, et Blade s’exécute sur illuminate/view 8 à 12 via Blockstudio\Blade_Renderer. Les variables, les composants et le comportement restent identiques.
$a (attributs), $b (bloc), $c (contexte) et $innerBlocks sont disponibles dans tous les langages.
Les modèles reçoivent aussi le contexte Twig complet Timber. Blade génère également les pages, les compositions et les modèles de l’éditeur de site. L’ancien wrapper jenssegers/blade échoue avec illuminate/view 10 et les versions ultérieures ; utilisez donc Blade_Renderer à la place.
<div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
{% if a.image %}
<img src="{{ a.image.url|esc_url }}"
alt="{{ a.image.alt|esc_attr }}" />
{% endif %}
<div class="card__body">{{ a.description|esc_html }}</div>
<InnerBlocks allowedBlocks='["core/button"]' />
</div><div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
@if ($a['description'])
<div class="card__body">{{ $a['description'] }}</div>
@endif
<InnerBlocks allowedBlocks='["core/button"]' />
</div>Logique conditionnelle et options dynamiques
Affichez ou masquez des champs avec des opérateurs tels que ==, !=, includes, empty et des comparaisons. Combinez les conditions avec la logique OU.
Les options peuvent dépendre d’un autre champ. Ajoutez {attributes.post_type.value} aux arguments de remplissage et la liste se recharge lorsque ce champ change. Ajoutez fetch: true pour rechercher des publications à mesure que l’éditeur saisit du texte.
Partagez une même liste d’options entre les blocs avec type: custom et le filtre blockstudio/blocks/attributes/populate, puis enregistrez vos propres conditions globales, comme la vérification d’un achat, via blockstudio/blocks/conditions.
{
"name": "starter/posts",
"title": "Posts",
"blockstudio": {
"attributes": [
{
"id": "post_type",
"type": "select",
"label": "Post type",
"options": [
{ "value": "page", "label": "Pages" },
{ "value": "post", "label": "Posts" }
]
},
{
"id": "selected_post",
"type": "select",
"label": "Post",
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "{attributes.post_type.value}" }
}
},
{
"id": "style",
"type": "select",
"label": "Style",
"populate": { "type": "custom", "custom": "cardStyles" },
"conditions": [[
{ "type": "purchasedProduct", "operator": "==", "value": "yes" }
]]
}
]
}
}add_filter('blockstudio/blocks/attributes/populate', function ($options) {
$options['cardStyles'] = [
['value' => 'light', 'label' => 'Light'],
['value' => 'dark', 'label' => 'Dark'],
];
return $options;
});
add_filter('blockstudio/blocks/conditions', function ($conditions) {
$conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
return $conditions;
});Des répétiteurs qui restent faciles à gérer
Définissez min et max, démarrez les nouveaux blocs avec default lignes et réduisez les lignes existantes avec minimized. textMinimized attribue à une ligne réduite le libellé de l’un de ses champs, comme un nom.
Les lignes acceptent tous les types de champs, sauf les onglets, y compris les répétiteurs imbriqués. Une condition dans une ligne vérifie un champ situé en dehors de celle-ci avec "context": "main" ; <RichText /> et <MediaPlaceholder /> modifient une seule ligne lorsque leur attribute pointe vers repeaterId[index].fieldId.
{
"name": "starter/team",
"title": "Team",
"blockstudio": {
"attributes": [
{
"id": "members",
"type": "repeater",
"label": "Team members",
"min": 1,
"max": 12,
"minimized": true,
"textMinimized": { "id": "name", "fallback": "Team member" },
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "bio", "type": "richtext", "label": "Bio" }
]
}
]
}
}<div useBlockProps class="team">
<?php foreach ($a['members'] as $index => $member): ?>
<article>
<h3><?= esc_html($member['name']) ?></h3>
<RichText
tag="p"
attribute="members[<?= $index ?>].bio"
placeholder="Short bio"
/>
</article>
<?php endforeach; ?>
</div>Ensembles de champs réutilisables
Définissez une fois un groupe de champs dans un field.json et référencez-le depuis n’importe quel bloc avec "type": "custom/cta". Les champs sont intégrés directement ; les modèles les lisent donc comme n’importe quel autre attribut.
Réutilisez le même ensemble avec un idStructure, par exemple hero_{id}, et modifiez les libellés, les valeurs par défaut ou les conditions par bloc avec overrides. Le type de champ block fait de même avec un bloc entier : il développe directement les champs de ce bloc et renvoie son HTML rendu.
{
"name": "cta",
"title": "Call to action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
{ "id": "url", "type": "link", "label": "Button URL" }
]
}{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{
"type": "custom/cta",
"idStructure": "secondary_{id}",
"overrides": {
"label": { "default": "Contact us" }
}
},
{
"id": "card",
"type": "block",
"block": "starter/card",
"idStructure": "card_{id}"
}
]
}
}Modules ES sans étape de compilation
Ajoutez script.js pour le charger comme module ES. Importez les paquets npm avec le préfixe npm:, et Blockstudio les télécharge localement pour la production.
L’éditeur affiche un aperçu instantané, tandis que le frontend utilise des modules locaux sans dépendance externe, chargés une seule fois.
Les feuilles de style s’importent de la même manière. import "npm:swiper@11.0.0/swiper.min.css" télécharge le fichier et l’ajoute à la file d’attente une seule fois par version, même si plusieurs blocs l’utilisent.
import Swiper from "npm:swiper@11.0.0";
import "npm:swiper@11.0.0/swiper.min.css";
for (const el of document.querySelectorAll(".swiper")) {
new Swiper(el, {
slidesPerView: 3,
spaceBetween: 20,
loop: true,
});
}Les balises de bloc au-delà des modèles
Associez un préfixe court à un espace de noms dans blockstudio.json, ou une balise à un bloc via un filtre d’alias, puis <acme-card> génère acme/card. Activez blockTags.enabled pour générer les balises dans le contenu des publications et les widgets, selon les limites des motifs allow et deny.
Les attributs data-* atteignent l’élément racine du bloc, et les attributs html-* y arrivent sans préfixe. Ajoutez vos propres générateurs de balises avec blockstudio/block_tags/builders et convertissez les formes abrégées en syntaxe portable <bs:acme-card> avec la commande migrate-block-tags.
{
"blockTags": {
"enabled": true,
"prefixes": {
"acme": ["acme"],
"ui": ["acme-ui"]
},
"deny": ["acme-ui/admin-*"]
}
}<div useBlockProps class="acme-features">
<acme-card
title="Fast"
text="Rendered on the server."
data-track="card"
/>
<ui-button label="Get started" href="/start" html-id="start" />
</div>Types de champs personnalisés
Enregistrez votre propre contrôle de champ et utilisez-le comme un champ intégré.
Blocs isolés
Mettez la page entière en cache et affichez un bloc lors de la requête du visiteur.
Enregistrement conditionnel
Enregistrez un bloc uniquement pour un type de publication, un rôle utilisateur ou une autre condition globale, ou ignorez-le si un plugin ou la version requise d’un plugin est absent.
Métadonnées d’article et options
Stockez des valeurs dans les métadonnées d’article ou les options, en plus des attributs du bloc.
Logique conditionnelle
Affichez des champs selon leurs valeurs, avec égalité, inclusion, absence de contenu et comparaisons.
Alimentation dynamique
Alimentez les choix à partir d’articles, d’utilisateurs, de termes, de fonctions ou d’API.
Remplacements
Définissez override: true avec le nom d’un bloc partagé pour fusionner les attributs par identifiant, remplacer les ressources dont les noms de fichier correspondent et changer le modèle. Les modèles Twig peuvent remplacer des blocs individuels avec extends.
Variantes
Déclarez dans block.json des variantes qui préconfigurent les valeurs des champs, puis masquez avec hidden le champ qui les contrôle.
Composants
Définissez component: true pour un bloc généré uniquement à partir de PHP ou de balises de bloc. Il conserve ses champs, ses modèles, ses ressources et Tailwind, mais n’apparaît jamais dans l’inséreur.
Règles InnerBlocks
Autorisez les blocs avec les jetons namespace/*, category: et @theme, changez le modèle interne depuis une option de sélection et supprimez le wrapper sur le site avec un filtre.
Ressources des champs de code
Un champ de code avec asset: true transforme la saisie dans l’éditeur en CSS, SCSS ou JavaScript pour ce bloc, et la limite à l’instance via %selector%.
Ressources selon le nom du fichier
*.view.js se charge uniquement sur le site ; les préfixes global-, admin- et block-editor- chargent un fichier sur chaque page, dans wp-admin ou dans l’éditeur de blocs.
Icônes et dossiers de blocs
Attribuez à un bloc une icône SVG personnalisée ou HTML, modifiez l’emplacement de recherche avec le filtre blockstudio/path et ajoutez des dossiers avec Blockstudio\Build::init().
Valeurs ACF et Meta Box
Les modèles reçoivent $post_id : get_field() et rwmb_get_value() lisent donc la publication modifiée, et refreshOn actualise l’aperçu après l’enregistrement.
Contexte de Query Loop
Dans une Query Loop, $block[‘context’][‘postId’] suit l’élément actuel, tandis que $block[‘postId’] reste la publication affichée.
WPML
wp bs wpml config écrit le wpml-config.xml qui indique que les champs de texte sont traduisibles, et les images enregistrées dans les champs rejoignent les tâches de traduction WPML avec leurs textes alternatifs et légendes.
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