Gå til indhold

Arbejdsflade

Arbejdsfladen giver et zoomet ud, Figma-lignende overblik over alle sider, der administreres af Blockstudio. Hver side vises som et live artboard i en iframe på én vandret række. Panorer med pegefeltet, og zoom med knibebevægelse eller Ctrl+scroll.

Aktivering

Arbejdsfladen er tilgængelig som en skjult administrationsside. Gå til:

Kode
/wp-admin/admin.php?page=blockstudio-canvas

Siden er kun tilgængelig, når dev.canvas.enabled er true, og den aktuelle bruger har funktionen edit_posts.

Indstillinger

Aktivér arbejdsfladen, og konfigurer dens funktion i dit temas blockstudio.json:

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}
Egenskab Type Standard Beskrivelse
enabled boolean false Aktiver arbejdsfladen.
adminBar boolean true Vis administrationslinjen for WordPress inde i artboard-iframes. Indstil til false for en renere forhåndsvisning.

Begge indstillinger er også tilgængelige som filtre:

PHP
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');

Visninger

Skift mellem visninger med rullemenuen øverst til højre.

  • Sider: Alle sider, der administreres af Blockstudio, som artboards i fuld bredde på én række.
  • Blokke: Alle registrerede Blockstudio-blokke i et gitter, hver gengivet med standardværdier for attributterne.

Offentligt indeks og dokumentAPI

Canvas stiller en versionsstyret, forbrugerneutral PHP-kontrakt til rådighed for værktøjer, der har brug for det samme registrerede indhold uden at genopbygge Blockstudios logik til registrering eller gengivelse:

PHP
use Blockstudio\Canvas;

$all = Canvas::inventory();

$changed = Canvas::inventory([
  'blocks' => ['theme/hero'],
  'pages' => ['about'],
]);

$documents = Canvas::documents([
  'patterns' => ['theme/featured'],
  'templates' => ['front-page'],
]);

Den aktuelle version er tilgængelig som Canvas::SCHEMA_VERSION. Indeksresultater indeholder:

  • inventory: normaliserede pages, blocks, patterns, templates, parts og eksempler på offentlige ui-familier
  • order: den stabile visningsrækkefølge på tværs af typer
  • sources: præcise valgte kildestier med oprindelsesoplysninger for hver post; en sideposts source er dens stabile kildeidentitet, mens path er den fysiske skabelonsti til gengivelse
  • warnings og errors: strukturerede problemer i stedet for genereret output
  • deleted: efterspurgte identifikatorer, der ikke længere findes
  • selection: det normaliserede udvalg, og om det var målrettet

Canvas::documents() føjer et komplet gengivelsesdokument til for hver valgt post. Hvert dokument indeholder sin brødtekst, samlet HTML, bloknavne med lukkede afhængigheder og præcise CSS, JavaScript, moduler, bootstrap til interaktivitet, samlede UI-globaler og Tailwind-output. Sidedokumenter bruger en semantisk indholdswrapper for <main>; kaldere kan tilsidesætte eller deaktivere den via de fælles indstillinger for gengivelsesdokumenter. Hver valgt side gengives i sin egen gendannede WordPress-kontekst for frontend, så forespørgselsbetingelser, filtre for body-klasser, shortcodes, layouts, omdirigeringer og tilbagekald wp_enqueue_scripts ser siden i stedet for den administrative anmodning eller REST-anmodningen, der bad om Canvas-resultatet. Kalderspecifikke body-klasser flettes sammen med sidens kontekstuelle klasser, og frontendens registre for indlæsning isoleres mellem dokumenterne. Canvas finder disse tilbagekald i deres offentlige WordPress-funktionsnavne, så den samme kontekst bevares, når Blockstudio indlæses via Composer eller et flyttet applikationsnavneområde.

Semantik for præcist udvalg

Udvalget fortolkes strengt:

  • Ingen genkendte typetaster indlæser alle typer.
  • true, null eller "*" indlæser alle poster af den pågældende type.
  • En streng eller liste indlæser kun præcise ID’er, navne, slugs, stier eller kildestier.
  • En tom streng/liste eller false indlæser ingen poster af den pågældende type.
  • Når først en typetast er angivet, registreres, synkroniseres, gengives eller kompileres udeladte typer ikke.

Det gør anmodninger om kun ændrede elementer sikre for store projekter. Eksisterende blokke og sider findes via deres kanoniske registre. Hvis en frontend-anmodning kun har den gemte sideprojektion indlæst, udfører Canvas en skrivebeskyttet kilderegistrering og fletter matchende indlægs-ID’er og permalinks sammen uden at synkronisere indhold. Den samme identitetssammenfletning bruges, når en logisk registreringskilde først udfylder det kildestyrede register, så kontekstuel sidegengivelse stadig bruger det matchende administrerede indlæg af typen WordPress. Ny topologi for en live session registreres kun omkring den ændrede mappe, mens valgte kilder til mønstre og skabeloner fra Site Editor først kompileres efter udvælgelsen.

Opdateringsendepunktet REST følger samme regel for sine eksisterende forespørgselsparametre blocks og pages. For eksempel returnerer ?blocks=theme/hero den blok og ingen sider; brug begge parametre for et blandet svar. Kald uden nogen af parametrene bevarer det komplette ældre svar.

Live-tilstand

Live-tilstand bruger Server-Sent Events (SSE) til at registrere filændringer og opdatere arbejdsfladen i realtid. Når du redigerer en blokskabelon, sideskabelon eller et typografiark, opdateres de berørte artboards automatisk inden for cirka ét sekund.

Slå live-tilstand til eller fra i rullemenuen. En grøn, pulserende indikator vises, når funktionen er aktiv. Indstillingen bevares mellem sessioner via localStorage.

Live-tilstand registrerer ændringer i .php-, .json-, .css-, .scss-, .js-, .twig– og .html-filer i blok- og sidemapper. Kendte ændringer opdaterer kun den registrerede blok eller side. En helt ny blok eller side udløser én topologigennemgang af den pågældende mappe, så det stadig virker at oprette indhold under en åben live-session uden at gennemgå uvedkommende kilder igen.

Fokusvisning

Klik på en vilkårlig artboard-etiket for at gå i fokustilstand. Det valgte artboard fylder visningsområdet i fuld bredde med lodret rulning. Tryk på Escape, eller klik på lukknappen for at vende tilbage til oversigten.

Betjening

Handling Input
Panorering Rul / træk med to fingre på pegefeltet
Zoom Ctrl+rul eller knib
Tilpas til visning Rullemenu
Zoom til 100% Rullemenu
Fokuser artboard Klik på artboard-etiketten
Afslut fokus Escape / lukknap

Sikkerhed

Canvas-scriptet og sidedataene indlæses kun, når alle betingelser er opfyldt:

  • Indstillingen dev.canvas.enabled er true.
  • Den aktuelle bruger har rettigheden edit_posts.

Offentlige besøgende får aldrig vist canvas-scriptet eller sidemetadataene.