Pāriet uz saturu

Pielāgoti bloki 3 failos

Bez JavaScript, bez būvēšanas soļa un bez liekā pamatkoda.

Definējiet laukus failā JSON

Pievienojiet blockstudio atslēgu pie block.json. Definējiet atribūtus ar tādiem tipiem kā text, toggle un color. Blockstudio automātiski ģenerē redaktora UI ar 27 lauku tipiem — no teksta ievades laukiem līdz atkārtotājiem un koda redaktoriem —, kā arī jūsu reģistrētajiem lauku tipiem.

Pilns atbalsts JSON shēmām nodrošina automātisko pabeigšanu un validāciju VS Code, PhpStorm un visos saderīgos redaktoros.

Katram laukam var iestatīt default jauniem blokiem un fallback, ko saņem veidne, kamēr lauks ir tukšs.

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

Trīs failu darbplūsma

block.json laukiem, veidne marķējumam un neobligāta stila lapa.

React failā PHP

RichText, InnerBlocks un useBlockProps darbojas tieši PHP, Twig vai Blade.

SCSS un Tailwind

Izmantojiet CSS, SCSS vai Tailwind. SCSS atbalsta importēšanas ceļus un koplietojamu sākuma kodu, un, rediģējot ligzdotu daļveidni, tiek pārkompilēti visi faili, kas to importē.

27 lauku veidi

Teksts, krāsa, attēls, atkārtotājs, atlase, koda redaktors un vēl citas iespējas, kas konfigurētas failā JSON.

JSON Schema

Automātiskā pabeigšana un validācija VS Code, PhpStorm un saderīgos redaktoros.

Trīs veidņu valodas

PHP, Twig un Blade izmanto tos pašus mainīgos un komponentus.

npm importi

Importējiet pakotnes failā script.js; produkcijas vidē tās ir lokālas, bet redaktorā balstās uz CDN.

Interactivity API

Ieslēdziet WordPress Interactivity API ar vienu karodziņu.

React komponenti PHP veidnēs

Izmantojiet <RichText /> iekļautajai rediģēšanai un statiskās priekšpuses HTML, <InnerBlocks /> apakšblokiem un useBlockProps apvalkam — tas viss vienā veidnē.

Redaktorā tie kļūst par īstiem React komponentiem. Priekšpusē tie tiek renderēti kā servera puses HTML, bet apmeklētājiem netiek nosūtīts nekāds 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>

Rakstiet PHP, Twig vai Blade

Izmantojiet sev zināmo veidņu valodu. PHP darbojas uzreiz, Twig sāk darboties pēc Timber instalēšanas, bet Blade darbojas illuminate/view versijās no 8 līdz 12, izmantojot Blockstudio\Blade_Renderer. Mainīgie, komponenti un darbība paliek nemainīgi.

$a (atribūti), $b (bloks), $c (konteksts) un $innerBlocks ir pieejami visās valodās.

Twig veidnes saņem arī pilnu Timber kontekstu. Blade atveido arī lapas, rakstu paraugus un vietnes redaktora veidnes. Vecākais jenssegers/blade apvalks nedarbojas ar illuminate/view 10 un jaunākām versijām, tāpēc izmantojiet 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>

Nosacījumu loģika un dinamiskās opcijas

Rādiet vai paslēpiet laukus, izmantojot operatorus, tostarp ==, !=, includes, empty un salīdzinājumus. Apvienojiet nosacījumus ar VAI loģiku.

Opcijas var būt atkarīgas no cita lauka. Iekļaujiet {attributes.post_type.value} aizpildīšanas argumentos, un saraksts tiks ielādēts no jauna, kad šis lauks mainīsies. Pievienojiet fetch: true, lai meklētu ierakstus, kamēr redaktors raksta.

Koplietojiet vienu opciju sarakstu starp blokiem ar type: custom un filtru blockstudio/blocks/attributes/populate, kā arī reģistrējiet savus globālos nosacījumus, piemēram, pirkuma pārbaudi, izmantojot 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" }
        ]]
      }
    ]
  }
}

Pārvaldāmi atkārtotāji

Iestatiet min un max, sāciet jaunus blokus ar default rindām un sakļaujiet esošās rindas ar minimized. textMinimized sakļautajai rindai pievieno etiķeti no kāda tās lauka, piemēram, nosaukuma.

Rindās var izmantot visus lauku veidus, izņemot cilnes, tostarp ligzdotus atkārtotājus. Nosacījums rindā var pārbaudīt lauku ārpus tās, izmantojot "context": "main", bet <RichText /> un <MediaPlaceholder /> rediģē vienu rindu, ja to attribute norāda uz 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" }
        ]
      }
    ]
  }
}

Atkārtoti izmantojamas lauku kopas

Definējiet lauku grupu vienreiz field.json un atsaucieties uz to jebkurā blokā ar "type": "custom/cta". Lauki tiek ievietoti tieši blokā, tāpēc veidnes tos nolasa tāpat kā jebkuru citu atribūtu.

Izmantojiet to pašu kopu divreiz ar tādu idStructure kā hero_{id}, bet katrā blokā mainiet etiķetes, noklusējuma vērtības vai nosacījumus ar overrides. Lauka veids block dara to pašu ar visu bloku: tas ievieto šī bloka laukus tieši blokā un atgriež tā atveidoto 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 moduļi bez būvēšanas soļa

