# 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.

[Référence des types de champs](https://blockstudio.dev/fr/docs/blocks/attributes/field-types/)

block.json

```
{
  "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.

[Explorer les composants](https://blockstudio.dev/fr/docs/blocks/react-components/)

index.php

```
<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.

[Langages de modèles](https://blockstudio.dev/fr/docs/blocks/templating/blade/)

index.twig

```
<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>
```

## 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`.

[Logique conditionnelle](https://blockstudio.dev/fr/docs/blocks/attributes/conditional-logic/)

block.json

```
{
  "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" }
        ]]
      }
    ]
  }
}
```

## 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`.

[Modèles de répétiteurs](https://blockstudio.dev/fr/guides/field-patterns/#repeater-patterns)

block.json

```
{
  "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" }
        ]
      }
    ]
  }
}
```

## 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.

[Champs personnalisés](https://blockstudio.dev/fr/docs/blocks/attributes/custom-fields/)

fields/cta/field.json

```
{
  "name": "cta",
  "title": "Call to action",
  "attributes": [
    { "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
    { "id": "url", "type": "link", "label": "Button URL" }
  ]
}
```

## 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.

[Traitement des ressources](https://blockstudio.dev/fr/docs/blocks/assets/)

script.js

```
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`.

[Lire le guide](https://blockstudio.dev/fr/guides/block-tags/)

blockstudio.json

```
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}
```

## 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.

Plus

## 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

[Obtenir Plus](https://blockstudio.dev/fr/plus/)
