Siirry sisältöön

Dennis · 7. helmikuuta 2026

Introducing Blockstudio 7

Blockstudio 7 on täällä. Tämä on projektin historian suurin julkaisu: koko koodikannan täydellinen uudelleenkirjoitus alusta alkaen. Jokainen luokka, koukku ja koodirivi on rakennettu uudelleen painottaen modernia PHP-kehitystä, WordPress-koodauskäytäntöjä ja pitkäaikaista ylläpidettävyyttä.

Kyse ei kuitenkaan ole vain uudelleenjärjestelystä. Blockstudio 7 tuo merkittäviä uusia ominaisuuksia, kuten tiedostopohjaiset sivut ja kuviot, artikkelin metatietojen tallennusjärjestelmän, SEO-integraation sekä uuden HTML-lohkomuuntimen, joka mahdollistaa kaiken tämän. Lisäksi Blockstudio on nyt täysin ilmainen ja avoimen lähdekoodin.

Käydään läpi kaikki uusi.

Ilmainen ja avoimen lähdekoodin

Olen kehittänyt Blockstudio-projektia vuodesta 2020 lähtien ja julkaissut vuosien varrella kymmeniä versioita. Käyttäjät pitivät siitä, mutta kaupallisen WordPress-lohkoalustan markkinakysynnän löytäminen oli aina haastavaa.

Ratkaiseva muutos on LLM-mallit. Tekoälyavustajat osaavat nyt kirjoittaa lohkokoodia, mutta tarvitsevat selkeitä, tiedostopohjaisia rakenteita. WordPress-lohkomerkintä on sekavaa: sarjoitettuja HTML-kommentteja, joihin on upotettu JSON-attribuutteja ja jotka sekoittuvat DOM-rakenteeseen. Se on vaikeaa ihmisille ja vielä vaikeampaa LLM-malleille.

Blockstudio-projektin tiedostokeskeinen lähestymistapa on aina pyrkinyt yksinkertaisuuteen: kansiossa on block.json ja PHP-malli. Ei tietokantamerkintöjä, ei React-toimintoa eikä koontivaihetta. v7 vie tätä ajatusta vielä pidemmälle. HTML-lohkomuunnin muuntaa tavallisen HTML-sisällön automaattisesti kelvolliseksi lohkomerkinnäksi. Kaikki pysyy tiedostojärjestelmässä. Tietokantaan kirjoitetaan vain sivujen synkronoinnin yhteydessä, kun se erikseen käynnistetään PHP API-komennolla tai CLI-komennolla, ja tällöin lähteenä ovat tiedostomallit.

Blockstudio-projektin avaaminen avoimeen lähdekoodiin on luonteva seuraava askel. Mitä enemmän LLM-mallit kouluttautuvat Blockstudio-koodilla, sitä paremmin ne osaavat tuottaa sitä. Avoin koodikanta, avoin dokumentaatio ja valmis tekoälyn kontekstitiedosto, jota mikä tahansa työkalu voi hyödyntää: näin luodaan paras ympäristö tekoälyavusteiseen WordPress-kehitykseen.

Koko lisäosa on saatavilla GitHub, jossa kuka tahansa voi käyttää sitä, tehdä siitä haaran ja osallistua kehitykseen. Ei lisenssiavaimia, maksumuureja tai ominaisuusrajoituksia.

Uudet ominaisuudet

Tiedostopohjaiset sivut

Tämä on yksi version 7.0 suurimmista lisäyksistä. Nyt voit määritellä kokonaisia WordPress-sivuja tiedostomalleina, jotka synkronoidaan tietokantaan natiiveina lohkosisältöinä, kun käynnistät sivujen synkronoinnin API-komennolla tai CLI-komennolla.

Luo kansio, jossa on page.json ja mallitiedosto:

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>

Suorita wp bs pages sync, niin Blockstudio jäsentää HTML-tiedoston WordPress-lohkoiksi ja luo tai päivittää sivun tietokantaan.

Lohkojen yhdistäminen avainten perusteella

Mallien synkronointi korvaisi tavallisesti käyttäjän tekemät muokkaukset. key-attribuutti säilyttää käyttäjän sisällön synkronointien välillä:

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

Lohkojen avaimet säilyvät samoina, joten mallin päivittyessä myös käyttäjän muokkaama sisältö säilyy. Avaimettomat lohkot korvataan kokonaan.

Lohkosidonnat

