Siirry sisältöön

Mukautetut lohkot 3 tiedostossa

Ei JavaScript:tä, koontivaihetta tai mallikoodia.

Määritä kentät JSON-tiedostossa

Lisää blockstudio-avain kohteeseen block.json. Määritä attribuutit tyypeillä, kuten text, toggle ja color. Blockstudio luo editorin UI automaattisesti. Se sisältää 27 kenttätyyppiä tekstikentistä toistimiin ja koodieditoreihin sekä itse rekisteröimiäsi kenttätyyppejä.

Täysi JSON-skeematuki tarjoaa automaattisen täydennyksen ja tarkistuksen palveluissa VS Code ja PhpStorm sekä kaikissa yhteensopivissa editoreissa.

Jokainen kenttä voi määrittää default-arvon uusille lohkoille ja fallback-arvon, jonka malli saa kentän ollessa tyhjä.

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

Kolmen tiedoston työnkulku

block.json kenttiä varten, mallipohja merkintäkieltä varten ja valinnainen tyylitiedosto.

React kohteessa PHP

RichText, InnerBlocks ja useBlockProps toimivat suoraan kohteissa PHP, Twig tai Blade.

SCSS ja Tailwind

Käytä CSS- tai SCSS-määritystä tai Tailwind-määritystä. SCSS tukee tuontipolkuja ja yhteistä alkumääritystä, ja sisäkkäisen osan muokkaaminen kääntää uudelleen kaikki sitä tuovat tiedostot.

27 kenttätyyppiä

Teksti, väri, kuva, toistin, valinta, koodieditori ja paljon muuta määritetään kohteessa JSON.

JSON Schema

Automaattinen täydennys ja tarkistus palveluissa VS Code ja PhpStorm sekä yhteensopivissa editoreissa.

Kolme mallipohjakieltä

PHP, Twig ja Blade käyttävät samoja muuttujia ja komponentteja.

npm-tuonnit

Tuo paketteja kohteessa script.js. Tuotannossa ne ovat paikallisia, ja editorissa ne toimitetaan CDN-palvelun kautta.

Interactivity API

Ota WordPress Interactivity API käyttöön yhdellä lipulla.

React-komponentit PHP-mallipohjissa

Käytä <RichText />-toimintoa tekstin muokkaamiseen ja staattiseen käyttöliittymän HTML-toimintoon, <InnerBlocks />-toimintoa sisäkkäisiin lohkoihin ja useBlockProps-toimintoa ympäröivään rakenteeseen. Kaikki yhdessä mallipohjassa.

Editorissa näistä tulee oikeita React-komponentteja. Käyttöliittymässä ne renderöidään palvelimella HTML-elementeiksi, eikä kävijöille toimiteta JavaScript-tiedostoja.

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>

Kirjoita kielellä PHP, Twig tai Blade

Käytä tuntemaasi mallikieltä. PHP toimii heti käyttövalmiina, Twig toimii, kun Timber on asennettu, ja Blade toimii illuminate/view-versioilla 8–12 Blockstudio\Blade_Renderer-määrityksen kautta. Muuttujat, komponentit ja toiminta pysyvät samoina.

$a (ominaisuudet), $b (lohko), $c (konteksti) ja $innerBlocks ovat käytettävissä kaikilla kielillä.

Twig-mallit saavat myös koko Timber-kontekstin. Blade renderöi myös sivut, kuviot ja Sivustoeditorin mallit. Vanhempi jenssegers/blade-kääre ei toimi version illuminate/view 10 ja uudempien kanssa, joten käytä sen sijaan 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>

Ehdollinen logiikka ja dynaamiset vaihtoehdot

Näytä ja piilota kenttiä operaattoreilla ==, !=, includes ja empty sekä vertailuoperaattoreilla. Yhdistä ehtoja TAI-logiikalla.

Asetukset voivat riippua toisesta kentästä. Lisää {attributes.post_type.value} täyttöargumentteihin, niin luettelo latautuu uudelleen kentän muuttuessa. Lisää fetch: true, jotta julkaisuja haetaan editorin kirjoittaessa.

Jaa sama valintaluettelo lohkojen kesken type: custom-toiminnolla ja blockstudio/blocks/attributes/populate-suodattimella, ja rekisteröi omia yleisiä ehtoja, kuten ostotarkistus, käyttämällä 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" }
        ]]
      }
    ]
  }
}

Toistimet pysyvät hallittavina

Määritä min ja max, aloita uudet lohkot default-riveillä ja tiivistä olemassa olevat rivit komennolla minimized. textMinimized nimeää tiivistetyn rivin jollakin sen omista kentistä, kuten nimellä.

Riveillä voi käyttää kaikkia kenttätyyppejä välilehtiä lukuun ottamatta, myös sisäkkäisiä toistimia. Rivin sisäinen ehto tarkistaa rivin ulkopuolisen kentän arvon "context": "main"-toiminnolla, ja <RichText /> sekä <MediaPlaceholder /> muokkaavat yksittäistä riviä, kun niiden attribute osoittaa kohteeseen 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" }
        ]
      }
    ]
  }
}

Uudelleenkäytettävät kenttäjoukot

Määritä kenttäryhmä kerran field.json-määrityksessä ja viittaa siihen mistä tahansa lohkosta komennolla "type": "custom/cta". Kentät upotetaan suoraan, joten mallit lukevat niitä kuten mitä tahansa muuta attribuuttia.

