Pāriet uz saturu

Dennis · 2026. gada 7. februāris

Introducing Blockstudio 7

Blockstudio 7 ir klāt. Šis ir lielākais laidiens projekta vēsturē: visa koda bāze ir pilnībā pārrakstīta no pašiem pamatiem. Katra klase, katrs āķis, katra koda rinda ir izveidota no jauna, īpašu uzmanību pievēršot mūsdienu PHP, WordPress kodēšanas standartiem un ilgtermiņa uzturamībai.

Taču tas nav tikai koda pārstrukturēšanas darbs. Blockstudio 7 piedāvā būtiskas jaunas iespējas, piemēram, failos balstītas lapas un rakstus, ziņu meta datu glabāšanas sistēmu, SEO integrāciju un pavisam jaunu HTML-bloku parsētāju, kas nodrošina visu šo funkcionalitāti. Turklāt Blockstudio tagad ir pilnīgi bezmaksas un ar atvērtu pirmkodu.

Apskatīsim visu jauno.

Bezmaksas un ar atvērtu pirmkodu

Esmu strādājis pie Blockstudio kopš 2020 un gadu gaitā izlaidis desmitiem versiju. Lietotājiem tas patika, taču atrast komerciālam WordPress bloku ietvaram atbilstošu tirgu vienmēr bija sarežģīti.

Situāciju mainīja LLM. MI programmēšanas palīgi tagad spēj pietiekami labi rakstīt bloku kodu, taču darbam tiem nepieciešamas skaidras, failos balstītas struktūras. WordPress bloku iezīmējums ir sarežģīts: serializēti HTML komentāri ar iegultiem JSON atribūtiem, kas apvienoti ar DOM struktūru. Cilvēkiem to ir grūti saprast, bet LLM vēl grūtāk ir to uzrakstīt pareizi.

Blockstudio pieeja, kurā vispirms tiek izmantoti faili, jau sākotnēji bija iecerēta vienkāršai lietošanai: mape ar block.json un PHP veidni. Nav datubāzes ierakstu, nav React, nav veidošanas darbības. Ar v7 šī pieeja tiek attīstīta vēl tālāk. HTML-bloku parsētājs ļauj rakstīt vienkāršu HTML un automātiski pārveidot to derīgā bloku iezīmējumā. Viss paliek failu sistēmā. Datubāzē tiek rakstīts tikai tad, kad tiek veikta lapu sinhronizācija, ko pieprasāt ar PHP API vai CLI, un tās pamatā ir failu veidnes.

Blockstudio pirmkoda atvēršana ir likumsakarīgs nākamais solis. Jo vairāk LLM tiek apmācīti ar Blockstudio kodu, jo labāk tie to ģenerē. Atvērta koda bāze, atvērta dokumentācija un jau sagatavots MI konteksta fails, ko var izmantot jebkurš rīks: tā var izveidot labāko vidi MI atbalstītai WordPress izstrādei.

Pilns spraudnis ir pieejams vietnē GitHub ikvienam, kas vēlas to izmantot, veidot atzarojumus un sniegt ieguldījumu. Nav licences atslēgu, maksas sienu vai ierobežotu iespēju.

Jaunās funkcijas

Failos balstītas lapas

Šis ir viens no lielākajiem 7.0 papildinājumiem. Tagad visas WordPress lapas var definēt kā failu veidnes, kas pēc lapu sinhronizācijas API vai CLI izsaukšanas tiek sinhronizētas ar datubāzi kā bloku pamatdaļas saturs.

Izveidojiet mapi ar page.json un veidnes failu:

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>

Palaidiet wp bs pages sync, lai Blockstudio parsētu HTML par WordPress blokiem un izveidotu vai atjauninātu lapu datubāzē.

Bloku apvienošana pēc atslēgas

Sinhronizējot veidnes, lietotāju veiktās izmaiņas parasti tiktu pārrakstītas. key atribūts to novērš, saglabājot lietotāju saturu sinhronizācijas laikā:

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

Bloki ar vienādām atslēgām pēc veidnes atjaunināšanas saglabā lietotāja rediģēto saturu. Bloki bez atslēgām tiek pilnībā aizstāti.

Bloku piesaiste

Kā alternatīvu atslēgām varat izmantot WordPress pamatdaļas Block Bindings API, lai blokus tieši savienotu ar ziņas meta datiem. Šī nav Blockstudio funkcija, bet gan sākotnēji iebūvēta WordPress API. Blockstudio vienkārši pārsūta metadata atribūtu uz ģenerēto bloku iezīmējumu. Saturs atrodas meta datos, nevis bloku iezīmējumā, tāpēc veidņu sinhronizācija nekad neizdzēš lietotāja veiktās izmaiņas. Datiem var arī veikt vaicājumus, izmantojot WP_Query, un tie ir pieejami ar REST API.

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