Avainten sijaan voit käyttää WordPress-ytimen Block BindingsAPI -toimintoa lohkojen yhdistämiseen suoraan artikkelin metatietoihin. Tämä ei ole Blockstudio-ominaisuus, vaan natiivi WordPress API. Blockstudio välittää metadata-attribuutin luotuun lohkomerkintään. Sisältö tallennetaan metatietoihin lohkomerkinnän sijaan, joten mallien synkronointi ei koskaan tuhoa käyttäjän muokkauksia. Tiedot ovat myös kyseltävissä WP_Query-toiminnolla ja käytettävissä REST API-rajapinnan kautta.

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

Molempia tapoja voi käyttää samassa mallissa.

Muokkausrajoitukset

Sivujen blockEditingMode– ja templateLock-asetuksilla voit hallita, mitä käyttäjät voivat muokata:

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

Tämä lukitsee sivun rakenteen, mutta sallii tekstin ja median muokkaamisen. Yksittäiset elementit voivat ohittaa sivutason asetuksen mallissa olevalla blockEditingMode-attribuutilla.

Sivun kiinnittäminen artikkelitunnukseen

Käytä postId-toimintoa sivumallin liittämiseen olemassa olevaan WordPress-artikkeliin. Näin vältät kaksoissivut ja varmistat, että malli päivittää aina oikeaa artikkelia:

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

Katso lisätietoja Pages-dokumentaatiosta.

Tiedostopohjaiset kuviot

Sivujen tapaan myös lohkokuvioita voi nyt määritellä tiedostomalleina. Kirjoita kuviosi HTML-tiedostoon, niin Blockstudio muuntaa sen lohkomerkinnäksi ja rekisteröi natiiviksi WordPress-lohkokuvioiksi. Kuviot näkyvät lohkojen lisäysvalikossa, ja käyttäjät voivat lisätä ne minne tahansa.

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>

Sivuista poiketen kuviot eivät luo tietokantamerkintöjä. Ne rekisteröidään muistiin jokaisella sivulatauksella. Katso Patterns-dokumentaatio.

HTML-lohkomuunnin

Sekä sivut että kuviot perustuvat uuteen HTML-jäsentimeen, joka muuntaa tavalliset HTML-mallit WordPress-lohkomerkinnäksi. Se käsittelee automaattisesti sekä säilölohkoja, kuten ryhmiä ja sarakkeita, että lehtilohkoja, kuten kappaleita ja otsikoita. Jäsentimen renderöijäarkkitehtuuri perustuu piirteisiin, joten sitä on helppo laajentaa uusilla lohkotyypeillä blockstudio/parser/renderers-suodattimen kautta:

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

Kun lohko on rekisteröity, voit käyttää sitä minkä tahansa sivun tai kuvion mallissa:

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

Tallennus

Kenttien arvot voi nyt tallentaa lohkoattribuuttien lisäksi artikkelin metatietoihin tai sivuston asetuksiin. Tämä on iso uudistus:

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

Kun arvot ovat artikkelin metatiedoissa, voit:

  • Kysellä artikkeleita kenttien arvojen perusteella WP_Query– ja meta_query-toiminnoilla
  • Käyttää kenttätietoja REST API-rajapinnan kautta headless-asetuksissa
  • Jakaa tietoja muiden lisäosien, kuten SEO-työkalujen ja välimuistikerrosten kanssa

Voit myös tallentaa arvoja asetustauluun yleisiä, koko sivustoa koskevia asetuksia varten:

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

Katso täydelliset API-tiedot Storage-dokumentaatiosta.

Mukautetut kentät

Uudelleenkäytettäviä kenttämäärittelyjä voi nyt jakaa useiden lohkojen kesken. Määrittele kenttäjoukko kerran ja viittaa siihen mistä tahansa lohkosta. Näin vältät toiston, kun useilla lohkoilla on sama kenttärakenne.

Luo field.json blockstudio-hakemistoosi:

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

Viittaa siihen sitten mistä tahansa lohkosta custom/-etuliitteellä:

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

idStructure-ominaisuus lisää etuliitteen jokaiseen kenttätunnukseen, joten heading muuttuu muotoon hero_heading. Voit myös ohittaa yksittäisten kenttien ominaisuuksia lohkokohtaisesti overrides-avaimella.

Katso Custom Fields -dokumentaatio.

Tailwind CSS v4

Tailwind-tuki on rakennettu kokonaan uudelleen versiota v4 varten. Aiemmassa toteutuksessa (v6) koodi koottiin asiakaspuolella CDN-työkalulla ja tallennettiin levylle artikkelin tallennuksen yhteydessä. Nyt Blockstudio 7 kokoaa Tailwind-tyylit palvelimella jokaisella käyttöliittymäpyynnöllä TailwindPHP-toiminnon avulla. Ei Node.js- eikä CLI-riippuvuuksia eikä koontivaihetta.

