Canvas
Canvas-ul oferă o vedere de ansamblu micșorată, asemănătoare cu Figma, a tuturor paginilor gestionate de Blockstudio. Fiecare pagină este redată ca o planșă iframe live, într-un singur rând orizontal. Deplasați-vă cu trackpad-ul și măriți cu gestul de apropiere sau cu Ctrl+scroll.
Activare
Canvas-ul este disponibil ca pagină de administrare ascunsă. Navigați la:
/wp-admin/admin.php?page=blockstudio-canvas
Pagina este accesibilă numai când dev.canvas.enabled este true, iar utilizatorul curent are capabilitatea edit_posts.
Setări
Activați canvas-ul și configurați-i comportamentul în blockstudio.json temeiului:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
| Proprietate | Tip | Implicit | Descriere |
|---|---|---|---|
enabled |
boolean |
false |
Activează funcția canvas. |
adminBar |
boolean |
true |
Afișează bara de administrare WordPress în iframe-urile planșelor. Setați la false pentru o previzualizare mai curată. |
Ambele setări sunt disponibile și ca filtre:
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');
Vizualizări
Comutați între vizualizări folosind meniul derulant din colțul din dreapta sus.
- Pages: toate paginile gestionate de Blockstudio, ca planșe pe toată lățimea într-un singur rând.
- Blocks: toate blocurile Blockstudio înregistrate, într-o grilă, fiecare redat cu valorile implicite ale atributelor.
Inventar public și API document
Canvas expune un contract PHP neutru față de consumator și versionat, pentru instrumentele care au nevoie de același conținut înregistrat fără să reconstruiască logica de descoperire sau randare din Blockstudio:
use Blockstudio\Canvas;
$all = Canvas::inventory();
$changed = Canvas::inventory([
'blocks' => ['theme/hero'],
'pages' => ['about'],
]);
$documents = Canvas::documents([
'patterns' => ['theme/featured'],
'templates' => ['front-page'],
]);
Versiunea curentă este disponibilă ca Canvas::SCHEMA_VERSION. Rezultatele inventarului conțin:
inventory:pages,blocks,patterns,templates,partsnormalizate și exemple ale familiei publiceuiorder: ordinea stabilă de afișare între tipurisources: căile sursă exacte selectate, cu proveniența fiecărei înregistrări; pentru o înregistrare de pagină,sourceeste identitatea stabilă a sursei, iarpatheste calea fizică a șablonului de randarewarningsșierrors: probleme structurate în locul ieșirii generatedeleted: identificatorii solicitați care nu mai existăselection: selecția normalizată și dacă a fost direcționată
Canvas::documents() adaugă un document complet de randare pentru fiecare înregistrare selectată. Fiecare document conține corpul, HTML asamblat, numele blocurilor ale căror dependențe sunt satisfăcute și ieșirea exactă pentru CSS, JavaScript, module, inițializarea interactivității, variabilele globale UI incluse și ieșirea Tailwind. Documentele paginilor folosesc un înveliș semantic de conținut <main>; apelanții îl pot suprascrie sau dezactiva prin opțiunile comune ale documentului Render. Fiecare pagină selectată este randată în propriul context frontend WordPress restabilit, astfel încât condiționalele interogării, filtrele pentru clasele body, shortcode-urile, layout-urile, redirecționările și callback-urile wp_enqueue_scripts observă pagina respectivă, nu solicitarea de administrare sau REST care a cerut rezultatul Canvas. Clasele body furnizate de apelant sunt îmbinate cu clasele contextuale ale paginii, iar registrele frontend de enqueue sunt izolate între documente. Canvas rezolvă aceste callback-uri de ciclu de viață după numele funcțiilor publice WordPress, astfel încât același context se păstrează când Blockstudio este încărcat prin Composer sau printr-un spațiu de nume al aplicației relocat.
Semantica selecției exacte
Selecția este strictă:
- Fără chei de tip recunoscute se încarcă toate tipurile.
true,nullsau"*"încarcă toate înregistrările acelui tip.- Un șir sau o listă încarcă numai ID-uri, nume, slug-uri, căi sau căi sursă exacte.
- Un șir/o listă goală sau
falsenu încarcă nimic de acel tip. - După ce este prezentă orice cheie de tip, tipurile omise nu sunt descoperite, sincronizate, randate sau compilate.
Astfel, solicitările care includ doar elementele modificate sunt sigure pentru proiecte mari. Blocurile și paginile existente sunt rezolvate prin registrele lor canonice. Când o solicitare frontend are încărcată doar proiecția persistentă a paginii, Canvas efectuează o descoperire a sursei doar pentru citire și îmbină ID-urile și permalink-urile articolelor corespunzătoare fără să sincronizeze conținutul. Aceeași îmbinare a identităților se aplică atunci când o sursă logică de descoperire populează mai întâi registrul asociat sursei, astfel încât randarea contextuală a paginii să folosească în continuare articolul WordPress gestionat corespunzător. Topologia noii sesiuni live este descoperită numai în jurul directorului modificat, iar sursele selectate de modele și șabloane Site Editor sunt compilate numai după selecție.
Endpoint-ul de reîmprospătare REST urmează aceeași regulă pentru parametrii de interogare existenți blocks și pages. De exemplu, ?blocks=theme/hero returnează acel bloc și nicio pagină; folosiți ambii parametri pentru un răspuns mixt. Apelarea endpoint-ului fără niciunul dintre parametri păstrează răspunsul complet vechi.
Mod live
Modul live folosește Server-Sent Events (SSE) pentru a detecta modificările fișierelor și a actualiza canvas-ul în timp real. Când editați un șablon de bloc, un șablon de pagină sau o foaie de stil, planșele afectate se reîmprospătează automat în aproximativ o secundă.
Activați sau dezactivați modul live din meniul derulant. Când este activ, apare un indicator verde pulsatoriu. Setarea persistă între sesiuni prin localStorage.
Modul live urmărește modificările fișierelor .php, .json, .css, .scss, .js, .twig și .html din directoarele de blocuri și pagini. Editările cunoscute reîmprospătează numai blocul sau pagina înregistrată. Pentru un bloc sau o pagină cu adevărat nouă se efectuează o singură verificare a topologiei la nivel de director, astfel încât crearea de conținut într-o sesiune live deschisă să funcționeze fără să fie rescannate surse fără legătură.
Mod focalizare
Faceți clic pe eticheta oricărei planșe pentru a intra în modul focalizare. Planșa selectată umple fereastra de vizualizare pe toată lățimea, cu derulare verticală. Apăsați Escape sau faceți clic pe butonul de închidere pentru a reveni la prezentarea generală.
Comenzi
| Acțiune | Intrare |
|---|---|
| Deplasare | Derulare / glisare cu două degete pe trackpad |
| Zoom | Ctrl+derulare sau gest de apropiere |
| Încadrare în vizualizare | Meniu derulant |
| Zoom la 100% | Meniu derulant |
| Focalizare planșă | Faceți clic pe eticheta planșei |
| Ieșire din focalizare | Escape / butonul de închidere |
Securitate
Scriptul canvas și datele paginii sunt încărcate numai când sunt îndeplinite toate condițiile:
- Setarea
dev.canvas.enabledestetrue. - Utilizatorul curent are capacitatea
edit_posts.
Vizitatorii publici nu văd niciodată scriptul canvas sau metadatele paginii.