Egyéni blokkok 3 fájlban
Nincs JavaScript, nincs buildlépés, nincs sablonkód.
Mezők meghatározása itt: JSON
Adjon hozzá egy blockstudio kulcsot a block.json elemhez. Határozza meg az attribútumokat olyan típusokkal, mint text, toggle és color. A Blockstudio automatikusan létrehozza a szerkesztő UI elemét, 27 mezőtípussal a szövegbeviteli mezőktől az ismétlőkön és kódszerkesztőkön át, valamint az Ön által regisztrált mezőtípusokkal.
A teljes JSON séma támogatása automatikus kiegészítést és ellenőrzést biztosít a VS Code, a PhpStorm és minden kompatibilis szerkesztőben.
Minden mező megadhat egy default értéket az új blokkokhoz, valamint egy fallback értéket, amelyet a sablon akkor kap meg, amikor a mező üres.
{
"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" }
]
}
}Háromfájlos munkafolyamat
block.json a mezőkhöz, egy sablon a jelölőkódhoz és egy opcionális stíluslap.
React a PHP nyelvben
A RichText, az InnerBlocks és a useBlockProps közvetlenül működik a PHP, a Twig vagy a Blade nyelvben.
SCSS és Tailwind
Használja a CSS, a SCSS vagy a Tailwind elemet. A SCSS támogatja az importálási útvonalakat és a megosztott előbetöltést; egy beágyazott részfájl szerkesztése újrafordítja az összes fájlt, amely importálja azt.
27 mezőtípus
Szöveg, szín, kép, ismétlő, választó, kódszerkesztő és más mezők beállítása itt: JSON.
JSON Schema
Automatikus kiegészítés és ellenőrzés a VS Code, a PhpStorm és a kompatibilis szerkesztők számára.
Három sablonnyelv
A PHP, a Twig és a Blade ugyanazokat a változókat és komponenseket használja.
npm importálása
Csomagok importálása a script.js nyelvben; helyi használat produkcióban, a szerkesztőben pedig CDN-alapú betöltés.
Interactivity API
Egyetlen kapcsolóval engedélyezd a WordPress Interactivity API funkciót.
React-komponensek PHP-sablonokban
Használd a <RichText /> elemet a helyben történő szerkesztéshez és a statikus frontend HTML-hez, a <InnerBlocks /> elemet a gyermekblokkokhoz, a useBlockProps elemet pedig a burkolóhoz; mindez egyetlen sablonban elfér.
A szerkesztőben ezek valódi React-komponensekké válnak. A frontenden szerveroldali HTML formájában jelennek meg, és nem kerül JavaScript a látogatókhoz.
<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>Írj PHP, Twig vagy Blade nyelven
Használja az Ön által ismert sablonnyelvet. A PHP azonnal működik, a Twig a Timber telepítése után fut, a Blade pedig a illuminate/view 8–12-es verzióján fut a Blockstudio\Blade_Renderer segítségével. A változók, komponensek és működés változatlan marad.
A $a (attribútumok), a $b (blokk), a $c (kontextus) és a $innerBlocks minden nyelven elérhető.
A Twig sablonok is megkapják a teljes Timber kontextust. A Blade oldalakat, mintázatokat és a Webhelyszerkesztő sablonjait is megjeleníti. A régebbi jenssegers/blade burkoló nem működik a illuminate/view 10-es és újabb verzióival, ezért inkább a Blade_Renderer elemet használja.
<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>Feltételes logika és dinamikus lehetőségek
Mezők megjelenítése és elrejtése többek között a ==, a !=, a includes és a empty operátorokkal, valamint összehasonlításokkal. A feltételek OR-logikával kombinálhatók.
A beállítások függhetnek egy másik mezőtől. Helyezze a {attributes.post_type.value} elemet a feltöltési argumentumok közé, és a lista újratöltődik, amikor az adott mező értéke megváltozik. Adja hozzá a fetch: true elemet, hogy a bejegyzések keresése a szerkesztő gépelése közben történjen.
Osszon meg egyetlen opciólistát a blokkok között a type: custom és a blockstudio/blocks/attributes/populate szűrő használatával, és regisztrálja saját globális feltételeit, például egy vásárlás ellenőrzését, a blockstudio/blocks/conditions segítségével.
{
"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;
});Könnyen kezelhető ismétlők
Állítsa be a min és a max értékét, indítsa az új blokkokat default sorral, a meglévő sorokat pedig csukja össze a minimized segítségével. A textMinimized a sor egyik saját mezőjével, például egy névvel jelöli az összecsukott sort.
A sorok bármilyen mezőtípust elfogadnak a füleken kívül, a beágyazott ismétlőket is beleértve. A soron belüli feltétel a soron kívüli mezőt a "context": "main" segítségével ellenőrzi, a <RichText /> és a <MediaPlaceholder /> pedig egyetlen sort szerkeszt, ha a attribute a repeaterId[index].fieldId elemre mutat.
{
"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>Újrafelhasználható mezőkészletek
Definiáljon egyszer egy mezőcsoportot egy field.json elemben, majd hivatkozzon rá bármelyik blokkból a "type": "custom/cta" segítségével. A mezők beágyazódnak, így a sablonok ugyanúgy olvashatják őket, mint bármely más attribútumot.
Használja kétszer ugyanazt a készletet egy olyan idStructure segítségével, mint a hero_{id}, és módosítsa a címkéket, az alapértelmezett értékeket vagy a feltételeket blokkonként a overrides segítségével. A block mezőtípus ugyanezt teszi egy teljes blokkal: beágyazza a blokk mezőit, és visszaadja a megjelenített HTML értékét.
{
"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-modulok buildlépés nélkül
Add hozzá a script.js elemet, és ES-modulként töltődik be. A npm: előtagú npm csomagokat a Blockstudio tölti le helyben a produkciós környezethez.
A szerkesztő azonnali előnézetet ad, a frontend pedig helyi modulokat használ külső függőségek nélkül; a rendszer csak egyszer veszi fel őket a betöltési sorba.
A stíluslapok importálása ugyanígy működik. A import "npm:swiper@11.0.0/swiper.min.css" letölti a fájlt, és verziónként egyszer sorba állítja, még akkor is, ha több blokk használja.
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,
});
}Blokktagek a sablonokon túl
Rendeljen rövid előtagot egy névtérhez a blockstudio.json segítségével, vagy egy taget egy blokkhoz egy álnévs szűrővel, majd jelenítse meg a acme/card elemet a <acme-card> segítségével. Kapcsolja be a blockTags.enabled beállítást a bejegyzések tartalmában és a widgetekben lévő tagek megjelenítéséhez; a lehetőséget a allow és a deny minták korlátozzák.
A data-* attribútumok a blokk gyökéreleméhez kerülnek, a html-* attribútumok pedig előtag nélkül jutnak oda. Adjon hozzá saját tagépítőket a blockstudio/block_tags/builders segítségével, és írja át a rövid alakokat hordozható <bs:acme-card> formára a migrate-block-tags paranccsal.
{
"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>Egyéni mezőtípusok
Regisztráld a saját mezővezérlődet, és használd úgy, mint a beépített mezőket.
Blokkszigetek
Gyorsítótárazd a teljes oldalt, és egy blokkot a látogató kérésére renderelj.
Feltételes regisztráció
Regisztráljon egy blokkot csak egy bejegyzéstípushoz, felhasználói szerepkörhöz vagy más globális feltételhez, vagy hagyja ki, ha egy szükséges bővítmény vagy annak verziója hiányzik.
Bejegyzésmeta és beállítások
Az értékeket a blokk attribútumai mellett a bejegyzésmeta vagy a beállítások között tárold.
Feltételes logika
Mezők megjelenítése az értékek alapján: egyenlőség, tagság, üresség és összehasonlítás.
Dinamikus feltöltés
A választási lehetőségek bejegyzésekből, felhasználókból, kifejezésekből, függvényekből vagy API-kból tölthetők fel.
Felülbírálások
Állítsa be az override: true értéket egy megosztott blokk nevével, hogy az attribútumok azonosító szerint egyesüljenek, az azonos fájlnevű erőforrások lecserélődjenek, a sablon pedig kicserélődjön. A Twig sablonok az extends segítségével egyesével is felülírhatják a blokkokat.
Változatok
Deklaráljon a block.json segítségével olyan variációkat, amelyek előre beállítják a mezőértékeket, a vezérlőmezőt pedig rejtse el a hidden segítségével.
Komponensek
Állítsa be a component: true értéket egy olyan blokknál, amely csak a PHP vagy a blokktagek alapján jelenik meg. Megőrzi a mezőket, sablonokat, erőforrásokat és a Tailwind elemet, de nem jelenik meg a beszúróban.
InnerBlocks-szabályok
Engedélyezze a namespace/*, category: és @theme tokeneket tartalmazó blokkokat, válasszon belső sablont egy select opcióval, és távolítsa el a burkolót a frontenden egy szűrő segítségével.
Kódmezők erőforrásai
Az asset: true értékű kódmező a szerkesztői bevitelt CSS, SCSS vagy JavaScript fájllá alakítja az adott blokkhoz, a példányra korlátozva a %selector% segítségével.
Fájlnév alapján kezelt eszközök
*A .view.js csak a frontenden töltődik be, a global-, admin- és block-editor- előtagok pedig minden oldalon, a wp-admin felületen vagy a blokkszerkesztőben töltenek be egy fájlt.
Ikonok és blokkmappák
Adjon egy blokknak egyéni SVG- vagy HTML ikont, módosítsa a felfedezés helyét a blockstudio/path szűrővel, és adjon hozzá mappákat a Blockstudio\Build::init() segítségével.
ACF és Meta Box értékek
A sablonok megkapják a $post_id elemet, így a get_field() és a rwmb_get_value() a szerkesztett bejegyzést olvassa, a refreshOn pedig mentés után frissíti az előnézetet.
A Query Loop kontextusa
Egy Query Loopon belül a $block[‘context’][‘postId’] az aktuális elemet követi, míg a $block[‘postId’] a megtekintett bejegyzés azonosítója marad.
WPML
A wp bs wpml config létrehozza a wpml-config.xml fájlt, amely megjelöli a szövegmezőket fordíthatóként; a mezőkben tárolt képek pedig az alternatív szövegükkel és képaláírásukkal együtt bekerülnek a WPML fordítási feladatai közé.
A hivatalos bővítőkészlet
Prémium webhelysablonok, MI-rendszerutasítások és privát Discord közösség. Egyszeri vásárlás, élethosszig tartó frissítések.
- 500+ webhelysablon
- AI-rendszerutasítások
- Élettartamra szóló frissítések
- Privát Discord közösség