Canvas
Het canvas biedt een uitgezoomd, Figma-achtig overzicht van alle door Blockstudio beheerde pagina’s. Elke pagina wordt weergegeven als een live iframe-artboard in één horizontale rij. Versleep met je trackpad, zoom met knijpen of Ctrl+scroll.
Activering
Het canvas is beschikbaar als verborgen beheerpagina. Ga naar:
/wp-admin/admin.php?page=blockstudio-canvas
De pagina is alleen toegankelijk wanneer dev.canvas.enabled true is en de huidige gebruiker de mogelijkheid edit_posts heeft.
Instellingen
Schakel het canvas in en configureer het gedrag in de blockstudio.json van je thema:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
| Eigenschap | Type | Standaard | Beschrijving |
|---|---|---|---|
enabled |
boolean |
false |
Schakel de canvasfunctie in. |
adminBar |
boolean |
true |
Toon de beheerbalk van WordPress in artboard-iframes. Stel in op false voor een schonere voorbeeldweergave. |
Beide instellingen zijn ook beschikbaar als filters:
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');
Weergaven
Wissel tussen weergaven via het vervolgkeuzemenu in de rechterbovenhoek.
- Pagina’s: alle door Blockstudio beheerde pagina’s als artboards over de volle breedte in één rij.
- Blokken: alle geregistreerde Blockstudio-blokken in een raster, elk weergegeven met de standaard attribuutwaarden.
Openbare inventaris en document-API
Canvas biedt een versiebeheercontract voor PHP dat onafhankelijk is van de consument, voor tools die dezelfde geregistreerde inhoud nodig hebben zonder de ontdekkings- of weergavelogica van Blockstudio opnieuw op te bouwen:
use Blockstudio\Canvas;
$all = Canvas::inventory();
$changed = Canvas::inventory([
'blocks' => ['theme/hero'],
'pages' => ['about'],
]);
$documents = Canvas::documents([
'patterns' => ['theme/featured'],
'templates' => ['front-page'],
]);
De huidige versie is beschikbaar als Canvas::SCHEMA_VERSION. Inventarisresultaten bevatten:
inventory: genormaliseerdepages,blocks,patterns,templates,partsen openbare voorbeelden uit de familieuiorder: de stabiele weergavevolgorde voor verschillende typensources: exact geselecteerde bronpaden met herkomstgegevens bij elk record; desourcevan een paginarecord is de stabiele bronidentiteit, terwijlpathhet fysieke render-templatepad iswarningsenerrors: gestructureerde problemen in plaats van gegenereerde uitvoerdeleted: opgevraagde identificaties die niet meer bestaanselection: de genormaliseerde selectie en of deze gericht was
Canvas::documents() voegt één volledig renderdocument per geselecteerd record toe. Elk document bevat de hoofdtekst, samengestelde HTML, bloknamen met gesloten afhankelijkheden en exacte CSS, JavaScript, modules, interactiviteitsbootstrap, meegeleverde globale UI-variabelen en Tailwind-uitvoer. Paginadocumenten gebruiken een semantische inhoudswrapper van <main>; aanroepers kunnen die aanpassen of uitschakelen via de gedeelde opties voor renderdocumenten. Elke geselecteerde pagina wordt weergegeven in een eigen herstelde frontend-WordPress-context, zodat queryvoorwaarden, body-classfilters, shortcodes, lay-outs, omleidingen en callbacks van wp_enqueue_scripts die pagina waarnemen in plaats van het beheer- of REST-verzoek dat het Canvas-resultaat heeft opgevraagd. Door de aanroeper opgegeven bodyclasses worden samengevoegd met de contextuele classes van de pagina en de frontend-enqueueregisters zijn per document geïsoleerd. Canvas lost deze lifecyclecallbacks op via hun openbare functienamen van WordPress, zodat dezelfde context behouden blijft wanneer Blockstudio wordt geladen via Composer of een verplaatste applicatienamespace.
Semantiek van exacte selectie
Selectie is strikt:
- Zonder herkende typesleutels worden alle typen geladen.
true,nullof"*"laadt elk record van dat type.- Een tekenreeks of lijst laadt alleen exacte ID’s, namen, slugs, paden of bronpaden.
- Een lege tekenreeks/lijst of
falselaadt niets van dat type. - Zodra er een typesleutel aanwezig is, worden weggelaten typen niet ontdekt, gesynchroniseerd, weergegeven of gecompileerd.
Hierdoor zijn verzoeken voor alleen gewijzigde items veilig voor grote projecten. Bestaande blokken en pagina’s worden via hun canonieke registers gevonden. Wanneer een frontendverzoek alleen de opgeslagen paginaprojectie heeft geladen, voert Canvas alleen-lezen brondetectie uit en voegt overeenkomende bericht-ID’s en permalinks samen zonder inhoud te synchroniseren. Dezelfde identiteitscombinatie geldt wanneer een logische detectiebron eerst het brongebonden register vult, zodat contextuele paginarendering nog steeds het overeenkomende door WordPress beheerde bericht gebruikt. Nieuwe topologie in de live sessie wordt alleen rond de gewijzigde map ontdekt, terwijl geselecteerde patroon- en Site Editor-templatebronnen pas na selectie worden gecompileerd.
Het REST-vernieuwingseindpunt volgt dezelfde regel voor de bestaande queryparameters blocks en pages. Bijvoorbeeld: ?blocks=theme/hero retourneert dat blok en geen pagina’s; gebruik beide parameters voor een gemengd antwoord. Wanneer je het eindpunt zonder een van beide parameters aanroept, blijft het volledige verouderde antwoord behouden.
Livemodus
Livemodus gebruikt Server-Sent Events (SSE) om bestandswijzigingen te detecteren en het canvas in realtime bij te werken. Wanneer je een bloktemplate, paginatemplate of stylesheet bewerkt, worden de betreffende artboards automatisch binnen ongeveer één seconde vernieuwd.
Schakel livemodus in of uit via het vervolgkeuzemenu. Wanneer de modus actief is, verschijnt een groen pulserend indicatielampje. De instelling blijft tussen sessies bewaard via localStorage.
Livemodus houdt wijzigingen bij in bestanden van .php, .json, .css, .scss, .js, .twig en .html in blok- en paginamappen. Bekende bewerkingen vernieuwen alleen het bijbehorende geregistreerde blok of de pagina. Een echt nieuw blok of een nieuwe pagina leidt tot één topologiecontrole voor de betreffende map, zodat het aanmaken van inhoud tijdens een openstaande livesessie blijft werken zonder niet-gerelateerde bronnen opnieuw te scannen.
Focusmodus
Klik op een artboardlabel om de focusmodus te openen. Het geselecteerde artboard vult de viewport over de volledige breedte en kan verticaal worden gescrold. Druk op Escape of klik op de sluitknop om terug te keren naar het overzicht.
Bediening
| Actie | Invoer |
|---|---|
| Verschuiven | Scrollen / slepen met twee vingers op trackpad |
| Zoomen | Ctrl+scroll of knijpen |
| Passend maken | Vervolgkeuzemenu |
| Zoomen naar 100% | Vervolgkeuzemenu |
| Artboard focussen | Op artboardlabel klikken |
| Focus verlaten | Escape / sluitknop |
Beveiliging
Het canvas-script en de paginagegevens worden alleen geladen wanneer aan alle voorwaarden is voldaan:
- De instelling
dev.canvas.enabledistrue. - De huidige gebruiker heeft de mogelijkheid
edit_posts.
Openbare bezoekers zien nooit het canvas-script of de paginametadata.