Przejdź do treści

Dodaj pola do dowolnego bloku

Czyste JSON. Bez szablonów i funkcji renderujących.

Własne pola, zero szablonów

Utwórz plik JSON, wskaż blok za pomocą name i zdefiniuj pola. set mapuje wartości na klasy, style, atrybuty danych lub dowolne inne atrybuty HTML.

Blockstudio stosuje wynik za pomocą procesora znaczników WordPress HTML. Bez szablonów i funkcji renderujących.

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

Dowolny blok docelowy

Rozszerz pojedynczy blok, listę lub całą przestrzeń nazw za pomocą symbolu wieloznacznego.

Właściwość set

Mapuj pola na klasy, style, atrybuty danych lub dowolne atrybuty HTML.

Pola warunkowe

Wyświetlaj pola zależnie od innych wartości, używając logiki znanej z bloków.

Pełen zestaw funkcji

Wszystkie typy pól, logika warunkowa, źródła danych i właściwości.

Położenie w inspektorze

Umieszczaj pola na kartach ustawień, stylów lub zaawansowanych.

Kolejność według priorytetu

Ustal kolejność wielu rozszerzeń wskazujących ten sam blok.

Bez funkcji renderujących

HTML automatycznie stosuje wynik za pomocą procesora znaczników.

JSON Schema

Uzupełnianie kodu i walidacja z użyciem dedykowanego schematu.

Mapuj wartości na HTML za pomocą set

set mapuje wartości na klasy, style w tekście, atrybuty danych lub dowolne atrybuty HTML przy użyciu notacji kropkowej, takiej jak {attributes.fieldId}.

Uzyskuj dostęp do zagnieżdżonych wartości obiektów, stosuj je warunkowo lub wyświetlaj jedno pole w wielu atrybutach.

Pole zwracające kilka wartości stosuje set do każdej z nich. Klasy i style są łączone; w przypadku każdego innego atrybutu "join": true zapisuje wszystkie wartości oddzielone spacjami, zamiast zachowywać tylko ostatnią.

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

Wskaż jeden blok lub tysiące

Wskaż jedną nazwę, taką jak "core/paragraph", tablicę nazw lub całą przestrzeń nazw za pomocą "core/*".

Wiele rozszerzeń JSON może wskazywać ten sam blok. Priorytet określa ich kolejność w inspektorze.

Lista exclude na najwyższym poziomie pomija bloki pasujące do name, stosując to samo dopasowanie dokładne i z symbolami wieloznacznymi. Wykluczony blok nie otrzymuje ani pól, ani ich wyników.

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

Wyklucz bloki

Pomiń pojedyncze bloki lub całe prefiksy, które w przeciwnym razie pasowałyby do wzorca wieloznacznego.

Łączenie wartości

Zapisz każdą wybraną wartość pola wielowartościowego w jednym atrybucie.

Pole atrybutów

Pole atrybutów zapisuje pary nazw i wartości w bloku bez reguły ustawiania.

Sprawdzaj z poziomu PHP

bs_block_extension_fields() zwraca pola dodawane do bloku przez każde pasujące rozszerzenie, w tym bloki podstawowe i innych firm.

Plus

Oficjalny zestaw rozszerzeń

Wysokiej jakości szablony witryn, systemowe instrukcje AI i prywatna społeczność Discord. Jednorazowy zakup, dożywotnie aktualizacje.

  • 500+ szablonów stron
  • Instrukcje systemowe AI
  • Dożywotnie aktualizacje
  • Prywatna społeczność Discord