Kokoaminen käyttää ehdokaspohjaista välimuistia: Blockstudio poimii kaikki CSS-luokkanimet lopullisesta HTML-sisällöstä, lajittelee ja tiivistää ne yhdessä CSS-asetustesi kanssa ja tarkistaa, löytyykö tiedosto välimuistista. Samat luokat osuvat samaan välimuistiin, vaikka ympäröivä HTML muuttuisi (nonce-arvot, aikaleimat tai dynaaminen sisältö).

Määrityksissä käytetään Tailwind v4 -kirjaston CSS-ensimmäistä syntaksia. Määrittele mukautetut teemat ja apuluokat suoraan blockstudio.json-tiedostossa tai blockstudio/tailwind/css-suodattimen kautta:

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

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

Lohkoeditorissa mukana toimitettava Tailwind CDN -skripti näyttää esikatselun kirjoittamisen aikana. classes-kenttätyyppi ehdottaa kaikkia Tailwind-apuohjelmia automaattisesti. Käyttöliittymässä käytetään aina palvelimella koottua CSS-tyylitiedostoa, joka lisätään sisäisenä style-tagina ennen </head>-elementtiä.

Katso täydelliset määritykset Tailwind-dokumentaatiosta.

Interaktiivisuus API

Blockstudio tukee nyt WordPress Interactivity API -toimintoa. Ota se käyttöön block.json-tiedostossa:

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

Lisää data-wp-*-direktiivit malliisi:

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>

Luo sitten script.js myymälälogiikkaa varten:

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

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

Blockstudio käsittelee importmapin, moduulien latauksen ja direktiivien käsittelyn sekä käyttöliittymässä että lohkoeditorissa. Pelkkiä deklaratiivisia direktiivejä data-wp-context-toiminnolla käyttävät lohkot, kuten data-wp-bind--hidden tai data-wp-text, toimivat ilman JavaScript-toimintoa. Myös palvelinpuolen tila wp_interactivity_state()-toiminnolla on tuettu käyttöliittymässä.

Katso täydelliset määritykset Interactivity-dokumentaatiosta.

SEO-sisällön analysointi

Blockstudio-lohkot ovat dynaamisia, joten niiden kenttien sisältö ei oletusarvoisesti näy SEO-lisäosille. Blockstudio 7 ratkaisee tämän lisäämällä automaattiset integraatiot lisäosille Yoast SEO, Rank Math ja SEOPress. Tekstiarvot kentistä text, textarea, richtext, wysiwyg ja link, myös sisäkkäisten toistinkenttien riveiltä, poimitaan ja välitetään kunkin lisäosan sisältöanalyysiin. SEO-lisäosat voivat nyt analysoida lohkosisältöä oikein esimerkiksi avainsanojen tiheyden, luettavuuden ja muiden mittareiden osalta. Määrityksiä ei tarvita.

Toistimen oletusrivit

Toistinkentillä voi nyt olla default-ominaisuus, jonka taulukossa määritellään valmiiksi täytetyt rivit. Kun lohko lisätään, toistin täytetään määritetyillä riveillä ja arvoilla sekä editorissa että käyttöliittymässä:

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

min-ominaisuus toimii myös kenttäkohtaisissa oletusarvoissa: jos toistimella on min: 3 ja sen sisäkentillä on default-arvot, automaattisesti luodut rivit täytetään näillä oletusarvoilla tyhjien rivien sijaan.

Parannukset ja korjaukset

  • Toistimen min ja kenttien oletusarvot: automaattisesti luotavat vähimmäisrivit käyttävät nyt kenttäkohtaisia oletusarvoja sekä käyttöliittymässä että editorissa
  • Tailwind-editorin tyylit: koottu Tailwind CSS lisätään nyt lohkoeditorin iframe-kehykseen yhdessä CDN-tyylien kanssa, joten mukautetut @apply-säännöt ja teemamääritykset toimivat editorissa
  • Tekoälyn kontekstitiedosto: blockstudio-llm.txt on rakennettu uudelleen staattiseksi tiedostoksi, joka kootaan täydellisestä v7-dokumentaatiosta ja deduplikoiduista JSON-skeemoista (noin 48k tokenia). Tämä korvaa dynaamisen luonnin lähteestä v6
  • Koodikentän erillisikkuna: koodikentän voi nyt avata erilliseen ikkunaan, jossa on oma kumoa- ja tee uudelleen -toiminto sekä JavaScript-syntaksin korostus
  • Tailwind v4 -kokoaminen palvelimella: katso yllä oleva Tailwind-osio
  • API versio 3: lohkot näkyvät nyt oikein iframe-editorissa, myös sivustoeditorissa ja mukautuvissa esikatseluissa
  • Resurssien piste-erottelu: selkeämpi tiedostonimien käytäntö resurssien päätteille (*.inline.css, *.editor.js, *.scoped.css)
  • Korjattu WP_Block_Supports-varoitus, joka liittyi bs_render_block()-toimintoon käytettäessä useBlockProps-toimintoa
  • Korjattu se, etteivät ehdolliset kentät käyttäneet oletusarvoja ensimmäisellä latauskerralla
  • Korjattu se, että dollarimerkit poistuivat <RichText />-sisällöstä käyttöliittymässä
  • Korjattu populate-ominaisuus toimimaan muiden lisäosien rekisteröimien taksonomioiden kanssa
  • Korjattu optionsPopulate-virhe WPML-tilanteissa

