Preskoči na vsebino

Bloki po meri v 3 datotekah

Brez JavaScript, brez koraka gradnje, brez šablonske kode.

Določite polja v JSON

Dodajte ključ blockstudio v block.json. Določite atribute s tipi, kot so text, toggle in color. Blockstudio samodejno ustvari urejevalnik UI z vrstami polj 27, od besedilnih vnosnih polj do ponavljalnikov in urejevalnikov kode, ter z vrstami polj, ki jih registrirate sami.

Popolna podpora za shemo JSON omogoča samodokončanje in preverjanje v VS Code, PhpStorm in vseh združljivih urejevalnikih.

Vsako polje lahko določi default za nove bloke in fallback, ki ga predloga prejme, ko je polje prazno.

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

Potek dela s 3 datotekami

block.json za polja, predloga za označevalni jezik in izbirna slogovna datoteka.

React v PHP

RichText, InnerBlocks in useBlockProps delujejo neposredno v PHP, Twig ali Blade.

SCSS in Tailwind

Uporabite CSS, SCSS ali Tailwind. SCSS podpira uvozne poti in skupno uvodno kodo, urejanje ugnezdenega delnega predloga pa znova prevede vse datoteke, ki ga uvažajo.

27 vrst polj

Besedilo, barva, slika, ponavljalnik, izbirno polje, urejevalnik kode in še več, nastavljeno v JSON.

JSON Schema

Samodokončanje in preverjanje v VS Code, PhpStorm in združljivih urejevalnikih.

Trije jeziki predlog

PHP, Twig in Blade uporabljajo iste spremenljivke in komponente.

Uvozi npm

Uvažajte pakete v script.js; v produkciji lokalno, v urejevalniku pa temelji na CDN.

Interactivity API

Z eno zastavico omogočite WordPress za interaktivnost API.

Komponente React v predlogah PHP

Uporabite <RichText /> za sprotno urejanje in statični uporabniški vmesnik HTML, <InnerBlocks /> za podrejene bloke in useBlockProps za ovoj, vse v eni predlogi.

V urejevalniku postanejo prave komponente React. Na uporabniškem vmesniku se izrišejo kot strežniški HTML, obiskovalcem pa se ne pošlje noben JavaScript.

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>

Pišite v PHP, Twig ali Blade

Uporabite jezik predlog, ki ga poznate. PHP deluje takoj, Twig pa se zažene, ko namestite Timber; Blade se izvaja na illuminate/view 8 do 12 prek Blockstudio\Blade_Renderer. Spremenljivke, komponente in vedenje ostanejo enaki.

$a (atributi), $b (blok), $c (kontekst) in $innerBlocks so na voljo v vseh jezikih.

Twig predloge prejmejo tudi celoten kontekst Timber. Blade izrisuje tudi strani, vzorce in predloge urejevalnika spletnega mesta. Starejši ovoj jenssegers/blade ne deluje z različico illuminate/view 10 in novejšimi, zato namesto njega uporabite Blade_Renderer.

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>

Pogojna logika in dinamične možnosti

Polja prikažite ali skrijte z operatorji, kot so ==, !=, includes, empty in primerjave. Pogoje združite z logičnim ALI.

Možnosti so lahko odvisne od drugega polja. Dodajte {attributes.post_type.value} med argumente za polnjenje in seznam se znova naloži, ko se to polje spremeni. Dodajte fetch: true za iskanje objav med tipkanjem urednika.

En seznam možnosti lahko delite med bloki z uporabo type: custom in filtra blockstudio/blocks/attributes/populate, lastne globalne pogoje, na primer preverjanje nakupa, pa registrirate prek blockstudio/blocks/conditions.

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

Pregledno upravljanje ponavljalnikov

Nastavite min in max, nove bloke začnite z default vrsticami, obstoječe pa strnite z minimized. textMinimized označi strnjeno vrstico z enim od njenih polj, na primer z imenom.

Vrstice podpirajo vse vrste polj, razen zavihkov, vključno z ugnezdenimi ponavljalniki. Pogoj znotraj vrstice lahko preverja polje zunaj nje z "context": "main", <RichText /> in <MediaPlaceholder /> pa urejata posamezno vrstico, kadar njun attribute kaže na repeaterId[index].fieldId.

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

Nabori polj za ponovno uporabo

Skupino polj enkrat določite v field.json in se nanjo sklicujte iz poljubnega bloka z "type": "custom/cta". Polja so vstavljena neposredno, zato jih predloge berejo kot kateri koli drug atribut.

Isti nabor uporabite dvakrat z idStructure, na primer hero_{id}, oznake, privzete vrednosti ali pogoje pa prilagodite za vsak blok z overrides. Vrsta polja block naredi enako za celoten blok: vstavi polja tega bloka in vrne njegov izrisani HTML.

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

