Lõuend
Lõuend annab kõigist Blockstudio hallatavatest lehtedest suurendatud väljavaatega Figma-laadse ülevaate. Iga leht kuvatakse ühel horisontaalsel real reaalajas uueneva iframe-pinnana. Liigutage vaadet puuteplaadiga ning suumige näpistamise või Ctrl+kerimisega.
Aktiveerimine
Lõuend on saadaval peidetud halduslehena. Liikuge järgmisele aadressile:
/wp-admin/admin.php?page=blockstudio-canvas
Lehele pääseb ainult siis, kui dev.canvas.enabled on true ja praegusel kasutajal on võimekus edit_posts.
Seaded
Lülitage lõuend sisse ja seadistage selle käitumine oma teema blockstudio.json-is:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
| Atribuut | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enabled |
boolean |
false |
Lülitab lõuendifunktsiooni sisse. |
adminBar |
boolean |
true |
Kuvab iframe’ides oleval lõuendil WordPress haldusriba. Puhtama eelvaate jaoks määrake väärtuseks false. |
Mõlemad sätted on saadaval ka filtritena:
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');
Vaated
Vaadete vahel saate vahetada paremas ülanurgas asuva rippmenüü kaudu.
- Lehed: kõik Blockstudio hallatavad lehed kuvatakse ühel real täislaiuses lõuenditena.
- Plokid: kõik registreeritud Blockstudio plokid kuvatakse ruudustikuna, igaüks vaikeatribuudi väärtustega.
Avalik sisuloend ja dokumendi API
Canvas avaldab versioonitud ja tarbijaneutraalse PHP lepingu tööriistadele, mis vajavad sama registreeritud sisu, kuid ei soovi uuesti luua Blockstudio tuvastus- ega renderdusloogikat:
use Blockstudio\Canvas;
$all = Canvas::inventory();
$changed = Canvas::inventory([
'blocks' => ['theme/hero'],
'pages' => ['about'],
]);
$documents = Canvas::documents([
'patterns' => ['theme/featured'],
'templates' => ['front-page'],
]);
Praegune versioon on saadaval kujul Canvas::SCHEMA_VERSION. Sisuloendi tulemused sisaldavad järgmist:
inventory: normaliseeritudpages,blocks,patterns,templates,partsja avalikeuiperekondade näitedorder: stabiilne tüüpideülene kuvamisjärjekordsources: täpselt valitud lähtefailide teed koos iga kirje päritoluteabega; lehe kirjesourceon selle stabiilne allikaidentiteet, samas kuipathon füüsilise renderdusmalli teewarningsjaerrors: väljastatud väljundi asemel struktureeritud probleemiddeleted: taotletud identifikaatorid, mida enam ei eksisteeriselection: normaliseeritud valik ja teave selle kohta, kas see oli sihitud
Canvas::documents() lisab iga valitud kirje kohta ühe täieliku renderdusdokumendi. Iga dokument sisaldab sisu, koostatud HTML-i, sõltuvustest suletud plokinimesid ning täpseid CSS-i, JavaScript-i, mooduleid, interaktiivsuse alglaadimist, komplekteeritud UI globaale ja Tailwind väljundit. Lehedokumendid kasutavad semantilist <main> sisumähist; helistajad saavad seda jagatud renderdusdokumendi suvandite kaudu muuta või välja lülitada. Iga valitud leht renderdatakse eraldi taastatud esiotsa WordPress kontekstis, nii et päringutingimused, body-klassi filtrid, lühikoodid, paigutused, ümbersuunamised ja wp_enqueue_scripts tagasihelistused käitlevad seda lehte, mitte haldus- ega REST päringut, mis lõuenditulemust taotles. Helistaja antud body-klassid liidetakse lehe kontekstiklassidega ja esiotsa laadimisregistrid on dokumentide vahel isoleeritud. Lõuend lahendab need elutsükli tagasihelistused avalike WordPress funktsiooninimede järgi, nii et sama kontekst säilib ka siis, kui Blockstudio laaditakse Composer kaudu või ümberpaigutatud rakenduse nimeruumis.
Täpse valiku semantika
Valik on range:
- Kui tuvastatavaid tüübi võtmeid pole, laaditakse kõik tüübid.
true,nullvõi"*"laadib kõik seda tüüpi kirjed.- Stringi või loendiga laaditakse ainult täpsed ID-d, nimed, püsilingid, teed või lähtefailide teed.
- Tühja stringi, tühja loendi või
falsekorral ei laadita seda tüüpi kirjeid. - Kui olemas on vähemalt üks tüübi võti, siis vahele jäetud tüüpe ei tuvastata, sünkroonita, renderdata ega kompileerita.
Nii on ainult muudetud sisu päringud suurte projektide korral ohutud. Olemasolevad plokid ja lehed leitakse kanooniliste registrite kaudu. Kui esiotsa päringus on laaditud ainult püsiv leheprojektsioon, tuvastab lõuend lähteandmed kirjutuskaitstult ning liidab sobivad postituse ID-d ja püsilingid sisu sünkroonimata. Sama identiteetide liitmine toimub siis, kui loogiline tuvastusallikas täidab esmalt allikapõhise registri, nii et lehe kontekstipõhine renderdus kasutab endiselt sobivat hallatavat WordPress postitust. Uus aktiivse seansi topoloogia tuvastatakse ainult muudetud kataloogi ümbruses, valitud mustrite ja Site Editori mallide allikad kompileeritakse aga alles pärast valimist.
REST värskendusotspunkt järgib sama reeglit olemasolevate päringuparameetrite blocks ja pages puhul. Näiteks tagastab ?blocks=theme/hero selle ploki ega tagasta ühtegi lehte; segavastuse saamiseks kasutage mõlemat parameetrit. Kui otspunkti kutsutakse ilma kummagi parameetrita, tagastatakse täielik pärandvastus.
Otsevaade
Otsevaade kasutab serveri saadetud sündmusi (SSE), et tuvastada failimuudatusi ja värskendada lõuendit reaalajas. Plokimalli, lehemalli või stiilitabeli muutmisel värskendatakse mõjutatud lõuendeid automaatselt umbes ühe sekundi jooksul.
Lülitage otsevaade sisse või välja rippmenüüst. Aktiivsena kuvatakse roheline pulseeriv indikaator. Seade säilib seansside vahel localStorage’i kaudu.
Otsevaade jälgib ploki- ja lehekataloogides failide .php, .json, .css, .scss, .js, .twig ja .html muudatusi. Teadaolevad muudatused värskendavad ainult vastavat registreeritud plokki või lehte. Uue ploki või lehe loomisel tehakse kataloogipõhine topoloogiakontroll, nii et sisu loomine avatud otsevaateseansi ajal toimib ka teisi allikaid uuesti läbi skannimata.
Fookusrežiim
Fookusrežiimi sisenemiseks klõpsake mis tahes joonestusala sildil. Valitud joonestusala täidab vaateakna kogu laiuses ja seda saab kerida vertikaalselt. Ülevaatesse naasmiseks vajutage klahvi Escape või klõpsake sulgemisnuppu.
Juhtnupud
| Tegevus | Sisend |
|---|---|
| Nihutamine | Kerimine / puuteplaadil kahe sõrmega lohistamine |
| Suumimine | Ctrl+kerimine või näpistusliigutus |
| Mahuta vaatesse | Rippmenüü |
| Suumi väärtusele 100% | Rippmenüü |
| Joonestusala fookustamine | Klõpsake joonestusala silti |
| Fookusest väljumine | Escape / sulgemisnupp |
Turvalisus
Lõuendi skript ja lehe andmed laaditakse ainult siis, kui kõik tingimused on täidetud:
- Seade
dev.canvas.enabledontrue. - Praegusel kasutajal on võimekus
edit_posts.
Avalikud külastajad ei näe kunagi lõuendi skripti ega lehe metaandmeid.