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