Liigu sisu juurde

Kohandatud plokid 3 failis

Pole vaja JavaScript-i, ehitusetappi ega algkoodi.

Määrake väljad failis JSON

Lisage blockstudio-võti faili block.json. Määratlege atribuudid tüüpidega, näiteks text, toggle ja color. Blockstudio loob redaktori UI automaatselt, pakkudes 27 väljatüüpe alates tekstisisestusväljadest kuni kordajate ja koodiredaktoritni, ning ka teie enda registreeritud väljatüüpe.

Täielik JSON skeemide tugi pakub automaatset lõpetamist ja valideerimist keskkondades VS Code, PhpStorm ja kõigis ühilduvates redaktorites.

Iga väli saab määrata uute plokkide jaoks default-i ning fallback-i, mille mall saab siis, kui väli on tühi.

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

Kolme faili töövoog

block.json väljade jaoks, mall märgistuse jaoks ja valikuline laaditabel.

React keskkonnas PHP

RichText, InnerBlocks ja useBlockProps töötavad otse keeltes PHP, Twig või Blade.

SCSS ja Tailwind

Kasuta CSS, SCSS või Tailwind. SCSS toetab imporditeid ja jagatud eelsisu ning pesastatud osafaili muutmisel kompileeritakse uuesti kõik seda importivad failid.

27 väljatüüpi

Tekst, värv, pilt, kordaja, valik, koodiredaktor ja palju muud – seadistage need failis JSON.

JSON Schema

Automaatne lõpetamine ja valideerimine keskkondades VS Code, PhpStorm ja ühilduvates redaktorites.

Kolm mallikeelt

PHP, Twig ja Blade kasutavad samu muutujaid ja komponente.

npm impordid

Importige paketid keskkonda script.js; tootmises laaditakse need kohalikult ja redaktoris kasutavad need CDN-i.

Interactivity API

Lülitage WordPress Interactivity API ühe lipuga sisse.

React komponendid PHP mallides

Kasutage tekstisisesteks muudatusteks ja staatilise esiotsa HTML jaoks <RichText />-i, alamplokkide jaoks <InnerBlocks />-i ning ümbrisploki jaoks useBlockProps-i – kõik ühes mallis.

Redaktoris muutuvad need päris React komponentideks. Esiotsas renderdatakse need serveris HTML-ina, nii et külastajatele ei saadeta JavaScript-i.

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>

Kirjutage keeles PHP, Twig või Blade

Kasutage endale tuttavat mallikeelt. PHP töötab kohe, Twig käivitub pärast Timber paigaldamist ning Blade töötab illuminate/view versioonides 8 kuni 12 Blockstudio\Blade_Renderer kaudu. Muutujad, komponendid ja käitumine jäävad samaks.

Kõigis keeltes on saadaval $a (atribuudid), $b (plokk), $c (kontekst) ja $innerBlocks.

Twig mallid saavad samuti kogu Timber konteksti. Blade renderdab ka lehti, mustreid ja saidiredaktori malle. Vanem jenssegers/blade ümbris ei tööta versiooniga illuminate/view 10 ega uuematega, seega kasuta selle asemel 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>

Tingimusloogika ja dünaamilised valikud

Kuvage ja peitke välju operaatoritega, sealhulgas ==, !=, includes, empty ja võrdlustega. Ühendage tingimused VÕI-loogikaga.

Valikud võivad sõltuda teisest väljast. Lisa {attributes.post_type.value} täitmise argumentidesse ja loend laaditakse uuesti, kui see väli muutub. Lisa fetch: true, et otsida postitusi samal ajal, kui redaktor teksti sisestab.

Jaga plokkide vahel üht valikuloendit type: custom ja filtriga blockstudio/blocks/attributes/populate ning registreeri oma globaalsed tingimused, näiteks ostu kontroll, blockstudio/blocks/conditions kaudu.

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

Hallatavad kordajad

Määra min ja max, alusta uusi plokke default reaga ning ahenda olemasolevad read minimized abil. textMinimized lisab ahendatud reale selle ühe välja väärtuse, näiteks nime.

Read toetavad kõiki väljatüüpe peale vahekaartide, sealhulgas pesastatud kordajaid. Rea sees olev tingimus kontrollib sellest väljaspool asuvat välja "context": "main" abil ning <RichText /> ja <MediaPlaceholder /> muudavad üht rida, kui nende attribute osutab väärtusele 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" }
        ]
      }
    ]
  }
}

Taaskasutatavad väljakomplektid

Määra väljade rühm üks kord field.json-is ja viita sellele mis tahes plokist "type": "custom/cta" abil. Väljad lisatakse ploki sisse, nii et mallid käsitlevad neid nagu mis tahes muud atribuuti.

