Liigu sisu juurde

Dennis · 7. veebruar 2026

Introducing Blockstudio 7

Blockstudio 7 on kohal. See on projekti ajaloo suurim väljalase: kogu koodibaas kirjutati algusest peale täielikult ümber. Iga klass, iga konks ja iga koodirida ehitati nullist uuesti, keskendudes tänapäevasele PHP-le, WordPress kodeerimisstandarditele ja pikaajalisele hooldatavusele.

See pole aga lihtsalt ümbertegemine. Blockstudio 7 toob kaasa olulisi uusi võimalusi, näiteks failipõhised lehed ja mustrid, postituse metaandmete salvestussüsteemi, SEO integratsiooni ning täiesti uue parseri HTML-ist plokkideks, mis seda kõike käitab. Lisaks on Blockstudio nüüd täiesti tasuta ja avatud lähtekoodiga.

Vaatame lähemalt, mis on uut.

Tasuta ja avatud lähtekoodiga

Olen Blockstudio kallal töötanud alates aastast 2020 ja andnud aastate jooksul välja kümneid versioone. Kasutajatele see meeldis, kuid ärilise WordPress plokiraamistiku jaoks oli sobiva turuniši leidmine alati keeruline.

Võrrandit muutsid suured keelemudelid. Tehisintellekti kodeerimisabilised kirjutavad plokkide koodi nüüd piisavalt hästi, kuid vajavad töötamiseks puhtaid failipõhiseid struktuure. WordPress plokkide märgistus on segane: jadastatud HTML kommentaarid, mille sisse on põimitud JSON atribuudid ja mis on segatud DOM-struktuuriga. Inimestel on seda raske mõista, suurtele keelemudelitele on aga õige tulemuse loomine veel keerulisem.

Blockstudio failipõhine lähenemine on alati hoidnud asjad lihtsana: kaustas on block.json ja PHP mall. Andmebaasikirjeid pole, React pole, koostamisetappi pole. v7 viib selle mõtteviisi veelgi kaugemale. Parser HTML-ist plokkideks võimaldab kirjutada tavalist HTML-i, mis teisendatakse automaatselt korrektseks plokimärgistuseks. Kõik jääb failisüsteemi. Andmebaasi kirjutatakse ainult lehtede sünkroonimisel, mille käivitate selgesõnaliselt PHP API või CLI kaudu; need põhinevad failimallidel.

Blockstudio avatud lähtekoodiga avaldamine on loomulik järgmine samm. Mida rohkem suuri keelemudeleid Blockstudio koodiga treenitakse, seda paremini oskavad need seda genereerida. Avatud koodibaas, avatud dokumentatsioon ja valmis tehisintellekti kontekstifail, mida iga tööriist saab kasutada: nii luuakse parim keskkond tehisintellekti abiga WordPress arendamiseks.

Kogu plugin on saadaval aadressil GitHub ning kõik võivad seda kasutada, harundada ja sellesse panustada. Litsentsivõtmeid, tasulisi piiranguid ega funktsioonipiiranguid pole.

Uued funktsioonid

Failipõhised lehed

See on üks 7.0 suurimaid täiendusi. Nüüd saate määratleda terved WordPress lehed failimallidena, mis sünkroonitakse andmebaasiga natiivse plokisisuna, kui käivitate lehtede sünkroonimise käsu API või CLI.

Looge kaust, milles on page.json ja mallifail:

JSON
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
PHP
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>

Käivitage wp bs pages sync, et Blockstudio parsiks HTML-i WordPress plokkideks ning looks andmebaasis lehe või uuendaks seda.

Plokkide ühendamine võtmete alusel

Mallide sünkroonimisel kirjutataks kasutajate muudatused tavaliselt üle. Atribuut key lahendab selle, säilitades kasutajate sisu sünkroonimiste vahel:

HTML
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>

Sama võtmega plokkide kasutaja muudetud sisu säilib malli uuendamisel. Võtmeta plokid asendatakse täielikult.

Ploki sidumised

Võtmete asemel saate kasutada WordPress tuuma funktsiooni Block BindingsAPI, et ühendada plokid otse postituse metaandmetega. See pole Blockstudio funktsioon, vaid natiivne WordPress API. Blockstudio edastab atribuudi metadata lihtsalt loodud plokimärgistusse. Sisu asub plokimärgistuse asemel metaandmetes, nii et mallide sünkroonimine ei hävita kunagi kasutaja tehtud muudatusi. Andmeid saab pärida ka WP_Query kaudu ja need on saadaval REST API kaudu.

