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.
{
"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.
<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.
<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><div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
@if ($a['description'])
<div class="card__body">{{ $a['description'] }}</div>
@endif
<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.
{
"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" }
]]
}
]
}
}add_filter('blockstudio/blocks/attributes/populate', function ($options) {
$options['cardStyles'] = [
['value' => 'light', 'label' => 'Light'],
['value' => 'dark', 'label' => 'Dark'],
];
return $options;
});
add_filter('blockstudio/blocks/conditions', function ($conditions) {
$conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
return $conditions;
});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.
{
"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" }
]
}
]
}
}<div useBlockProps class="team">
<?php foreach ($a['members'] as $index => $member): ?>
<article>
<h3><?= esc_html($member['name']) ?></h3>
<RichText
tag="p"
attribute="members[<?= $index ?>].bio"
placeholder="Short bio"
/>
</article>
<?php endforeach; ?>
</div>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.
{
"name": "cta",
"title": "Call to action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
{ "id": "url", "type": "link", "label": "Button URL" }
]
}{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{
"type": "custom/cta",
"idStructure": "secondary_{id}",
"overrides": {
"label": { "default": "Contact us" }
}
},
{
"id": "card",
"type": "block",
"block": "starter/card",
"idStructure": "card_{id}"
}
]
}
}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.
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.
{
"blockTags": {
"enabled": true,
"prefixes": {
"acme": ["acme"],
"ui": ["acme-ui"]
},
"deny": ["acme-ui/admin-*"]
}
}<div useBlockProps class="acme-features">
<acme-card
title="Fast"
text="Rendered on the server."
data-track="card"
/>
<ui-button label="Get started" href="/start" html-id="start" />
</div>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.
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ė