Kasuta sama komplekti kaks korda koos idStructure-iga, näiteks hero_{id}, ning muuda plokipõhiselt silte, vaikeväärtusi või tingimusi overrides abil. Väljatüüp block teeb sama terve plokiga: see lisab selle ploki väljad otse sisse ja tagastab renderdatud 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" }
  ]
}

ES-moodulid ilma ehitusetapita

Lisage script.js ja see laaditakse ES-moodulina. Importige npm paketid eesliitega npm: ning Blockstudio laadib need tootmiskeskkonna jaoks kohalikult alla.

Redaktoris kuvatakse kohe eelvaade, samal ajal kui esiots kasutab kohalikke mooduleid ilma väliste sõltuvusteta; need lisatakse järjekorda ainult üks kord.

Laaditabelid imporditakse samamoodi. import "npm:swiper@11.0.0/swiper.min.css" laadib faili alla ja lisab selle järjekorda versiooni kohta üks kord, isegi kui seda kasutavad mitu plokki.

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

Plokisildid ka väljaspool malle

Vasta lühikese eesliitega nimeruumile failis blockstudio.json või seo üks silt ühe plokiga aliasfiltri abil; <acme-card> renderdab acme/card. Luba blockTags.enabled, et renderdada silte postituste sisus ja vidinates; seda piiravad mustrid allow ja deny.

data-* atribuudid jõuavad ploki juurelemendini ning html-* atribuudid jõuavad sinna ilma eesliiteta. Lisa oma sildikoostajad blockstudio/block_tags/builders abil ja kirjuta lühivormid teisaldatavasse kirjapilti <bs:acme-card> käsuga migrate-block-tags.

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

Kohandatud väljatüübid

Registreerige oma välja juhtelement ja kasutage seda nagu sisseehitatud välja.

Plokisaared

Salvestage vahemällu terve leht ja renderdage külastaja päringu ajal üks plokk.

Tingimuslik registreerimine

Registreeri plokk ainult kindla postitusetüübi, kasutajarolli või muu globaalse tingimuse korral või jäta see vahele, kui vajalik plugin või selle versioon puudub.

Postituse metaandmed ja valikud

Salvestage väärtused postituse metaandmetesse või valikutesse koos ploki atribuutidega.

Tingimusloogika

Kuvage väärtustel põhinevaid välju võrdsuse, kuuluvuse, tühjuse ja võrdluste järgi.

Dünaamilised valikud

Täitke valikud postituste, kasutajate, terminite, funktsioonide või API-de andmetega.

Ülekirjutused

Määra jagatud ploki nime juures override: true, et ühendada atribuudid ID järgi, asendada sama failinimega varad ja vahetada mall. Twig mallid saavad üksikuid plokke laiendada märksõnaga extends.

Variandid

Määra variatsioonid failis block.json, et väljade väärtused eelseadistada, ja peida neid juhtiv väli märksõnaga hidden.

Komponendid

Määra ploki juures component: true, kui see renderdatakse ainult väärtusest PHP või plokisiltidest. Nii säilivad väljad, mallid, varad ja Tailwind, kuid plokki ei kuvata lisajas.

InnerBlocksi reeglid

Luba plokid märgenditega namespace/*, category: ja @theme, vaheta sisemalli valikloendi valikuga ja eemalda eesliidese ümbris veebilehel filtri abil.

Koodivälja varad

Varaga koodiväli (asset: true) muudab redaktori sisendi selle ploki CSS-iks, SCSS-iks või JavaScript-iks ning piiritleb selle eksemplariga %selector% abil.

Varad failinime järgi

*.view.js laaditakse ainult veebilehel; eesliited global-, admin- ja block-editor- laadivad faili igal lehel, wp-admin-is või plokiredaktoris.

Ikoonid ja plokikaustad

Lisa plokile kohandatud SVG- või HTML-ikoon, muuda avastamise asukohta filtri blockstudio/path abil ning lisa kaustu Blockstudio\Build::init() abil.

ACF ja Meta Box väärtused

Mallid saavad $post_id, nii et get_field() ja rwmb_get_value() loevad muudetud postitust ning refreshOn värskendab eelvaadet pärast salvestamist.

Query Loopi kontekst

Query Loopi sees järgib $block[‘context’][‘postId’] parajasti aktiivset üksust, samas kui $block[‘postId’] jääb vaadatavaks postituseks.

WPML

wp bs wpml config kirjutab faili wpml-config.xml, mis märgib tekstiväljad tõlgitavaks; väljadesse salvestatud pildid lisatakse koos alternatiivtekstide ja pealdistega WPML tõlketöödesse.

Plus

Ametlik laienduskomplekt

Esmaklassilised saidimallid, tehisintellekti süsteemijuhised ja privaatne Discord kogukond. Ühekordne ost, eluaegsed uuendused.

  • 500+ saidimalli
  • Tehisintellekti süsteemijuhised
  • Eluaegsed uuendused
  • Privaatne Discord-i kogukond