Vienā veidnē var izmantot abas pieejas.

Rediģēšanas ierobežojumi

Lapās var izmantot blockEditingMode un templateLock, lai noteiktu, ko lietotāji drīkst mainīt:

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

Tas fiksē lapas struktūru, vienlaikus ļaujot lietotājiem rediģēt tekstu un multividi. Veidnes atsevišķiem elementiem var norādīt citu iestatījumu, izmantojot blockEditingMode atribūtu.

Piesaistīšana ziņas ID

Izmantojiet postId, lai piesaistītu lapas veidni esošai WordPress ziņai. Tas novērsīs dublētas lapas un nodrošinās, ka veidne vienmēr atjaunina pareizo ziņu:

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

Pilnu informāciju skatiet Lapu dokumentācijā.

Failos balstīti raksti

Tāpat kā lapas, arī bloku rakstus tagad var definēt kā failu veidnes. Ierakstiet rakstu HTML, un Blockstudio to parsēs par bloku iezīmējumu un reģistrēs kā sākotnēji iebūvētu WordPress bloku rakstu. Tas būs pieejams bloku ievietotājā, un lietotāji to varēs ievietot jebkurā vietā.

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>

Atšķirībā no lapām raksti neveido datubāzes ierakstus. Tie tiek reģistrēti atmiņā, ielādējot katru lapu. Skatiet Rakstu dokumentāciju.

HTML-bloku parsētājs

Abu veidu — lapu un rakstu — darbību nodrošina jaunais HTML parsētājs, kas standarta HTML veidnes pārveido par WordPress bloku iezīmējumu. Tas automātiski apstrādā gan konteineru blokus (piemēram, grupas un kolonnas), gan atsevišķus blokus (piemēram, rindkopas un virsrakstus). Parsētājā izmantotā renderētāja arhitektūra balstās trait, tāpēc to var viegli paplašināt ar papildu bloku tipiem, izmantojot filtru blockstudio/parser/renderers:

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ēc reģistrēšanas šo bloku var izmantot jebkurā lapas vai raksta veidnē:

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

Krātuve

Lauku vērtības tagad var glabāt ziņu meta datos vai vietnes opcijās, kā arī bloku atribūtos. Šis ir būtisks papildinājums:

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

Glabājot vērtības ziņu meta datos, varat:

  • meklēt ziņas pēc lauku vērtībām, izmantojot WP_Query un meta_query
  • piekļūt lauku datiem, izmantojot REST API bezgalvenes iestatījumos
  • kopīgot datus ar citiem spraudņiem, piemēram, SEO rīkiem, un kešatmiņas slāņiem

Globālus vietnes iestatījumus var glabāt arī opciju tabulā:

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

Pilnu informāciju skatiet Glabāšanas dokumentācijā par API.

Pielāgoti lauki

Atkārtoti izmantojamas lauku definīcijas tagad var koplietot vairākos blokos. Vienreiz definējiet lauku kopu un pēc tam atsaucieties uz to jebkurā blokā. Tas novērš satura atkārtošanos, ja vairākos blokos ir vienāda lauku struktūra.

Izveidojiet field.json savā blockstudio direktorijā:

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

Pēc tam atsaucieties uz to jebkurā blokā, izmantojot prefiksu custom/:

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

Īpašība idStructure pievieno prefiksu katram lauka ID, tāpēc heading kļūst par hero_heading. Varat arī katram gadījumam atsevišķi mainīt lauka īpašības, izmantojot atslēgu overrides.

Skatiet Pielāgoto lauku dokumentāciju.

Tailwind CSS v4

Tailwind atbalsts ir pilnībā pārveidots lietošanai ar v4. Iepriekš tas tika kompilēts klienta pusē, izmantojot CDN, un saglabāts diskā pēc ziņas saglabāšanas (pieeja v6). Savukārt Blockstudio 7 katrā priekšgala pieprasījumā kompilē Tailwind servera pusē, izmantojot TailwindPHP. Nav Node.js, nav CLI, nav vajadzīga veidošanas darbība.

