Pereiti prie turinio

Pasirinktiniai blokai 3 failuose

Nereikia JavaScript, kompiliavimo žingsnio ar paruoštinio kodo.

Apibrėžkite laukus sistemoje JSON

Pridėkite blockstudio raktą į block.json. Apibrėžkite atributus naudodami tokius tipus kaip text, toggle ir color. Blockstudio automatiškai sugeneruoja redaktoriaus UI su 27 laukų tipų – nuo teksto įvesties laukų iki kartotuvų ir kodo redaktorių – taip pat jūsų pačių užregistruotais laukų tipais.

Visapusiškas JSON schemų palaikymas suteikia automatinį kodo užbaigimą ir tikrinimą aplinkose VS Code, PhpStorm ir bet kuriame suderinamame redaktoriuje.

Kiekvienam laukui galima nustatyti default naujiems blokams ir fallback, kurią šablonas gauna, kai laukas tuščias.

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

Trijų failų eiga

block.json laukams, šablonas žymėjimui ir pasirinktinai stiliaus lentelė.

React sistemoje PHP

RichText, InnerBlocks ir useBlockProps veikia tiesiogiai aplinkose PHP, Twig arba Blade.

SCSS ir Tailwind

Naudokite CSS, SCSS arba Tailwind. SCSS palaiko importavimo kelius ir bendrą išankstinį kodą, o redaguojant įdėtinį dalinį failą iš naujo sukompiliuojami visi jį importuojantys failai.

27 laukų tipų

Tekstas, spalva, vaizdas, pasikartojanti sritis, pasirinkimas, kodo redaktorius ir daugiau – konfigūruojama sistemoje JSON.

JSON Schema

Automatinis kodo užbaigimas ir tikrinimas aplinkose VS Code, PhpStorm bei suderinamuose redaktoriuose.

Trys šablonų kalbos

PHP, Twig ir Blade naudoja tuos pačius kintamuosius ir komponentus.

npm importavimas

Importuokite paketus į script.js; gamybinėje aplinkoje jie bus vietiniai, o redaktoriuje paremti CDN.

Interactivity API

Vienu nustatymu įjunkite WordPress Interactivity API.

React komponentai PHP šablonuose

Naudokite <RichText /> tiesioginiam redagavimui ir statinei sąsajos HTML, <InnerBlocks /> – įdėtiniams blokams, o useBlockProps – apvalkalui; viskas telpa viename šablone.

Redaktoriuje jie tampa tikrais React komponentais. Sąsajoje jie atvaizduojami kaip serverio pusėje sugeneruoti HTML, lankytojams nepateikiant jokio 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>

Rašykite naudodami PHP, Twig arba Blade

Naudokite jums žinomą šablonų kalbą. PHP veikia iškart, Twig veikia įdiegus Timber, o Blade veikia su illuminate/view nuo 8 iki 12 per Blockstudio\Blade_Renderer. Kintamieji, komponentai ir veikimas išlieka tokie patys.

$a (atributai), $b (blokas), $c (kontekstas) ir $innerBlocks pasiekiami visomis kalbomis.

Twig šablonai taip pat gauna visą Timber kontekstą. Blade atvaizduoja ir puslapius, šablonų rinkinius bei svetainės rengyklės šablonus. Senesnė jenssegers/blade apvalkalo funkcija neveikia su illuminate/view 10 ir naujesnėmis versijomis, todėl vietoj jos naudokite 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>

Sąlyginė logika ir dinaminės parinktys

Rodykite ir slėpkite laukus naudodami operatorius, įskaitant ==, !=, includes, empty ir palyginimus. Sąlygas derinkite naudodami ARBA logiką.

Parinktys gali priklausyti nuo kito lauko. Įtraukite {attributes.post_type.value} į užpildymo argumentus, ir sąrašas bus įkeltas iš naujo, kai tas laukas pasikeis. Pridėkite fetch: true, kad įrašų paieška vyktų redaktoriui rašant.

Bendrą parinkčių sąrašą blokams naudokite su type: custom ir filtru blockstudio/blocks/attributes/populate, o savo globalias sąlygas, pavyzdžiui, pirkimo patikrą, registruokite per 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" }
        ]]
      }
    ]
  }
}

Tvarkomi pasikartojantys laukai

Nustatykite min ir max, pradėkite naujus blokus nuo default eilučių, o esamas eilutes sutraukite naudodami minimized. textMinimized sutrauktai eilutei suteikia vieno iš jos laukų, pavyzdžiui, pavadinimo, žymą.

Eilutėse galima naudoti visų tipų laukus, išskyrus skirtukus, įskaitant įdėtinius pasikartojančius laukus. Eilutės sąlyga tikrina už jos ribų esantį lauką naudodama "context": "main", o <RichText /> ir <MediaPlaceholder /> redaguoja vieną eilutę, kai jų attribute nurodo į 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" }
        ]
      }
    ]
  }
}

Pakartotinai naudojami laukų rinkiniai

Apibrėžkite laukų grupę vieną kartą field.json, o tada įtraukite ją į bet kurį bloką naudodami "type": "custom/cta". Laukai įterpiami tiesiogiai, todėl šablonai juos nuskaito kaip bet kurį kitą atributą.

