Dennis · 2026 m. vasario 7 d.
Introducing Blockstudio 7
Blockstudio 7 jau čia. Tai didžiausias leidimas projekto istorijoje: visa kodo bazė visiškai perrašyta nuo pat pradžių. Kiekviena klasė, kiekvienas kablys, kiekviena kodo eilutė sukurta iš naujo, daugiausia dėmesio skiriant šiuolaikiniam PHP, WordPress kodavimo standartams ir ilgalaikiam palaikomumui.
Tačiau tai ne vien pertvarkymas. Blockstudio 7 pristato svarbias naujas funkcijas, tokias kaip puslapiai ir šablonai iš failų, įrašo metaduomenų saugojimo sistema, SEO integracija ir visiškai naujas HTML vertimo į blokus analizatorius, kuriuo visa tai veikia. Be to, Blockstudio dabar yra visiškai nemokama ir atvirojo kodo.
Peržvelkime visas naujienas.
Nemokama ir atvirojo kodo
Su Blockstudio dirbu nuo 2020, per daugelį metų išleidau dešimtis versijų. Naudotojams jis patiko, tačiau rasti komerciškai gyvybingą WordPress blokų sistemos modelį visada buvo sudėtinga.
Viską pakeitė LLM. DI kodavimo asistentai jau pakankamai gerai rašo blokų kodą, tačiau jiems reikia tvarkingos, failais pagrįstos struktūros. WordPress blokų žymėjimas netvarkingas: nuosekliai įrašyti HTML komentarai su įterptais JSON atributais, sumaišyti su DOM struktūra. Žmonėms tai sudėtinga, o LLM dar sunkiau tai atlikti teisingai.
Blockstudio metodas, kai svarbiausi yra failai, visada buvo skirtas paprastumui palaikyti: aplanke yra block.json ir PHP šablonas. Jokių duomenų bazės įrašų, jokio React, jokio kūrimo etapo. Su v7 ši filosofija tęsiama dar toliau. HTML vertimo į blokus analizatorius leidžia rašyti paprastą HTML, kuris automatiškai paverčiamas galiojančiu blokų žymėjimu. Viskas lieka failų sistemoje. Duomenų bazė rašoma tik sinchronizuojant puslapius, kai to aiškiai paprašoma per PHP API arba CLI, o sinchronizavimą lemia failų šablonai.
Blockstudio atvirojo kodo modelis yra natūralus kitas žingsnis. Kuo daugiau LLM mokomi naudojant Blockstudio kodą, tuo geriau jie jį generuoja. Atvira kodo bazė, atvira dokumentacija ir iš anksto paruoštas failas DI kontekstui, kurį gali naudoti bet kuris įrankis – taip sukuriama geriausia aplinka DI padedamai WordPress kūrybai.
Visą papildinį visi gali naudoti, išsišakoti ir prie jo prisidėti adresu GitHub. Jokių licencijos raktų, mokamų sienų ar funkcijų apribojimų.
Naujos funkcijos
Puslapiai iš failų
Tai vienas didžiausių 7.0 versijos papildymų. Dabar galite apibrėžti ištisus WordPress puslapius kaip failų šablonus, kurie iškvietus puslapių sinchronizavimo API arba CLI sinchronizuojami su duomenų baze kaip natyvus blokų turinys.
Sukurkite aplanką su page.json ir šablono failu:
{
"name": "about",
"title": "About Us",
"slug": "about",
"postStatus": "publish"
}
<div class="about-page">
<h1>About Us</h1>
<p>Welcome to our site.</p>
</div>
Paleiskite wp bs pages sync, kad Blockstudio išanalizuotų HTML į WordPress blokus ir sukurtų arba atnaujintų puslapį duomenų bazėje.
Blokų suliejimas pagal raktą
Sinchronizuojant šablonus naudotojų pakeitimai paprastai būtų perrašyti. key atributas išsaugo naudotojų turinį per sinchronizavimus:
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
Blokai su sutampančiais raktais išsaugo naudotojo redaguotą turinį atnaujinus šabloną. Blokai be raktų visiškai pakeičiami.
Blokų susiejimai
Kaip alternatyvą raktams galite naudoti WordPress branduolio Blokų susiejimus API, kad tiesiogiai susietumėte blokus su įrašo metaduomenimis. Tai nėra Blockstudio funkcija, o natyvus WordPress API sprendimas. Blockstudio tiesiog perduoda metadata atributą generuojamam blokų žymėjimui. Turinys saugomas metaduomenyse, o ne blokų žymėjime, todėl sinchronizuojant šablonus naudotojų pakeitimai niekada neprarandami. Duomenų taip pat galima ieškoti naudojant WP_Query ir jie pasiekiami per REST API.
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
Default Title
</h1>
Abu būdus galima naudoti tame pačiame šablone.
Redagavimo valdikliai
Puslapiuose galima naudoti blockEditingMode ir templateLock, kad būtų valdoma, ką naudotojai gali keisti:
{
"name": "landing",
"title": "Landing Page",
"blockEditingMode": "contentOnly",
"templateLock": "all"
}
Taip užrakinama puslapio struktūra, tačiau naudotojai vis tiek gali redaguoti tekstą ir mediją. Atskiri elementai šablone gali nepaisyti puslapio lygmens nuostatos naudodami blockEditingMode atributą.
Priskyrimas įrašų ID
Naudokite postId, kad susietumėte puslapio šabloną su esamu WordPress įrašu, išvengtumėte puslapių dublikatų ir užtikrintumėte, kad šablonas visada atnaujintų tinkamą įrašą:
{
"name": "home",
"title": "Home",
"postId": 2
}
Išsamią informaciją rasite Puslapių dokumentacijoje.
Šablonai iš failų
Panašiai kaip puslapius, dabar blokų šablonų rinkinius galite apibrėžti kaip failų šablonus. Parašykite savo šabloną HTML, o Blockstudio išanalizuos jį į blokų žymėjimą ir užregistruos kaip natyvų WordPress blokų šablonų rinkinį. Jie rodomi blokų įterpimo priemonėje, todėl naudotojai gali juos įterpti bet kur.
{
"name": "hero-section",
"title": "Hero Section",
"categories": ["featured"],
"keywords": ["hero", "banner"]
}
<div class="hero">
<h1>Welcome</h1>
<p>Get started today.</p>
</div>
Skirtingai nei puslapiai, šablonų rinkiniai nesukuria įrašų duomenų bazėje. Jie registruojami atmintyje kiekvieną kartą įkeliant puslapį. Žr. Šablonų dokumentaciją.
HTML vertimo į blokus analizatorius
Naujas HTML analizatorius veikia tiek puslapiuose, tiek šablonų rinkiniuose: įprasti HTML šablonai paverčiami WordPress blokų žymėjimu. Jis automatiškai apdoroja konteinerinius blokus (pvz., grupes ir stulpelius) ir lapinius blokus (pvz., pastraipas ir antraštes). Analizatorius naudoja požymiais pagrįstą atvaizdavimo architektūrą, todėl ją paprasta išplėsti ir palaikyti papildomus blokų tipus naudojant filtrą blockstudio/parser/renderers:
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
$renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
$content = $parser->get_inner_html( $element );
$html = '<div class="acme-hero">' . $content . '</div>';
return array(
'blockName' => 'acme/hero',
'attrs' => $attrs,
'innerBlocks' => array(),
'innerHTML' => $html,
'innerContent' => array( $html ),
);
};
return $renderers;
}, 10, 2 );
Užregistravę bloką galite naudoti bet kuriame puslapio arba šablonų rinkinio šablone:
<block name="acme/hero" background="/hero.jpg">
<h1>Welcome to our site</h1>
</block>
Saugykla
Laukų reikšmes dabar galima saugoti įrašo metaduomenyse arba svetainės parinktyse, ne tik bloko atributuose. Tai svarbus pakeitimas:
{
"id": "subtitle",
"type": "text",
"label": "Subtitle",
"storage": {
"type": "postMeta"
}
}
Įrašo metaduomenyse saugomas reikšmes galite naudoti taip:
- Ieškoti įrašų pagal laukų reikšmes naudojant
WP_Queryirmeta_query - Pasiekti laukų duomenis per REST API, skirtą svetainėms be atvaizdavimo serveryje
- Dalytis duomenimis su kitų papildinių įrankiais, pvz., SEO, ir spartinančiosios atminties sluoksniais
Taip pat galite saugoti reikšmes parinkčių lentelėje, skirtas visos svetainės nuostatoms:
{
"id": "phone",
"type": "text",
"label": "Phone Number",
"storage": {
"type": "option",
"optionKey": "company_phone"
}
}
Visą API rasite Saugojimo dokumentacijoje.
Pasirinktiniai laukai
Dabar galima dalytis pakartotinai naudojamais laukų aprašais tarp kelių blokų. Apibrėžkite laukų rinkinį vieną kartą ir nurodykite jį bet kuriame bloke. Taip išvengsite pasikartojimų, kai keliuose blokuose naudojama ta pati laukų struktūra.
Sukurkite field.json savo blockstudio kataloge:
{
"name": "hero",
"title": "Hero Section",
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
Tada nurodykite jį bet kuriame bloke naudodami custom/ prefiksą:
{
"blockstudio": {
"attributes": [
{ "type": "custom/hero", "idStructure": "hero_{id}" }
]
}
}
Savybė idStructure prideda prefiksą prie kiekvieno lauko ID, todėl heading tampa hero_heading. Taip pat galite perrašyti atskirų laukų savybes konkrečiame egzemplioriuje naudodami raktą overrides.
Žr. Pasirinktinių laukų dokumentaciją.
Tailwind CSS v4
Tailwind palaikymas visiškai perkurtas v4. Užuot kompiliavusi kliento pusėje per CDN ir išsaugojusi diske išsaugant įrašą (v6 metodas), Blockstudio 7 kompiliuoja Tailwind serverio pusėje, kaskart pateikus išorinę užklausą, per TailwindPHP. Nereikia Node.js, CLI ar kūrimo etapo.
Kompiliavimui naudojama kandidatais pagrįsta spartinančioji atmintinė: Blockstudio iš galutinio HTML išrenka visus CSS klasių pavadinimus, surikiuoja juos ir apskaičiuoja jų maišą kartu su jūsų CSS konfigūracija, tada patikrina, ar yra failas spartinančiojoje atmintinėje. Toms pačioms klasėms parenkamas tas pats įrašas net pasikeitus aplinkiniam HTML (vienkartiniams skaičiams, laiko žymoms ar dinaminiam turiniui).
Konfigūracijoje naudojama Tailwind v4 sintaksė, kurioje pirmiausia aprašomi CSS. Tinkintas temas ir pagalbines klases apibrėžkite tiesiogiai faile blockstudio.json arba naudodami filtrą blockstudio/tailwind/css:
add_filter('blockstudio/tailwind/css', function ($css) {
return $css . '
@theme {
--color-brand: #4f46e5;
}
@layer utilities {
.container-narrow {
max-width: 48rem;
margin-inline: auto;
}
}
';
});
Blokų rengyklėje kartu įtrauktas Tailwind CDN scenarijus leidžia matyti tiesioginę peržiūrą rašant. Lauko tipas classes pateikia visų Tailwind pagalbinių klasių automatinio užbaigimo pasiūlymus. Išorinėje svetainės dalyje visada naudojamas serverio pusėje sukompiliuotas CSS, įterpiamas kaip tiesioginis stiliaus elementas prieš </head>.
Visą sąranką rasite Tailwind dokumentacijoje.
Sąveika API
Blockstudio dabar palaiko WordPress Interactivity API. Įjunkite ją faile block.json:
{
"blockstudio": {
"interactivity": true
}
}
Pridėkite data-wp-* direktyvas į šabloną:
<div useBlockProps
data-wp-interactive="myBlock"
data-wp-context='{ "isOpen": false }'>
<button data-wp-on--click="actions.toggle"
data-wp-bind--aria-expanded="context.isOpen">
Toggle
</button>
<div data-wp-bind--hidden="!context.isOpen">
This content is toggled by the button.
</div>
</div>
Tada sukurkite script.js su saugyklos logika:
import { store, getContext } from '@wordpress/interactivity';
store('myBlock', {
actions: {
toggle: () => {
const context = getContext();
context.isOpen = !context.isOpen;
},
},
});
Blockstudio tvarko importų žemėlapį, modulių įkėlimą ir direktyvų apdorojimą tiek išorinėje svetainės dalyje, tiek blokų rengyklėje. Blokai, kuriuose naudojamos tik deklaratyvios direktyvos su data-wp-context (pvz., data-wp-bind--hidden arba data-wp-text), veikia be jokio JavaScript. Taip pat palaikoma serverio pusės būsena, naudojant wp_interactivity_state(), išorinėje svetainės dalyje.
Visą sąranką rasite Sąveikos dokumentacijoje.
SEO turinio analizė
Blockstudio blokai yra dinaminiai, todėl SEO papildiniai pagal numatytuosius nustatymus nemato jų laukų turinio. Blockstudio 7 tai išsprendžia automatiškai integruodama su Yoast SEO, Rank Math ir SEOPress. Teksto reikšmės iš laukų text, textarea, richtext, wysiwyg ir link (įskaitant įdėtas pasikartojančių laukų eilutes) išrenkamos ir perduodamos kiekvieno papildinio turinio analizei. Dabar SEO papildiniai gali tinkamai analizuoti blokų turinį pagal raktažodžių tankį, skaitomumą ir kitus rodiklius. Konfigūruoti nereikia.
Pasikartojančio lauko numatytosios eilutės
Pasikartojančių laukų reikšmėms dabar galima nustatyti default savybę su iš anksto užpildytų eilučių masyvu. Įterpus bloką, pasikartojantis laukas užpildomas nurodytomis eilutėmis ir jų reikšmėmis tiek rengyklėje, tiek išorinėje svetainės dalyje:
{
"id": "features",
"type": "repeater",
"label": "Features",
"default": [
{ "title": "Fast", "icon": "bolt" },
{ "title": "Secure", "icon": "shield" }
],
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "icon", "type": "text", "label": "Icon" }
]
}
Savybė min taip pat veikia kartu su laukų numatytosiomis reikšmėmis: jei pasikartojantis laukas turi min: 3, o jo vidiniai laukai turi reikšmes default, automatiškai sukurtos eilutės užpildomos tomis numatytosiomis reikšmėmis, o ne paliekamos tuščios.
Patobulinimai ir pataisymai
- Pasikartojantis laukas
minsu numatytosiomis laukų reikšmėmis: automatiškai sugeneruotose minimalaus skaičiaus eilutėse dabar naudojamos numatytosios laukų reikšmės tiek išorinėje svetainės dalyje, tiek rengyklėje - Tailwind rengyklės stiliai: sukompiliuotas Tailwind CSS dabar įterpiamas į blokų rengyklės iframe kartu su CDN, todėl rengyklėje veikia tinkintos
@applytaisyklės ir temų konfigūracija - DI konteksto failas:
blockstudio-llm.txtatkurtas kaip statinis failas, surinktas iš visos v7 dokumentacijos ir pašalintų pasikartojančių JSON schemų (~48k žetonų); taip pakeistas dinaminis generavimas iš v6 - Kodo lauko atskiras langas: kodo lauką dabar galima atverti atskirame lange su nepriklausomomis anuliavimo ir grąžinimo funkcijomis bei JavaScript sintaksės paryškinimu
- Tailwind v4 kompiliavimas serverio pusėje: žr. aukščiau esantį Tailwind skyrių
- API 3 versija: blokai dabar tinkamai atvaizduojami įrėmintoje rengyklėje, įskaitant svetainės rengyklę ir adaptyviąsias peržiūras
- Taškinė išteklių failų pavadinimų notacija: aiškesnė išteklių priesagų pavadinimų konvencija (
*.inline.css,*.editor.js,*.scoped.css) - Pataisytas
bs_render_block()įspėjimas išWP_Block_SupportsnaudojantuseBlockProps - Pataisyta sąlyginių laukų problema, dėl kurios pirmą kartą įkeliant nebuvo atsižvelgiama į numatytąsias reikšmes
- Pataisyta problema, dėl kurios išorinėje svetainės dalyje iš
<RichText />turinio buvo pašalinami dolerio ženklai - Pataisyta
populatefunkcija, kad ji veiktų su taksonomijomis, kurias užregistravo kiti papildiniai - Pataisyta
optionsPopulateklaida nulinės reikšmės atveju WPML kontekstuose
Kaip tai veikia viduje
Visiškai perrašyta
Tai ne pertvarkymas ar sutvarkymas. Kiekviena klasė perrašyta nuo pradžių. Rezultatas – tvarkingesnė, moduliškesnė kodo bazė, kurią lengviau prižiūrėti ir plėsti.
Šiuolaikinis PHP
Blockstudio 7 reikia PHP 8.2+ ir visur naudojamos šiuolaikinės tipų deklaracijos.
Nesuderinami pakeitimai
Pagrindiniame 7.0 versijos naujinime yra keli nesuderinami pakeitimai. Dauguma jų turi atgalinį suderinamumą užtikrinančių alternatyvų, tačiau prieš naujindami peržiūrėkite šiuos pakeitimus. Visą migravimo vadovą rasite v7 migravimo dokumentacijoje.
Kablių pavadinimuose dabar naudojama snake_case rašyba
Visų PHP kablių pavadinimai pakeisti iš camelCase į snake_case, kad atitiktų WordPress branduolio konvencijas:
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
return ['my-stylesheet'];
});
// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet'];
});
Seni camelCase pavadinimai vis dar veikia, tačiau rekomenduojame juos atnaujinti.
Lauko jungiklis pagal numatytuosius nustatymus išjungtas
Savybės switch numatytoji reikšmė dabar yra false, o anksčiau buvo true. v6 versijoje kiekvienas laukas kairiajame krašte turėjo nematomą jungiklį, kuris pagal numatytuosius nustatymus būdavo įjungtas. v7 versijoje jungiklis įjungiamas pasirinktinai, o lauko etiketėje vaizduojamas matoma akies piktograma. Jei pasikliovėte numatytąja jungiklio elgsena, įtraukite "switch": true į laukų aprašus.
Išteklių failų pavadinimuose naudojama taškinė notacija
Išteklių priesagose dabar naudojami taškai, o ne brūkšneliai (style.inline.css vietoj style-inline.css). Sena brūkšnelių notacija vis dar veikia, tačiau ateityje rekomenduojama naudoti taškinę notaciją.
npm importų prefiksas
ES modulių importuose dabar naudojamas npm:, o ne blockstudio/:
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";
// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
Prefiksas blockstudio/ vis dar palaikomas dėl atgalinio suderinamumo.
Pašalintos funkcijos
Administravimo sritis ir kodo rengyklė. WordPress administravimo nuostatų puslapis ir integruota blokų kodo rengyklė pašalinti. Visa konfigūracija dabar atliekama naudojant blockstudio.json ir PHP filtrus, todėl sąranka laikoma versijų valdymo sistemoje kartu su blokais.
Ankstesnėse versijose kodo rengyklė buvo naudinga blokams peržiūrėti, tačiau jos galimybės niekada neprilygo tikrai kūrimo aplinkai. Bėgant metams kai kurių papildinio funkcijų nebuvo galima įtraukti, nes jų nepavyko palaikyti atskiroje rengyklėje. Ji taip pat niekada nebūtų pakeitusi visavertės IDE. Pašalinus ją, papildinys gali visą dėmesį skirti kūrimui naudojant failus ir išvengti apribojimų.
Licencijos raktas. Nebereikalingas. Blockstudio yra nemokama ir atvirojo kodo.
Blokų biblioteka. Integruota „Blockstudio Elements“ biblioteka (Gallery, Slider, Image Comparison, Code, Icon) pašalinta. Tai buvo iš anksto sukurti pavyzdiniai blokai, pateikiami kartu su papildiniu. Jei juos naudojote, nukopijuokite blokų aplankus iš v6 į savo temos blockstudio katalogą.
Darbo pradžia
Įdiekite Blockstudio 7 ir per kelias minutes sukurkite pirmą bloką. Žingsnis po žingsnio instrukcijas rasite vadove Darbo pradžios vadovas, o naujindami iš v6 peržiūrėkite v7 migravimo vadovą.
Visą šaltinio kodą rasite GitHub. Kviečiame pranešti apie problemas, teikti PR ir pasidalinti atsiliepimais.