Liigu sisu juurde

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:

Kood
/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:

JSON
{
  "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:

PHP
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:

PHP
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: normaliseeritud pages, blocks, patterns, templates, parts ja avalike ui perekondade näited
  • order: stabiilne tüüpideülene kuvamisjärjekord
  • sources: täpselt valitud lähtefailide teed koos iga kirje päritoluteabega; lehe kirje source on selle stabiilne allikaidentiteet, samas kui path on füüsilise renderdusmalli tee
  • warnings ja errors: väljastatud väljundi asemel struktureeritud probleemid
  • deleted: taotletud identifikaatorid, mida enam ei eksisteeri
  • selection: 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, null võ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 false korral 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.enabled on true.
  • Praegusel kasutajal on võimekus edit_posts.

Avalikud külastajad ei näe kunagi lõuendi skripti ega lehe metaandmeid.