Treci la conținut

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:

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

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

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

PHP
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, parts normalizate și exemple ale familiei publice ui
  • order: ordinea stabilă de afișare între tipuri
  • sources: căile sursă exacte selectate, cu proveniența fiecărei înregistrări; pentru o înregistrare de pagină, source este identitatea stabilă a sursei, iar path este calea fizică a șablonului de randare
  • warnings și errors: probleme structurate în locul ieșirii generate
  • deleted: 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, null sau "*" î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 false nu î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.enabled este true.
  • Utilizatorul curent are capacitatea edit_posts.

Vizitatorii publici nu văd niciodată scriptul canvas sau metadatele paginii.