Konepellin alla

Täydellinen uudelleenkirjoitus

Kyse ei ole uudelleenjärjestelystä tai siivouksesta. Jokainen luokka on kirjoitettu alusta asti uudelleen. Tuloksena on selkeämpi ja modulaarisempi koodikanta, jota on helpompi ylläpitää ja laajentaa.

Moderni PHP

Blockstudio 7 edellyttää PHP 8.2+:aa ja käyttää kaikkialla moderneja tyyppimäärityksiä.

Rikkovat muutokset

Pääversion päivityksenä 7.0 sisältää useita rikkovia muutoksia. Useimmille on taaksepäin yhteensopivat vararatkaisut, mutta ne kannattaa tarkistaa ennen päivittämistä. Katso täydellinen siirto-opas v7-siirto-ohjeista.

Koukkujen nimet nyt snake_case-muodossa

Kaikkien PHP-koukkujen nimet on muutettu camelCase-muodosta snake_case-muotoon WordPress-ytimen käytäntöjen mukaisesti:

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

Vanhat camelCase-nimet toimivat edelleen, mutta suosittelemme päivittämään ne.

Kentän kytkin on oletusarvoisesti pois päältä

switch-ominaisuuden oletusarvo on nyt false aiemman true-arvon sijaan. Versiossa v6 jokaisessa kentässä oli näkymätön kytkin vasemmassa reunassa, ja se oli oletusarvoisesti päällä. Versiossa v7 kytkin on valinnainen, ja se näkyy silmäkuvakkeena kentän nimessä. Jos luotit kytkimen oletustoimintaan, lisää "switch": true kenttämäärittelyihisi.

Resurssitiedostojen nimissä käytetään piste-erottelua

Resurssien päätteissä käytetään nyt pisteitä viivojen sijaan (style.inline.css aiemman style-inline.css-muodon sijaan). Vanha viivamerkintä toimii edelleen, mutta jatkossa suositellaan piste-erottelua.

npm-tuonnin etuliite

ES-moduulien tuonneissa käytetään nyt npm: aiemman blockstudio/-etuliitteen sijaan:

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

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

blockstudio/-etuliitettä tuetaan edelleen taaksepäin yhteensopivuuden vuoksi.

Poistetut ominaisuudet

Hallinta-alue ja koodieditori. WordPress-lisäosan hallinta-asetussivu ja sisäänrakennettu lohkojen koodieditori on poistettu. Kaikki määritykset tehdään nyt blockstudio.json– ja PHP-suodattimien kautta, joten asetukset pysyvät versiohallinnassa lohkojen rinnalla.

Koodieditori oli hyödyllinen lohkojen esikatseluun aiemmissa versioissa, mutta se ei koskaan vastannut ominaisuuksiltaan varsinaista kehitysympäristöä. Vuosien varrella useita lisäosan ominaisuuksia jäi vajaiksi, koska niitä ei voitu tukea erillisessä editorissa. Se ei myöskään olisi koskaan voinut korvata täysimittaista IDE:tä. Sen poistaminen antaa lisäosalle mahdollisuuden keskittyä yksinomaan tiedostopohjaiseen kehitykseen ilman kompromisseja.

Lisenssiavain. Ei enää tarvita. Blockstudio on ilmainen ja avoimen lähdekoodin.

Lohkokirjasto. Sisäänrakennettu “Blockstudio Elements” -kirjasto (Gallery, Slider, Image Comparison, Code, Icon) on poistettu. Nämä olivat lisäosan mukana toimitettuja valmiita esimerkkilohkoja. Jos käytit niitä, kopioi lohkokansiot sijainnista v6 teemasi blockstudio-hakemistoon.

Aloittaminen

Asenna Blockstudio 7 ja luo ensimmäinen lohkosi muutamassa minuutissa. Katso vaiheittainen opastus Aloitusoppaasta tai v7-siirto-oppaasta, jos päivität versiosta v6.

Koko lähdekoodi on osoitteessa GitHub. Tervetuloa ilmoittamaan ongelmista, lähettämään PR:iä ja antamaan palautetta.