Kompilēšanā tiek izmantota kandidātos balstīta kešošana: Blockstudio izgūst visus CSS klases nosaukumus no gala HTML, sakārto tos un aprēķina to jaucējvērtības kopā ar jūsu CSS konfigurāciju, pēc tam meklē kešatmiņā saglabātu failu. Vienādas klases nodrošina to pašu kešatmiņas trāpījumu pat tad, ja mainās apkārtējais HTML (nonce vērtības, laika zīmogi, dinamisks saturs).

Konfigurācijā tiek izmantota Tailwind v4 sintakse, kurā vispirms norāda CSS. Definējiet pielāgotus motīvus un utilītklases tieši savā blockstudio.json vai izmantojot filtru blockstudio/tailwind/css:

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

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

Bloku redaktorā komplektā iekļautais Tailwind CDN skripts teksta ievades laikā nodrošina reāllaika priekšskatījumu. Lauka tips classes piedāvā automātisko pabeigšanu visām Tailwind utilītklasēm. Priekšgalā vienmēr tiek izmantots serverī kompilētais CSS, kas ievietots kā iekļauts stila tags pirms </head>.

Pilnu iestatīšanas aprakstu skatiet dokumentācijā Tailwind.

Interaktivitāte API

Blockstudio tagad atbalsta WordPress Interactivity API. Iespējojiet to savā block.json:

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

Veidnei pievienojiet data-wp-* direktīvas:

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>

Izveidojiet script.js ar veikala loģiku:

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

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

Blockstudio apstrādā importmap, moduļu ielādi un direktīvu apstrādi gan priekšgalā, gan bloku redaktorā. Bloki, kuros izmantotas tikai deklaratīvās direktīvas ar data-wp-context, piemēram, data-wp-bind--hidden vai data-wp-text, darbojas bez jebkāda JavaScript. Priekšgalā tiek atbalstīts arī servera puses stāvoklis, izmantojot wp_interactivity_state().

Pilnu iestatīšanas aprakstu skatiet Interactivity dokumentācijā.

SEO satura analīze

Blockstudio bloki ir dinamiski, tāpēc to lauku saturs pēc noklusējuma nav redzams SEO spraudņiem. Blockstudio 7 to atrisina ar automātiskām integrācijām ar Yoast SEO, Rank Math un SEOPress. Teksta vērtības no text, textarea, richtext, wysiwyg un link laukiem, tostarp ligzdotām atkārtotāja rindām, tiek izgūtas un nodotas katra spraudņa satura analīzei. SEO spraudņi tagad var pienācīgi analizēt bloku saturu pēc atslēgvārdu blīvuma, lasāmības un citiem rādītājiem. Konfigurācija nav nepieciešama.

Atkārtotāja noklusējuma rindas

Atkārtotāja laukiem tagad var norādīt īpašību default ar iepriekš aizpildītu rindu masīvu. Ievietojot bloku, atkārtotāja lauks gan redaktorā, gan priekšgalā tiek aizpildīts ar norādītajām rindām un to vērtībām:

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

Īpašība min darbojas arī kopā ar lauku noklusējuma vērtībām: ja atkārtotājam ir min: 3 un tā iekšējiem laukiem ir default vērtības, automātiski ģenerētās rindas būs aizpildītas ar šīm noklusējuma vērtībām, nevis tukšas.

Uzlabojumi un labojumi

  • Atkārtotāja min ar lauku noklusējuma vērtībām: minimālais automātiski ģenerēto rindu skaits tagad tiek aizpildīts ar lauku noklusējuma vērtībām gan priekšgalā, gan redaktorā
  • Tailwind redaktora stili: kompilētais Tailwind CSS tagad tiek ievadīts bloku redaktora iframe kopā ar CDN, tāpēc redaktorā darbojas pielāgotie @apply noteikumi un motīva konfigurācija
  • MI konteksta fails: blockstudio-llm.txt ir pārveidots par statisku failu, kas izveidots no pilnas v7 dokumentācijas un dublētām JSON shēmām (~48k tokeni); tas aizstāj dinamisko ģenerēšanu no v6
  • Koda lauka atvēršana atsevišķā logā: koda lauku tagad var atvērt atsevišķā logā ar neatkarīgām atsaukšanas un atkārtošanas darbībām, kā arī JavaScript sintakses izcelšanu
  • Tailwind v4 kompilēšana servera pusē: skatiet iepriekšējo sadaļu Tailwind sadaļā
  • API 3. versija: bloki tagad tiek pareizi renderēti redaktorā ar iframe, tostarp vietnes redaktorā un adaptīvajos priekšskatījumos
  • Punktu pieraksts aktīvu failos: skaidrāks failu nosaukumu pieraksts aktīvu sufiksiem (*.inline.css, *.editor.js, *.scoped.css)
  • Labots bs_render_block() brīdinājums no WP_Block_Supports, lietojot useBlockProps
  • Labots nosacīto lauku atbalsts, lai tie pirmajā ielādē ņemtu vērā noklusējuma vērtības
  • Labota dolāra zīmju noņemšana no <RichText /> satura priekšgalā
  • Labota funkcija populate, lai tā darbotos ar citu spraudņu reģistrētajām taksonomijām
  • Labota optionsPopulate nulles vērtības kļūda kontekstā WPML