Käytä samaa joukkoa kahdesti esimerkiksi idStructure-määrityksellä, kuten hero_{id}, ja muuta tunnisteita, oletusarvoja tai ehtoja lohkokohtaisesti komennolla overrides. Kenttätyyppi block tekee saman kokonaiselle lohkolle: se laajentaa lohkon kentät suoraan sisältöön ja palauttaa sen renderöidyn HTML-arvon.

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

ES-moduulit ilman koontivaihetta

Lisää script.js, niin se latautuu ES-moduulina. Tuo npm-paketteja etuliitteellä npm:, ja Blockstudio lataa ne paikallisesti tuotantokäyttöä varten.

Editorissa näet esikatselun heti, ja käyttöliittymä käyttää paikallisia moduuleja ilman ulkoisia riippuvuuksia. Moduulit otetaan käyttöön vain kerran.

Tyylitiedostot tuodaan samalla tavalla. import "npm:swiper@11.0.0/swiper.min.css" lataa tiedoston ja lisää sen jonoon kerran versiota kohden, vaikka useat lohkot käyttäisivät sitä.

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

Lohkotunnisteet mallien lisäksi

Yhdistä lyhyt etuliite nimiavaruuteen tiedostossa blockstudio.json tai yksi tunniste yhteen lohkoon aliassuodattimella, niin <acme-card> renderöi tunnisteen acme/card. Ota blockTags.enabled käyttöön, jotta tunnisteet renderöidään myös julkaisujen sisällössä ja vimpaimissa. Käyttöä rajaavat allow– ja deny-kuviot.

data-*-attribuutit siirtyvät lohkon juurielementtiin, ja html-*-attribuutit saapuvat sinne ilman etuliitettä. Lisää omia tunnisteiden muodostajia komennolla blockstudio/block_tags/builders ja muunna lyhenteet siirrettävään <bs:acme-card>-muotoon komennolla migrate-block-tags.

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

Mukautetut kenttätyypit

Rekisteröi oma kentän ohjauskomponentti ja käytä sitä sisäänrakennetun kentän tavoin.

Lohkosaarekkeet

Tallenna koko sivu välimuistiin ja renderöi yksi lohko kävijän pyynnön yhteydessä.

Ehdollinen rekisteröinti

Rekisteröi lohko vain tietylle julkaisutyypille, käyttäjäroolille tai muulle yleiselle ehdolle. Voit myös jättää sen rekisteröimättä, jos sen tarvitsema lisäosa tai lisäosan versio puuttuu.

Artikkelien metatiedot ja asetukset

Tallenna arvot artikkelien metatietoihin tai asetuksiin lohko-ominaisuuksien rinnalle.

Ehdollinen logiikka

Näytä kenttiä arvojen perusteella käyttämällä yhtäsuuruus-, sisältyvyys-, tyhjyys- ja vertailuehtoja.

Dynaamiset vaihtoehdot

Hae valintavaihtoehdot artikkeleista, käyttäjistä, termeistä, funktioista tai rajapinnoista.

Ohitukset

Aseta yhteisen lohkon nimen kohdalla override: true, niin attribuutit yhdistetään tunnisteen mukaan, resurssit korvataan samannimisillä tiedostoilla ja malli vaihdetaan. Twig-malleissa yksittäiset lohkot voi korvata extends-määrityksellä.

Muunnelmat

Määritä tiedostossa block.json muunnelmia, jotka asettavat kenttien arvot valmiiksi, ja piilota niitä ohjaava kenttä hidden-määrityksellä.

Komponentit

Aseta component: true lohkolle, joka renderöidään vain PHP-määrityksestä tai lohkotunnisteista. Se säilyttää kentät, mallit, resurssit ja Tailwind-määrityksen, mutta ei koskaan näy lisääjässä.

InnerBlocks-säännöt

Salli lohkot, joiden tunnisteina ovat namespace/*, category: ja @theme, vaihda sisämalli valintavaihtoehdolla ja poista kääre suodattimella käyttöliittymän puolelta.

Koodikentän resurssit

Koodikenttä, jonka asset: true -asetus on käytössä, muuntaa editorin syötteen lohkon CSS-, SCSS- tai JavaScript-muotoon. Rajaus tehdään esiintymän mukaan arvolla %selector%.

Resurssit tiedostonimen mukaan

*.view.js latautuu vain käyttöliittymän puolella. global-, admin- ja block-editor-etuliitteillä varustetut tiedostot latautuvat jokaisella sivulla, wp-adminissa tai lokoeditorissa.

Kuvakkeet ja lohkokansiot

Anna lohkolle mukautettu SVG- tai HTML-kuvake, muuta etsintäpolkua blockstudio/path-suodattimella ja lisää kansioita määrityksellä Blockstudio\Build::init().

ACF- ja Meta Box-arvot

Mallit saavat $post_id-arvon, joten get_field() ja rwmb_get_value() lukevat muokattua julkaisua, ja refreshOn päivittää esikatselun tallennuksen jälkeen.

Kyselysilmukan konteksti

Kyselysilmukan sisällä $block[‘context’][‘postId’] seuraa nykyistä kohdetta, kun taas $block[‘postId’] pysyy tarkasteltavan julkaisun tunnisteena.

WPML

wp bs wpml config kirjoittaa wpml-config.xml-määrityksen, joka merkitsee tekstikentät käännettäviksi. Kenttiin tallennetut kuvat lisätään myös WPML-käännöstöihin alt-teksteineen ja kuvateksteineen.

Plus

Virallinen laajennuspaketti

Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.

  • 500+ sivustomallia
  • Tekoälyn järjestelmäohjeet
  • Elinikäiset päivitykset
  • Yksityinen Discord-yhteisö