Gå til indhold

Generelt

Blockstudio Registry er et CLI-værktøj til distribution og installation af WordPress-blokke fra hostede registre.

Det fungerer ligesom shadcn/ui, men til WordPress-blokke. Der er ingen npm-pakke, der skal installeres. Du kører en kommando, blokkens kildekode kopieres til dit projekt, og du ejer den fuldt ud.

Sådan fungerer det

  1. Blokforfattere udgiver en registry.json på en URL med en liste over deres tilgængelige blokke.
  2. Du føjer en blocks.json til dit tema eller plugin, som peger på de registre, du vil bruge.
  3. Du kører npx blockstudio add ui/tabs, og blokmappen placeres i dit projekt.

Det var det. CLI henter filerne, løser afhængigheder og skriver dem til disken. Det ændrer ikke noget. En WordPress-blokmappe er den samme overalt.

Understøttede typer

Registret er uafhængigt af bloktypen. Det kopierer mapper. Alle blokke, der ligger i en mappe, fungerer:

  • Blockstudio-blokke: block.json + PHP/Twig/Blade-skabelon + valgfri aktiver
  • @wordpress/create-block-blokke: komplet JS-buildoutput med edit.js, save.js osv.
  • Almindelige PHP-blokke: enhver blok, der er registreret med register_block_type()
  • Statiske blokke: blokke med kun en block.json og ingen rendering på serversiden

CLI er ligeglad med, hvad mappen indeholder. Den læser filmanifestet fra registret og henter præcis de filer.

WordPress-administration

Hvis det aktive tema har en blocks.json med konfigurerede registre, vises de samme registre også i Værktøjer > Blockstudio > Registry i wp-admin.

Med dette administrationsværktøj kan du gennemse de tilgængelige blokke og importere dem uden at røre ved CLI. Konfigurationsformatet er det samme. blocks.json er stadig den autoritative kilde.

Hurtig start

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Se Kom godt i gang for den fulde opsætning.