Moduli ES brez koraka gradnje

Dodajte script.js in naloži se kot modul ES. Uvozite pakete npm s predpono npm:, Blockstudio pa jih za produkcijo prenese lokalno.

Urejevalnik takoj prikaže predogled, uporabniški vmesnik pa uporablja lokalne module brez zunanjih odvisnosti, ki se vključijo samo enkrat.

Tudi slogovne liste lahko uvozite na enak način. import "npm:swiper@11.0.0/swiper.min.css" prenese datoteko in jo doda v čakalno vrsto enkrat za vsako različico, tudi kadar jo uporablja več blokov.

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,
  });
}

Oznake blokov tudi zunaj predlog

V blockstudio.json preslikajte kratko predpono v imenski prostor ali z aliasnim filtrom povežite eno oznako z enim blokom; <acme-card> nato izrisuje acme/card. Vklopite blockTags.enabled za izris oznak v vsebini objav in gradnikih, omejen z vzorci allow in deny.

Atributi data-* dosežejo korenski element bloka, atributi html-* pa prispejo tja brez predpone. Dodajte lastne gradnike oznak z blockstudio/block_tags/builders in prepišite okrajšave v prenosljivo obliko <bs:acme-card> z ukazom migrate-block-tags.

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

Vrste polj po meri

Registrirajte svoj kontrolnik polja in ga uporabljajte kot vgrajeno polje.

Otočki blokov

Predpomnite celotno stran in en blok izrišite ob zahtevi obiskovalca.

Pogojna registracija

Blok registrirajte samo za določeno vrsto objave, uporabniško vlogo ali drug globalni pogoj oziroma preskočite registracijo, če manjka potreben vtičnik ali njegova zahtevana različica.

Metapodatki objave in možnosti

Vrednosti shranite v metapodatke objave ali možnosti ob atributih bloka.

Pogojna logika

Polja prikažite glede na vrednosti s preverjanjem enakosti, vključenosti, praznosti in primerjav.

Dinamično polnjenje

Možnosti napolnite z objavami, uporabniki, izrazi, funkcijami ali API-ji.

Preglasitve

Za skupni blok nastavite override: true, da združite atribute po ID-ju, zamenjate sredstva z enakimi imeni datotek in zamenjate predlogo. Predloge Twig lahko preglasijo posamezne bloke z extends.

Različice

V block.json določite različice, ki vnaprej nastavijo vrednosti polj, in z hidden skrijte polje, ki jih upravlja.

Komponente

Za blok, ki se izrisuje samo iz PHP ali oznak blokov, nastavite component: true. Ohranijo se polja, predloge, sredstva in Tailwind, vendar se blok nikoli ne prikaže v vstavljalniku.

Pravila za InnerBlocks

Dovolite bloke z žetoni namespace/*, category: in @theme, z možnostjo v izbirnem polju zamenjajte notranjo predlogo, na sprednjem delu pa z odjemalcem odstranite ovoj.

Sredstva polj kode

Polje kode z asset: true spremeni uporabnikov vnos v urejevalniku v CSS, SCSS ali JavaScript za ta blok; obseg na posamezno instanco določa %selector%.

Sredstva po imenu datoteke

*.view.js se naloži samo na sprednjem delu, predpone global-, admin- in block-editor- pa naložijo datoteko na vsaki strani, v wp-admin oziroma v urejevalniku blokov.

Ikone in mape blokov

Bloku dodelite ikono SVG po meri ali ikono HTML, z filtrom blockstudio/path spremenite mesto iskanja, mape pa dodajte z Blockstudio\Build::init().

Vrednosti ACF in Meta Box

Predloge prejmejo $post_id, zato get_field() in rwmb_get_value() bereta urejano objavo, refreshOn pa po shranjevanju osveži predogled.

Kontekst zanke poizvedbe

V zanki poizvedbe $block[‘context’][‘postId’] sledi trenutnemu elementu, medtem ko $block[‘postId’] ostane ID objave, ki si jo ogledujete.

WPML

Ukaz wp bs wpml config zapiše wpml-config.xml, ki označuje besedilna polja kot prevedljiva, slike, shranjene v poljih, pa se z alternativnimi besedili in napisi vključijo v prevajalska opravila za WPML.

Plus

Uradni komplet razširitev

Vrhunske predloge spletnih mest, sistemska navodila za UI in zasebna skupnost Discord. Enkratni nakup, posodobitve za vedno.

  • Več kot 500+ predlog spletnih mest
  • Sistemska navodila za UI
  • Doživljenjske posodobitve
  • Zasebna skupnost Discord