HTML
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>

Mõlemat lahendust saab kasutada samas mallis.

Muutmise juhtelemendid

Lehed toetavad sätteid blockEditingMode ja templateLock, millega määrata, mida kasutajad muuta saavad:

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}

See lukustab lehe struktuuri, kuid võimaldab kasutajatel teksti ja meediat muuta. Mallis oleva atribuudiga blockEditingMode saab üksikutele elementidele määrata lehe üldisest sättest erineva väärtuse.

Postituse ID-ga sidumine

Kasutage postId, et siduda lehe mall olemasoleva WordPress postitusega. Nii väldite duplikaatlehti ja tagate, et mall uuendab alati õiget postitust:

JSON
{
  "name": "home",
  "title": "Home",
  "postId": 2
}

Lisateavet leiate lehtede dokumentatsioonist.

Failipõhised mustrid

Sarnaselt lehtedega saate nüüd määratleda plokimustrid failimallidena. Kirjutage muster HTML-is ning Blockstudio parsib selle plokimärgistuseks ja registreerib natiivse WordPress plokimustrina. Need kuvatakse plokivalijas ja kasutajad saavad neid kõikjal kasutada.

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
HTML
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>

Erinevalt lehtedest ei loo mustrid andmebaasikirjeid. Need registreeritakse mällu iga lehe laadimise ajal. Vt mustrite dokumentatsiooni.

Parser HTML-ist plokkideks

Nii lehtede kui ka mustrite aluseks on uus parser HTML, mis teisendab standardsed HTML mallid WordPress plokimärgistuseks. See käsitleb automaatselt konteinerplokke (nt rühmad ja veerud) ning lehtplokke (nt lõigud ja pealkirjad). Parser kasutab trait’idel põhinevat renderdusarhitektuuri, mida on lihtne laiendada teiste plokitüüpide toega filtri blockstudio/parser/renderers kaudu:

PHP
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 );

Pärast registreerimist saate plokki kasutada mis tahes lehe- või mustrimallis:

HTML
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>

Salvestus

Väljad saavad nüüd salvestada väärtusi ploki atribuutidesse, postituse metaandmetesse või saidi suvanditesse. See on oluline täiendus:

JSON
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}

Kui väärtused asuvad postituse metaandmetes, saate:

  • Pärida postitusi väljale salvestatud väärtuste järgi, kasutades WP_Query ja meta_query
  • Juurdepääseda väljaandmetele peata saidi seadistuste jaoks mõeldud REST API kaudu
  • Jagada andmeid teiste pluginatega, näiteks SEO tööriistade ja vahemälukihtidega

Võite salvestada väärtusi ka suvandite tabelisse, et määrata kogu saidi jaoks üldised sätted:

JSON
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}

Täieliku API saamiseks vaadake salvestamise dokumentatsiooni.

Kohandatud väljad

Korduvkasutatavaid väljade määratlusi saab nüüd mitme ploki vahel jagada. Määratlege väljade komplekt üks kord ja viidake sellele mis tahes plokis. Nii pole sama väljastruktuuri kasutavate plokkide puhul vaja kordusi kirjutada.

Looge kataloogis blockstudio field.json:

JSON
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}

Seejärel viidake sellele mis tahes plokis, kasutades eesliidet custom/:

JSON
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}

Atribuudile idStructure lisatakse iga välja ID ette vastav eesliide, nii et heading-st saab hero_heading. Üksikute väljade atribuute saab plokipõhiselt üle kirjutada ka võtmega overrides.

Vt kohandatud väljade dokumentatsiooni.

Tailwind CSS v4

Tailwind tugi on v4 jaoks täielikult ümber ehitatud. Selle asemel et kompileerida kliendipoolselt käsuga CDN ja salvestada postituse salvestamisel kettale (varasem v6 lähenemine), kompileerib Blockstudio 7 Tailwind nüüd iga veebiliidese päringu ajal serveris, kasutades TailwindPHP. Node.js pole, CLI pole ja koostamisetappi pole vaja.

Kompileerimisel kasutatakse kandidaadipõhist vahemällu salvestamist: Blockstudio eraldab lõplikust HTML-st kõik CSS klassinimed, sordib need ning arvutab neist ja teie CSS seadistusest räsi, seejärel otsib vahemälus olevat faili. Samad klassid annavad vahemälu vaste ka siis, kui ümbritsev HTML muutub (nt korduskasutustõendid, ajatemplid või dünaamiline sisu).