Tą patį rinkinį naudokite dukart su idStructure, pavyzdžiui, hero_{id}, o kiekviename bloke keiskite žymas, numatytąsias reikšmes ar sąlygas naudodami overrides. block lauko tipas tą patį atlieka su visu bloku: įterpia jo laukus tiesiogiai ir pateikia atvaizduotą 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 moduliai be kompiliavimo žingsnio

Pridėkite script.js – jis įkeliamas kaip ES modulis. Importuokite npm paketus naudodami prefiksą npm:, o Blockstudio atsisiunčia juos vietoje gamybinei aplinkai.

Redaktoriuje iškart matoma peržiūra, o sąsajoje naudojami vietiniai moduliai be išorinių priklausomybių; jie įtraukiami į eilę tik vieną kartą.

Stiliaus failai importuojami taip pat. import "npm:swiper@11.0.0/swiper.min.css" atsisiunčia failą ir įtraukia jį į eilę po vieną kartą kiekvienai versijai, net jei jį naudoja keli blokai.

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

Blokų žymos ne tik šablonams

Susiekite trumpą prefiksą su vardų sritimi faile blockstudio.json arba vieną žymą su vienu bloku naudodami alternatyvų filtrą, ir <acme-card> atvaizduos acme/card. Įjunkite blockTags.enabled, kad žymos būtų atvaizduojamos įrašų turinyje ir valdikliuose, taikant allow ir deny šablonų apribojimus.

data-* atributai pasiekia pagrindinį bloko elementą, o html-* atributai jį pasiekia be prefikso. Pridėkite savo žymų kūrimo funkcijas naudodami blockstudio/block_tags/builders, o trumpinius perrašykite portabiliu <bs:acme-card> formatu naudodami komandą migrate-block-tags.

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

Pasirinktiniai laukų tipai

Užregistruokite savo lauko valdiklį ir naudokite jį kaip integruotą lauką.

Blokų salos

Podėlyje išsaugokite visą puslapį, o lankytojo užklausos metu atvaizduokite vieną bloką.

Sąlyginė registracija

Registruokite bloką tik tam tikro tipo įrašams, naudotojo vaidmeniui ar kitai globaliai sąlygai arba praleiskite jį, jei trūksta reikalingo papildinio ar jo versijos.

Įrašo metaduomenys ir parinktys

Saugokite reikšmes įrašo metaduomenyse arba parinktyse greta bloko atributų.

Sąlyginė logika

Rodykite laukus pagal reikšmes, naudodami lygybės, įtraukimo, tuštumo ir palyginimo sąlygas.

Dinaminis pasirinkimų pildymas

Pildykite pasirinkimus įrašais, naudotojais, terminais, funkcijomis ar API.

Perrašymai

Bendro bloko pavadinimui nustatykite override: true, kad atributai būtų sujungti pagal ID, ištekliai pakeisti failais tais pačiais pavadinimais, o šablonas pakeistas. Twig šablonai gali pakeisti atskirus blokus naudodami extends.

Variacijos

Aprašykite variantus block.json, kad jie iš anksto nustatytų laukų reikšmes, o juos valdantį lauką paslėpkite naudodami hidden.

Komponentai

Blokui, kuris atvaizduojamas tik iš PHP arba blokų žymų, nustatykite component: true. Jis išsaugo laukus, šablonus, išteklius ir Tailwind, bet niekada nerodomas įterpimo įrankyje.

InnerBlocks taisyklės

Leiskite blokus su namespace/*, category: ir @theme žymomis, perjunkite vidinį šabloną pasirinkdami parinktį ir pašalinkite apvalkalą svetainės išorinėje dalyje naudodami filtrą.

Kodo lauko ištekliai

Kodo laukas su asset: true paverčia rengyklės įvestį to bloko CSS, SCSS arba JavaScript ištekliais, o %selector% pritaiko juos konkrečiam egzemplioriui.

Ištekliai pagal failo pavadinimą

*.view.js įkeliamas tik svetainės išorinėje dalyje, o prefiksai global-, admin- ir block-editor- įkelia failą kiekviename puslapyje, wp-admin arba blokų rengyklėje.

Piktogramos ir blokų aplankai

Suteikite blokui pasirinktinę SVG arba HTML piktogramą, pakeiskite paieškos vietą naudodami blockstudio/path filtrą ir pridėkite aplankų naudodami Blockstudio\Build::init().

ACF ir Meta Box reikšmės

Šablonai gauna $post_id, todėl get_field() ir rwmb_get_value() nuskaito redaguojamą įrašą, o refreshOn po išsaugojimo atnaujina peržiūrą.

Užklausos ciklo kontekstas

Užklausos cikle $block[‘context’][‘postId’] seka dabartinį elementą, o $block[‘postId’] lieka peržiūrimo įrašo ID.

WPML

wp bs wpml config įrašo wpml-config.xml, kuriuo pažymimi verčiami teksto laukai, o laukuose saugomi vaizdai įtraukiami į WPML vertimo užduotis kartu su alternatyviaisiais tekstais ir antraštėmis.

Plus

Oficialus plėtinių rinkinys

Aukščiausios klasės svetainių šablonai, DI sistemos instrukcijos ir privati Discord bendruomenė. Vienkartinis pirkimas, atnaujinimai visam laikui.

  • 500+ svetainių šablonų
  • AI sistemos instrukcijos
  • Naujiniai visam laikui
  • Privati Discord bendruomenė