Pievienojiet script.js, un tas tiks ielādēts kā ES modulis. Importējiet npm pakotnes ar prefiksu npm:, un Blockstudio lejupielādēs tās lokāli produkcijas videi.

Redaktorā uzreiz pieejams priekšskatījums, bet priekšpuse izmanto lokālos moduļus bez ārējām atkarībām; tie tiek pievienoti rindā tikai vienu reizi.

Stilu lapas tiek importētas tāpat. import "npm:swiper@11.0.0/swiper.min.css" lejupielādē failu un pievieno to rindai vienreiz katrai versijai, pat ja to izmanto vairāki bloki.

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

Bloku tagi ārpus veidnēm

Kartējiet īsu prefiksu uz nosaukumvietu blockstudio.json vai piesaistiet vienu tagu vienam blokam ar aizstājvārda filtru, un <acme-card> atveidos acme/card. Iespējojiet blockTags.enabled, lai atveidotu tagus ierakstu saturā un logrīkos, ierobežojot tos ar allow un deny paraugiem.

data-* atribūti nonāk bloka saknes elementā, un tur nonāk arī html-* atribūti bez prefiksa. Pievienojiet savus tagu veidotājus ar blockstudio/block_tags/builders un pārrakstiet saīsinājumus pārnesamajā <bs:acme-card> pierakstā ar komandu migrate-block-tags.

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

Pielāgoti lauku tipi

Reģistrējiet savu lauka vadīklu un izmantojiet to tāpat kā iebūvēto lauku.

Bloku salas

Kešojiet visu lapu un apmeklētāja pieprasījuma laikā renderējiet vienu bloku.

Nosacījumu vadīta reģistrācija

Reģistrējiet bloku tikai noteiktam ieraksta veidam, lietotāja lomai vai citam globālam nosacījumam, vai izlaidiet to, ja trūkst nepieciešamā spraudņa vai tā versijas.

Ziņu metadati un opcijas

Saglabājiet vērtības ziņu metadatos vai opcijās līdzās bloku atribūtiem.

Nosacījumu loģika

Rādiet laukus, balstoties uz vērtībām, izmantojot vienādību, iekļaušanu, tukšuma pārbaudi un salīdzinājumus.

Dinamiskā datu aizpildīšana

Aizpildiet izvēles ar ziņām, lietotājiem, terminiem, funkcijām vai API.

Aizstāšana

Iestatiet override: true un koplietojama bloka nosaukumu, lai sapludinātu atribūtus pēc ID, aizstātu resursus ar failiem ar tādiem pašiem nosaukumiem un nomainītu veidni. Twig veidnes var aizstāt atsevišķus blokus, izmantojot extends.

Varianti

Deklarējiet variācijas block.json, lai iestatītu lauku vērtību sākotnējos iestatījumus, un paslēpiet lauku, kas tās nosaka, ar hidden.

Komponenti

Iestatiet component: true blokam, kas tiek atveidots tikai no PHP vai bloku tagiem. Tas saglabā laukus, veidnes, resursus un Tailwind, taču nekad neparādās bloku ievietotājā.

InnerBlocks noteikumi

Atļaujiet blokus ar namespace/*, category: un @theme marķieriem, pārslēdziet iekšējo veidni no atlases opcijas un noņemiet ieskaujošo elementu priekšgalā, izmantojot filtru.

Koda lauku resursi

Koda lauks ar asset: true pārveido redaktora ievadi par šī bloka CSS, SCSS vai JavaScript, kas ir piesaistīti instancei, izmantojot %selector%.

Resursi pēc faila nosaukuma

*.view.js tiek ielādēts tikai vietnes publiskajā daļā, savukārt ar global-, admin- un block-editor- prefiksu tiek norādīts fails, kas jāielādē katrā lapā, wp-admin vai bloku redaktorā.

Ikonas un bloku mapes

Piešķiriet blokam pielāgotu SVG vai HTML ikonu, mainiet meklēšanas vietu ar blockstudio/path filtru un pievienojiet mapes ar Blockstudio\Build::init().

ACF un Meta Box vērtības

Veidnes saņem $post_id, tāpēc get_field() un rwmb_get_value() nolasa rediģēto ierakstu, un refreshOn pēc saglabāšanas atsvaidzina priekšskatījumu.

Vaicājumu cilpas konteksts

Vaicājumu cilpas ietvaros $block[‘context’][‘postId’] seko pašreizējam vienumam, savukārt $block[‘postId’] paliek pašlaik skatītais ieraksts.

WPML

wp bs wpml config ieraksta wpml-config.xml, kas atzīmē teksta laukus kā tulkojamus, un attēli laukos tiek iekļauti WPML tulkošanas uzdevumos kopā ar alternatīvajiem tekstiem un parakstiem.

Plus

Oficiālais paplašinājumu komplekts

Premium vietņu veidnes, AI sistēmas instrukcijas un privāta Discord kopiena. Vienreizējs pirkums, atjauninājumi uz mūžu.

  • 500+ vietņu veidnes
  • AI sistēmas instrukcijas
  • Atjauninājumi visā lietošanas laikā
  • Privāta Discord kopiena