Mukautetut lohkot 3 tiedostossa
Ei JavaScript:tä, koontivaihetta tai mallikoodia.
Määritä kentät JSON-tiedostossa
Lisää blockstudio-avain kohteeseen block.json. Määritä attribuutit tyypeillä, kuten text, toggle ja color. Blockstudio luo editorin UI automaattisesti. Se sisältää 27 kenttätyyppiä tekstikentistä toistimiin ja koodieditoreihin sekä itse rekisteröimiäsi kenttätyyppejä.
Täysi JSON-skeematuki tarjoaa automaattisen täydennyksen ja tarkistuksen palveluissa VS Code ja PhpStorm sekä kaikissa yhteensopivissa editoreissa.
Jokainen kenttä voi määrittää default-arvon uusille lohkoille ja fallback-arvon, jonka malli saa kentän ollessa tyhjä.
{
"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" }
]
}
}Kolmen tiedoston työnkulku
block.json kenttiä varten, mallipohja merkintäkieltä varten ja valinnainen tyylitiedosto.
React kohteessa PHP
RichText, InnerBlocks ja useBlockProps toimivat suoraan kohteissa PHP, Twig tai Blade.
SCSS ja Tailwind
Käytä CSS- tai SCSS-määritystä tai Tailwind-määritystä. SCSS tukee tuontipolkuja ja yhteistä alkumääritystä, ja sisäkkäisen osan muokkaaminen kääntää uudelleen kaikki sitä tuovat tiedostot.
27 kenttätyyppiä
Teksti, väri, kuva, toistin, valinta, koodieditori ja paljon muuta määritetään kohteessa JSON.
JSON Schema
Automaattinen täydennys ja tarkistus palveluissa VS Code ja PhpStorm sekä yhteensopivissa editoreissa.
Kolme mallipohjakieltä
PHP, Twig ja Blade käyttävät samoja muuttujia ja komponentteja.
npm-tuonnit
Tuo paketteja kohteessa script.js. Tuotannossa ne ovat paikallisia, ja editorissa ne toimitetaan CDN-palvelun kautta.
Interactivity API
Ota WordPress Interactivity API käyttöön yhdellä lipulla.
React-komponentit PHP-mallipohjissa
Käytä <RichText />-toimintoa tekstin muokkaamiseen ja staattiseen käyttöliittymän HTML-toimintoon, <InnerBlocks />-toimintoa sisäkkäisiin lohkoihin ja useBlockProps-toimintoa ympäröivään rakenteeseen. Kaikki yhdessä mallipohjassa.
Editorissa näistä tulee oikeita React-komponentteja. Käyttöliittymässä ne renderöidään palvelimella HTML-elementeiksi, eikä kävijöille toimiteta JavaScript-tiedostoja.
<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>Kirjoita kielellä PHP, Twig tai Blade
Käytä tuntemaasi mallikieltä. PHP toimii heti käyttövalmiina, Twig toimii, kun Timber on asennettu, ja Blade toimii illuminate/view-versioilla 8–12 Blockstudio\Blade_Renderer-määrityksen kautta. Muuttujat, komponentit ja toiminta pysyvät samoina.
$a (ominaisuudet), $b (lohko), $c (konteksti) ja $innerBlocks ovat käytettävissä kaikilla kielillä.
Twig-mallit saavat myös koko Timber-kontekstin. Blade renderöi myös sivut, kuviot ja Sivustoeditorin mallit. Vanhempi jenssegers/blade-kääre ei toimi version illuminate/view 10 ja uudempien kanssa, joten käytä sen sijaan 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>Ehdollinen logiikka ja dynaamiset vaihtoehdot
Näytä ja piilota kenttiä operaattoreilla ==, !=, includes ja empty sekä vertailuoperaattoreilla. Yhdistä ehtoja TAI-logiikalla.
Asetukset voivat riippua toisesta kentästä. Lisää {attributes.post_type.value} täyttöargumentteihin, niin luettelo latautuu uudelleen kentän muuttuessa. Lisää fetch: true, jotta julkaisuja haetaan editorin kirjoittaessa.
Jaa sama valintaluettelo lohkojen kesken type: custom-toiminnolla ja blockstudio/blocks/attributes/populate-suodattimella, ja rekisteröi omia yleisiä ehtoja, kuten ostotarkistus, käyttämällä 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;
});Toistimet pysyvät hallittavina
Määritä min ja max, aloita uudet lohkot default-riveillä ja tiivistä olemassa olevat rivit komennolla minimized. textMinimized nimeää tiivistetyn rivin jollakin sen omista kentistä, kuten nimellä.
Riveillä voi käyttää kaikkia kenttätyyppejä välilehtiä lukuun ottamatta, myös sisäkkäisiä toistimia. Rivin sisäinen ehto tarkistaa rivin ulkopuolisen kentän arvon "context": "main"-toiminnolla, ja <RichText /> sekä <MediaPlaceholder /> muokkaavat yksittäistä riviä, kun niiden attribute osoittaa kohteeseen 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>Uudelleenkäytettävät kenttäjoukot
Määritä kenttäryhmä kerran field.json-määrityksessä ja viittaa siihen mistä tahansa lohkosta komennolla "type": "custom/cta". Kentät upotetaan suoraan, joten mallit lukevat niitä kuten mitä tahansa muuta attribuuttia.
Käytä samaa joukkoa kahdesti esimerkiksi idStructure-määrityksellä, kuten hero_{id}, ja muuta tunnisteita, oletusarvoja tai ehtoja lohkokohtaisesti komennolla overrides. Kenttätyyppi block tekee saman kokonaiselle lohkolle: se laajentaa lohkon kentät suoraan sisältöön ja palauttaa sen renderöidyn HTML-arvon.
{
"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-moduulit ilman koontivaihetta
Lisää script.js, niin se latautuu ES-moduulina. Tuo npm-paketteja etuliitteellä npm:, ja Blockstudio lataa ne paikallisesti tuotantokäyttöä varten.
Editorissa näet esikatselun heti, ja käyttöliittymä käyttää paikallisia moduuleja ilman ulkoisia riippuvuuksia. Moduulit otetaan käyttöön vain kerran.
Tyylitiedostot tuodaan samalla tavalla. import "npm:swiper@11.0.0/swiper.min.css" lataa tiedoston ja lisää sen jonoon kerran versiota kohden, vaikka useat lohkot käyttäisivät sitä.
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,
});
}Lohkotunnisteet mallien lisäksi
Yhdistä lyhyt etuliite nimiavaruuteen tiedostossa blockstudio.json tai yksi tunniste yhteen lohkoon aliassuodattimella, niin <acme-card> renderöi tunnisteen acme/card. Ota blockTags.enabled käyttöön, jotta tunnisteet renderöidään myös julkaisujen sisällössä ja vimpaimissa. Käyttöä rajaavat allow– ja deny-kuviot.
data-*-attribuutit siirtyvät lohkon juurielementtiin, ja html-*-attribuutit saapuvat sinne ilman etuliitettä. Lisää omia tunnisteiden muodostajia komennolla blockstudio/block_tags/builders ja muunna lyhenteet siirrettävään <bs:acme-card>-muotoon komennolla 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>Mukautetut kenttätyypit
Rekisteröi oma kentän ohjauskomponentti ja käytä sitä sisäänrakennetun kentän tavoin.
Lohkosaarekkeet
Tallenna koko sivu välimuistiin ja renderöi yksi lohko kävijän pyynnön yhteydessä.
Ehdollinen rekisteröinti
Rekisteröi lohko vain tietylle julkaisutyypille, käyttäjäroolille tai muulle yleiselle ehdolle. Voit myös jättää sen rekisteröimättä, jos sen tarvitsema lisäosa tai lisäosan versio puuttuu.
Artikkelien metatiedot ja asetukset
Tallenna arvot artikkelien metatietoihin tai asetuksiin lohko-ominaisuuksien rinnalle.
Ehdollinen logiikka
Näytä kenttiä arvojen perusteella käyttämällä yhtäsuuruus-, sisältyvyys-, tyhjyys- ja vertailuehtoja.
Dynaamiset vaihtoehdot
Hae valintavaihtoehdot artikkeleista, käyttäjistä, termeistä, funktioista tai rajapinnoista.
Ohitukset
Aseta yhteisen lohkon nimen kohdalla override: true, niin attribuutit yhdistetään tunnisteen mukaan, resurssit korvataan samannimisillä tiedostoilla ja malli vaihdetaan. Twig-malleissa yksittäiset lohkot voi korvata extends-määrityksellä.
Muunnelmat
Määritä tiedostossa block.json muunnelmia, jotka asettavat kenttien arvot valmiiksi, ja piilota niitä ohjaava kenttä hidden-määrityksellä.
Komponentit
Aseta component: true lohkolle, joka renderöidään vain PHP-määrityksestä tai lohkotunnisteista. Se säilyttää kentät, mallit, resurssit ja Tailwind-määrityksen, mutta ei koskaan näy lisääjässä.
InnerBlocks-säännöt
Salli lohkot, joiden tunnisteina ovat namespace/*, category: ja @theme, vaihda sisämalli valintavaihtoehdolla ja poista kääre suodattimella käyttöliittymän puolelta.
Koodikentän resurssit
Koodikenttä, jonka asset: true -asetus on käytössä, muuntaa editorin syötteen lohkon CSS-, SCSS- tai JavaScript-muotoon. Rajaus tehdään esiintymän mukaan arvolla %selector%.
Resurssit tiedostonimen mukaan
*.view.js latautuu vain käyttöliittymän puolella. global-, admin- ja block-editor-etuliitteillä varustetut tiedostot latautuvat jokaisella sivulla, wp-adminissa tai lokoeditorissa.
Kuvakkeet ja lohkokansiot
Anna lohkolle mukautettu SVG- tai HTML-kuvake, muuta etsintäpolkua blockstudio/path-suodattimella ja lisää kansioita määrityksellä Blockstudio\Build::init().
ACF- ja Meta Box-arvot
Mallit saavat $post_id-arvon, joten get_field() ja rwmb_get_value() lukevat muokattua julkaisua, ja refreshOn päivittää esikatselun tallennuksen jälkeen.
Kyselysilmukan konteksti
Kyselysilmukan sisällä $block[‘context’][‘postId’] seuraa nykyistä kohdetta, kun taas $block[‘postId’] pysyy tarkasteltavan julkaisun tunnisteena.
WPML
wp bs wpml config kirjoittaa wpml-config.xml-määrityksen, joka merkitsee tekstikentät käännettäviksi. Kenttiin tallennetut kuvat lisätään myös WPML-käännöstöihin alt-teksteineen ja kuvateksteineen.
Virallinen laajennuspaketti
Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.
- 500+ sivustomallia
- Tekoälyn järjestelmäohjeet
- Elinikäiset päivitykset
- Yksityinen Discord-yhteisö