Seadistamisel kasutatakse Tailwind v4-i CSS-põhist süntaksit. Määratlege kohandatud teemad ja utiliidiklassid otse failis blockstudio.json või filtri blockstudio/tailwind/css kaudu:

PHP
add_filter('blockstudio/tailwind/css', function ($css) {
  return $css . '
    @theme {
      --color-brand: #4f46e5;
    }

    @layer utilities {
      .container-narrow {
        max-width: 48rem;
        margin-inline: auto;
      }
    }
  ';
});

Plokiredaktoris annab komplekti kuuluv Tailwind CDN skript tippimise ajal reaalajas eelvaate. Väljatüüp classes pakub kõigi Tailwind utiliitide automaatset lõpetamist. Veebiliides kasutab alati serveris kompileeritud CSS-i, mis lisatakse tekstisisese stiilisildina enne </head> elementi.

Täieliku seadistusjuhendi leiate Tailwind dokumentatsioonist.

Interaktiivsus API

Blockstudio toetab nüüd WordPress interaktiivsuse API. Lülitage see oma block.json-is sisse:

JSON
{
  "blockstudio": {
    "interactivity": true
  }
}

Lisage mallile data-wp-* direktiivid:

PHP
<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>

Seejärel looge script.js oma poe loogikaga:

JavaScript
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});

Blockstudio haldab importmap’i, moodulite laadimist ja direktiivide töötlemist nii veebiliideses kui ka plokiredaktoris. Ainult deklaratiivseid direktiive ja data-wp-context kasutavad plokid (nt data-wp-bind--hidden või data-wp-text) töötavad täiesti ilma JavaScript-ta. Veebiliides toetab ka serveripoolset olekut wp_interactivity_state() kaudu.

Täieliku seadistusjuhendi leiate interaktiivsuse dokumentatsioonist.

SEO sisu analüüs

Blockstudio plokid on dünaamilised, mistõttu pole nende väljade sisu SEO pluginatele vaikimisi nähtav. Blockstudio 7 lahendab selle automaatse integratsiooniga pluginatega Yoast SEO, Rank Math ja SEOPress. Väljade text, textarea, richtext, wysiwyg ja link tekstiväärtused (ka pesastatud kordaja ridade omad) eraldatakse ja edastatakse iga plugina sisu analüüsi jaoks. SEO pluginad saavad nüüd plokkide sisu õigesti analüüsida, mõõtes märksõnade tihedust, loetavust ja muid näitajaid. Seadistamine pole vajalik.

Kordaja vaikeväärtusega read

Kordajaväljadel on nüüd atribuut default, mille väärtuseks saab määrata eeltäidetud ridade massiivi. Ploki lisamisel täidetakse kordaja määratud ridade ja nende väärtustega nii redaktoris kui ka veebiliideses:

JSON
{
  "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" }
  ]
}

Atribuut min toimib ka väljataseme vaikeväärtustega: kui kordajal on min: 3 ja selle sisemistel väljadel on väärtused default, täidetakse automaatselt loodud read tühjaks jäämise asemel nende vaikeväärtustega.

Täiustused ja parandused

  • Kordaja min väljade vaikeväärtustega: automaatselt loodud miinimumarvuga read kasutavad nüüd vaikeväärtusi nii veebiliideses kui ka redaktoris
  • Redaktori Tailwind stiilid: kompileeritud Tailwind CSS lisatakse nüüd plokiredaktori iframe’i koos CDN-ga, nii et kohandatud @apply reeglid ja teema seadistus töötavad redaktoris
  • Tehisintellekti kontekstifail: blockstudio-llm.txt on loodud uuesti staatilise failina, mis koostatakse kogu v7 dokumentatsiooni ja duplikaatidest puhastatud JSON skeemide põhjal (umbes 48k tokenit); sellega asendati dünaamiline genereerimine allikast v6
  • Koodivälja hüpikaken: koodivälja saab nüüd avada eraldi aknas, kus on sõltumatud tagasivõtmise ja kordamise toimingud ning JavaScript süntaksi esiletõstmine
  • Tailwind v4 serveripoolne kompileerimine: vt ülal jaotist Tailwind
  • API versioon 3: plokid renderdatakse nüüd korrektselt iframe-põhises redaktoris, sealhulgas saidiredaktoris ja kohanduvates eelvaadetes
  • Varade punktkirja kasutav nimetamine: varade järelliidete failinimed on nüüd selgemas vormingus (*.inline.css, *.editor.js, *.scoped.css)
  • Parandati WP_Block_Supports tekitatud hoiatus bs_render_block() kasutamisel useBlockProps
  • Parandati tingimusväljade probleem, mille tõttu ei kasutatud esmakordsel laadimisel vaikeväärtusi
  • Parandati probleem, mille tõttu kadusid veebiliideses sisust dollarimärgid <RichText />
  • Parandati funktsioon populate, et see töötaks teiste pluginatega registreeritud taksonoomiatega
  • Parandati WPML kontekstides esinenud null-viide optionsPopulate