Kas notiek aizkulisēs

Pilnīga pārrakstīšana

Šī nav koda pārstrukturēšana vai sakopšana. Katra klase ir pārrakstīta no jauna. Rezultātā iegūta tīrāka un modulārāka koda bāze, kuru ir vieglāk uzturēt un paplašināt.

Mūsdienu PHP

Blockstudio 7 nepieciešama PHP 8.2+ versija, un visur tiek izmantotas mūsdienīgas tipu deklarācijas.

Nesaderīgas izmaiņas

Kā būtiskas versijas atjauninājums 7.0 ietver vairākas nesaderīgas izmaiņas. Lielākajai daļai ir atpakaļsaderības rezerves risinājumi, tomēr pirms atjaunināšanas tās jāpārskata. Pilnu migrācijas ceļvedi skatiet v7 migrācijas dokumentācijā.

Āķu nosaukumos tagad izmanto snake_case

Visu PHP āķu nosaukumi ir mainīti no camelCase uz snake_case, lai tie atbilstu WordPress pamatdaļas konvencijām:

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

Vecie camelCase nosaukumi joprojām darbojas, taču iesakām tos atjaunināt.

Lauka slēdzis pēc noklusējuma ir izslēgts

Īpašības switch noklusējuma vērtība tagad ir false, nevis true. v6 katram laukam kreisajā malā bija neredzams slēdzis, kas pēc noklusējuma bija ieslēgts. v7 slēdzis jāiespējo atsevišķi, un tas ir attēlots ar redzamu acs ikonu lauka etiķetē. Ja paļāvāties uz slēdža darbību pēc noklusējuma, pievienojiet lauku definīcijām "switch": true.

Aktīvu failu nosaukumos izmanto punktu pierakstu

Aktīvu sufiksos tagad izmanto punktus, nevis defises (style.inline.css nevis style-inline.css). Vecais pieraksts ar defisēm joprojām darbojas, taču turpmāk ieteicams lietot punktu pierakstu.

npm importēšanas prefikss

ES moduļu importos tagad izmanto npm:, nevis blockstudio/:

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

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

Prefikss blockstudio/ joprojām tiek atbalstīts atpakaļsaderības dēļ.

Noņemtās funkcijas

Administrēšanas apgabals un koda redaktors. WordPress administrēšanas iestatījumu lapa un iebūvētais bloku koda redaktors ir noņemti. Visa konfigurēšana tagad notiek, izmantojot filtrus blockstudio.json un PHP, tāpēc iestatījumi tiek glabāti versiju vadības sistēmā kopā ar blokiem.

Iepriekšējās versijās koda redaktors noderēja bloku priekšskatīšanai, taču tā iespējas nekad nesasniedza reālas izstrādes vides līmeni. Gadu gaitā vairākas spraudņa funkcijas netika pilnveidotas, jo tās nebija iespējams atbalstīt atsevišķajā redaktorā. Tas arī nekad nevarēja aizstāt pilnvērtīgu IDE. Redaktora noņemšana ļauj spraudnim pilnībā pievērsties failos balstītai izstrādei bez kompromisiem.

Licences atslēga. Vairs nav nepieciešama. Blockstudio ir bezmaksas un ar atvērtu pirmkodu.

Bloku bibliotēka. Iebūvētā bibliotēka “Blockstudio Elements” (galerija, slīdnis, attēlu salīdzināšana, kods, ikona) ir noņemta. Tie bija iepriekš izveidoti piemēru bloki, kas tika iekļauti spraudnī. Ja tos izmantojāt, kopējiet bloku mapes no v6 uz sava motīva blockstudio direktoriju.

Darba sākšana

Instalējiet Blockstudio 7 un dažu minūšu laikā izveidojiet savu pirmo bloku. Skatiet pamācību Darba sākšanas rokasgrāmata, kurā sniegtas detalizētas instrukcijas, vai v7 migrācijas ceļvedi, ja jaunināt no v6.

Pilns pirmkods ir pieejams vietnē GitHub. Gaidām ziņojumus par kļūdām, PR un atsauksmes.