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.
{
"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.
<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.
<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>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.
{
"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;
});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.
{
"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>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.
{
"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-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.
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.
{
"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>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.
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