Kapoti all

Täielik ümberkirjutus

See pole ümbertegemine ega korrastamine. Iga klass kirjutati nullist uuesti. Tulemuseks on puhtam ja modulaarsem koodibaas, mida on lihtsam hooldada ja laiendada.

Tänapäevane PHP

Blockstudio 7 nõuab versiooni PHP 8.2+ ning kasutab kõikjal tänapäevaseid tüübid deklaratsioone.

Tagasiühilduvust lõhkuvad muudatused

Suurversiooni uuendusena sisaldab 7.0 mitut tagasiühilduvust lõhkuvat muudatust. Enamikul neist on tagasiühilduvad varulahendused, kuid vaadake need enne uuendamist üle. Täieliku migreerimisjuhendi leiate v7 migreerimisdokumentatsioonist.

Konksude nimed kasutavad nüüd snake_case’i

Kõik PHP konksud nimetati camelCase’ist ümber snake_case’i, et järgida WordPress tuuma tavasid:

PHP
// 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'];
});

Vanad camelCase-nimed töötavad endiselt, kuid soovitame need uuendada.

Välja lüliti on vaikimisi väljas

Atribuudi switch vaikeväärtus on nüüd false, mitte true. Variandis v6 oli igal väljal vasakus servas nähtamatu lüliti, mis oli vaikimisi sisse lülitatud. Variandis v7 on lüliti valikuline ning seda tähistab välja sildil nähtav silmaikoon. Kui kasutasite lüliti vaikekäitumist, lisage oma väljade määratlustesse "switch": true.

Varafailide nimedes kasutatakse punkte

Varade järelliidetes kasutatakse nüüd sidekriipsude asemel punkte (style.inline.css, mitte style-inline.css). Vana sidekriipsuga vorming töötab endiselt, kuid edaspidi soovitame kasutada punktidega vormingut.

npm impordieesliide

ES-moodulite importimisel kasutatakse nüüd npm:, mitte blockstudio/:

JavaScript
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";

// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";

Eesliidet blockstudio/ toetatakse endiselt tagasiühilduvuse huvides.

Eemaldatud funktsioonid

Administraatoriala ja koodiredaktor. Eemaldati nii administraatori seadete leht WordPress kui ka sisseehitatud ploki koodiredaktor. Kogu seadistamine toimub nüüd filtrite blockstudio.json ja PHP kaudu, nii et teie seadistus asub koos plokkidega versioonihalduses.

Eelmistes versioonides oli koodiredaktor plokkide eelvaate vaatamiseks kasulik, kuid see ei saavutanud kunagi täielikku vastavust päris arenduskeskkonnale. Aastate jooksul jäi mitu plugina funktsiooni lisamata, sest neid polnud võimalik eraldiseisvas redaktoris toetada. Samuti polnud see kunagi mõeldud täisväärtusliku IDE asendajaks. Selle eemaldamine võimaldab pluginas keskenduda täielikult failipõhisele arendusele, ilma kompromissideta.

Litsentsivõti. Pole enam vajalik. Blockstudio on tasuta ja avatud lähtekoodiga.

Plokiteek. Sisseehitatud plokiteek „Blockstudio Elements” (Gallery, Slider, Image Comparison, Code, Icon) on eemaldatud. Need olid pluginaga kaasas olnud valmis näidisplokid. Kui kasutasite neid, kopeerige plokkide kaustad asukohast v6 oma teema blockstudio kataloogi.

Alustamine

Paigaldage Blockstudio 7 ja looge esimene plokk mõne minutiga. Juhised leiate samm-sammulisest alustamisjuhendist või v7 migreerimisjuhendist, kui lähete üle versioonilt v6.

Kogu lähtekood on saadaval aadressil GitHub. Ootame teie veateateid, PR-e ja tagasisidet.