Aller au contenu

Ajoutez des champs à n’importe quel bloc

JSON pur. Pas de modèles ni de fonctions de rendu.

Des champs personnalisés, zéro modèle

Créez un fichier JSON, ciblez un bloc avec name et définissez les champs. set associe les valeurs à des classes, des styles, des attributs de données ou tout autre attribut HTML.

Blockstudio applique le résultat avec le Tag Processor WordPress HTML. Pas de modèles ni de fonctions de rendu.

extend-animation.json
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "allowNull": "None",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ],
        "set": [{
          "attribute": "class",
          "value": "animate-{attributes.animation}"
        }]
      }
    ]
  }
}

Ciblez n’importe quel bloc

Étendez un bloc, une liste ou un caractère générique d’espace de noms.

La propriété set

Associez les champs à des classes, des styles, des attributs de données ou tout attribut HTML.

Champs conditionnels

Affichez des champs en fonction d’autres valeurs avec la logique des blocs.

Toutes les fonctionnalités

Tous les types de champs, la logique conditionnelle, les sources de données et les propriétés.

Positionnement dans l’inspecteur

Placez les champs dans les onglets Réglages, Styles ou Avancé.

Ordre de priorité

Ordonnez plusieurs extensions qui ciblent le même bloc.

Aucune fonction de rendu

Le Tag Processor HTML applique automatiquement le résultat.

JSON Schema

Complétion automatique et validation dédiées pour les schémas.

Associer des valeurs à HTML avec set

set associe les valeurs à des classes, des styles en ligne, des attributs de données ou tout attribut HTML avec la notation par points, par exemple {attributes.fieldId}.

Accédez aux valeurs d’objets imbriqués, appliquez-les sous conditions ou envoyez un champ vers plusieurs attributs.

Un champ qui renvoie plusieurs valeurs applique set à chacune d’elles. Les classes et les styles se cumulent ; pour tout autre attribut, "join": true écrit chaque valeur, séparée par des espaces, au lieu de conserver la dernière.

extend-color.json
{
  "name": "core/heading",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "customColor",
        "type": "select",
        "returnFormat": "both",
        "options": [
          { "value": "#f00", "label": "Red" },
          { "value": "#00f", "label": "Blue" }
        ],
        "set": [
          { "attribute": "style", "value": "color: {attributes.customColor.value}" },
          { "attribute": "data-color", "value": "{attributes.customColor.label}" },
          { "attribute": "class", "value": "has-custom-color" }
        ]
      }
    ]
  }
}

Ciblez un bloc ou des milliers

Ciblez un nom tel que "core/paragraph", un tableau de noms ou un espace de noms entier avec "core/*".

Plusieurs extensions JSON peuvent cibler le même bloc. La priorité définit leur ordre dans l’inspecteur.

Une liste exclude de premier niveau ignore les blocs qui correspondraient à name, selon la même correspondance exacte ou par joker. Un bloc exclu ne reçoit ni les champs ni leur sortie.

extend-animation.json
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ]
      }
    ]
  }
}

Exclure des blocs

Ignorer des blocs individuels ou des préfixes entiers qu’un joker ferait autrement correspondre.

Valeurs concaténées

Écrire toutes les valeurs sélectionnées d’un champ multivaleur dans un seul attribut.

Champ d’attributs

Un champ d’attributs ajoute ses paires nom-valeur au bloc sans règle de définition.

Inspecter depuis PHP

bs_block_extension_fields() renvoie les champs que chaque extension correspondante ajoute à un bloc, y compris les blocs du cœur et ceux de tiers.

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