Radīts tiem, kas veic rediģēšanu
Plašāks lauku sānu panelis, rīkjoslas vadīklas, redaktora politikas un administrācijas paneļa saraksts, konfigurēti sadaļās block.json un blockstudio.json.
Vieta ikvienam laukam
Atkārtotāji, koda lauki un ligzdotas grupas sānjoslā ir saspiesti. Bloka galvenē ir poga Open Expanded Editor, kas atver tos pašus laukus plašākā panelī labajā pusē. Nospiežot Gatavs, uz fona vai Esc, panelis aizveras, un bloks paliek atlasīts.
Tas pats lauku renderētājs ieraksta tos pašus atribūtus, tāpēc priekšskatījums atjauninās rakstīšanas laikā, un nav nepieciešams iestatījums block.json. Laukus, kam jāatrodas blakus saturam, var pārvietot uz bloka rīkjoslu, izmantojot "position": "toolbar".
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "alignment",
"type": "select",
"label": "Alignment",
"position": "toolbar",
"options": [
{ "value": "left", "label": "Left" },
{ "value": "center", "label": "Center" },
{ "value": "right", "label": "Right" }
]
},
{
"id": "title",
"type": "text",
"label": "Title"
}
]
}
}Automātiskā pabeigšana no jūsu CSS
Uzskaitiet stilu lapu URL adreses blockEditor.cssClasses un cssVariables; klašu un koda lauki palīdz noteikt, ko šie faili definē.
Norādes, virzot kursoru un atlasot
Iestatiet blockEditor.enhance, lai redaktorā pievienotu Blockstudio norādes, virzot kursoru un atlasot.
Kam ir piekļuve redaktoram
users.ids un users.roles sadaļā blockstudio.json norāda to lietotāju ID un lomas, kuriem ir Blockstudio redaktora piekļuve.
Jūsu klienta valodā
Lauku vadīklas, administrēšanas ekrāns un kanva izmanto vietnes valodu vai katra lietotāja profila valodu, izmantojot komplektā iekļautos tulkojumus.
Tikai redaktoram paredzētie resursi
editor.assets failā blockstudio.json uzskaita papildu resursus, kas jāielādē redaktorā.
Multivide sākotnējā datu paketē
Failu lauki nolasa pielikumu datus no sākotnējās redaktora datu paketes, tostarp ligzdotās grupās, cilnēs un atkārtotājos, pirms pieprasa tos no multivides galapunkta.
Vienlaikus tikai viens priekšskatījuma pieprasījums
Ja blokam tiek pieprasīts jaunāks priekšskatījums, pārlūkprogrammā iepriekšējais pieprasījums tiek atcelts, bet pašreizējais priekšskatījums tikmēr paliek ekrānā.
Katrs bloks saglabā savas vērtības
Vairākatlases bloki saglabā katrs savas vērtības, un atsaukšana un atjaunošana attiecas arī uz RichText un sānjoslas laukiem.
Izslēdziet lauku, saglabājiet tā vērtību
Redaktors var izslēgt lauku inspektorā: virziet kursoru gar tā kreiso malu, līdz parādās zilā apmale, un pēc tam noklikšķiniet. Lauks kļūst caurspīdīgs, tā vērtība paliek saglabāta, un bloks pārstāj to renderēt, līdz kāds to atkal ieslēdz.
Tas pats darbojas atsevišķiem vienumiem failu laukā, tāpēc vienu attēlu var paslēpt, kamēr pārējie ir redzami. Iestatiet "switch": true, lai laukam pievienotu redzamu pārslēgu, un nolasiet $a['_disabled'], ja veidnei tas jāzina.
{
"name": "acme/card",
"title": "Card",
"blockstudio": {
"attributes": [
{
"id": "title",
"type": "text",
"label": "Title",
"switch": true
}
]
}
}<?php if (!empty($a['_disabled']) && in_array('title', $a['_disabled'])) : ?>
<p>No title on this one.</p>
<?php else : ?>
<h1><?php echo esc_html($a['title']); ?></h1>
<?php endif; ?>Priekšskatījums bloku ievietotājā
Pievienojiet atslēgu example pie block.json, un bloks tiks priekšskatīts, kad redaktors bloku ievietotājā novietos uz tā kursoru. Blokam, kas labi izskatās ar noklusējuma iestatījumiem, pietiek ar tukšu objektu.
Piešķiriet example.attributes savu lauku paraugu vērtības vai example.innerBlocks sākuma koku blokam, kas ietver citus blokus.
{
"name": "my-theme/hero",
"title": "Hero",
"category": "text",
"example": {
"attributes": {
"title": "This title will be shown in the preview"
}
},
"blockstudio": true
}<h1><?php echo esc_html($a['title']); ?></h1>Redaktora politika vienā failā
Nosakiet, ko piedāvā bloku ievietotājs, neizmantojot motīva palīgkodu. blockEditor.blocks pieņem atļaušanas un liegšanas sarakstus ar aizstājējzīmēm, piemēram, core/*, pārdēvē un pārkārto kategorijas, noņem sadaļā PHP reģistrētos bloku stilus, paslēpj mantotos logrīkus un var izslēgt bloku direktoriju.
blockEditor.patterns ieslēdz vai izslēdz galveno, attālo, motīva un Blockstudio rakstu avotu, kā arī filtrē to kategorijas. blockEditor.media izslēdz Openverse un ierobežo attēlu izmērus, ko redaktori var izvēlēties.
{
"blockEditor": {
"blocks": {
"allow": ["core/*", "my-theme/*"],
"deny": ["core/embed", "core/freeform"],
"directory": false,
"categories": {
"rename": { "text": "Writing" },
"order": ["my-theme", "text", "media"]
},
"styles": {
"deny": { "my-theme/card": ["outline"] }
},
"legacyWidgets": { "hide": ["archives", "calendar"] }
},
"patterns": {
"core": false,
"remote": false,
"categories": { "deny": ["gallery"] }
},
"media": {
"openverse": false,
"imageSizes": { "allow": ["thumbnail", "large"] }
}
}
}Ātra sākotnējā attēlošana
Blockstudio bloki tiek renderēti serverī. Redaktors iepriekš ielādē ziņā jau esošo bloku renderēto izvadi, tostarp sinhronizēto rakstu ligzdotos blokus, un izmanto to sākotnējai attēlošanai, nevis sūta renderētāja pieprasījumu katram saglabātajam blokam.
Kods, klases, atribūti un WYSIWYG vadīklas tiek lejupielādētas, kad tās parādās pirmoreiz, tāpēc neatlasītie bloki tās neielādē. Bloks, kam nav nepieciešams tiešraides priekšskatījums, var iestatīt disableLoading un rādīt vietturi, vienlaikus saglabājot visu lauku rediģējamību.
{
"name": "my-theme/map",
"title": "Map",
"blockstudio": {
"blockEditor": {
"disableLoading": true
}
}
}{
"blockEditor": {
"disableLoading": true
}
}Priekšskatījumi darbojas tāpat kā lapa
Interactivity API tiek ielādēts redaktora iframe, tāpēc data-wp-context, saistījumi, notikumu apstrādātāji un jūsu krātuves darbības darbojas kanvā. Komplektā iekļautie bsui/* komponenti balstās uz to, tāpēc rediģēšanas laikā dialoglodziņš atveras un nolaižamā izvēlne tiek izvērsta.
Saites priekšskatījumā nekad nenovirza prom, ja uz tām noklikšķina, atver ar modificēšanas taustiņu vai aktivizē no tastatūras, un klikšķis joprojām atlasa bloku. Izmantojot assets.reset.enabled, motīva body klases tiek kopētas uz kanvu, tāpēc arī tur atbilst tādi selektori kā .brand-a .site-card.
{
"name": "my-theme/disclosure",
"title": "Disclosure",
"blockstudio": {
"interactivity": true
}
}<?php
add_filter('blockstudio/editor/canvas/body_class', function (array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});Inventārs sadaļā Tools > Blockstudio
Administrēšanas ekrānā ir uzskaitīts, ko Blockstudio reģistrēja no failu sistēmas: blokus, paplašinājumus, laukus, lapas un to sinhronizācijas statusu, kā arī db.php shēmas, kas attēlotas vietējās WordPress DataViews tabulās. Skatā “Databases” var pārlūkot katras shēmas ierakstus, kas tiek iegūti un sadalīti lappusēs, izmantojot REST API.
Ja motīva blocks.json nosauc reģistrus, reģistru skatā ir uzskaitīti to bloki, un tos var importēt bloku mapē no wp-admin. Ekrāns ir pieejams lietotājiem ar manage_options, bet filtrs blockstudio/admin/enabled to izslēdz.
{
"$schema": "https://blockstudio.dev/schema/blocks.json",
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json"
}
}<?php
add_filter('blockstudio/admin/enabled', '__return_false');Oficiālais paplašinājumu komplekts
Premium vietņu veidnes, AI sistēmas instrukcijas un privāta Discord kopiena. Vienreizējs pirkums, atjauninājumi uz mūžu.
- 500+ vietņu veidnes
- AI sistēmas instrukcijas
- Atjauninājumi visā lietošanas laikā
- Privāta Discord kopiena