
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](https://blockstudio.dev/fi/docs/dev/ai/), jota mikä tahansa työkalu voi hyödyntää: näin luodaan paras ympäristö tekoälyavusteiseen WordPress-kehitykseen.

Koko lisäosa on saatavilla [GitHub](https://github.com/inline0/blockstudio), 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 title="page.json"
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
```

```php title="index.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 title="index.php"
<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](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) -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 title="index.php"
<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 title="page.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 title="page.json"
{
  "name": "home",
  "title": "Home",
  "postId": 2
}
```

Katso lisätietoja [Pages-dokumentaatiosta](https://blockstudio.dev/fi/docs/pages-and-patterns/pages/).

### 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 title="pattern.json"
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
```

```html title="index.php"
<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](https://blockstudio.dev/fi/docs/pages-and-patterns/patterns/).

### 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 title="functions.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 title="index.php"
<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 title="block.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 title="block.json"
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}
```

Katso täydelliset API-tiedot [Storage-dokumentaatiosta](https://blockstudio.dev/fi/docs/blocks/storage/).

### 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 title="fields/hero/field.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 title="block.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](https://blockstudio.dev/fi/docs/blocks/attributes/custom-fields/).

### 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](https://github.com/dnnsjsk/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 title="functions.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](https://blockstudio.dev/fi/docs/tailwind/).

### Interaktiivisuus API

Blockstudio tukee nyt [WordPress Interactivity API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/) -toimintoa. Ota se käyttöön block.json-tiedostossa:

```json title="block.json"
{
  "blockstudio": {
    "interactivity": true
  }
}
```

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

```php title="index.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 title="script.js"
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](https://blockstudio.dev/fi/docs/blocks/interactivity/).

### 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 title="block.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](https://blockstudio.dev/fi/docs/dev/ai/)**: `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](#tailwind-css-v4)
- **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](https://blockstudio.dev/fi/docs/dev/migration/v7/).

### 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 title="functions.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 title="script.js"
// 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](https://blockstudio.dev/fi/docs/general/getting-started/) tai [v7-siirto-oppaasta](https://blockstudio.dev/fi/docs/dev/migration/v7/), jos päivität versiosta v6.

Koko lähdekoodi on osoitteessa [GitHub](https://github.com/inline0/blockstudio). Tervetuloa ilmoittamaan ongelmista, lähettämään PR:iä ja antamaan palautetta.
