Siirry sisältöön

Yleistä

Blockstudio Registry on CLI-työkalu, jolla jaetaan ja asennetaan WordPress-lohkoja isännöidyistä rekistereistä.

Se toimii kuten shadcn/ui, mutta WordPress-lohkoille. Asennettavaa npm-pakettia ei ole. Suoritat komennon, lohkon lähdekoodi kopioidaan projektiisi ja saat sen täysin omaksesi.

Näin se toimii

  1. Lohkojen tekijät julkaisevat registry.jsonn osoitteessa URL ja luettelevat siinä saatavilla olevat lohkonsa.
  2. Lisäät teemaasi tai lisäosaasi blocks.jsonn, joka osoittaa rekistereihin, joita haluat käyttää.
  3. Suoritat npx blockstudio add ui/tabsn, ja lohkokansio ilmestyy projektiisi.

Siinä kaikki. CLI lataa tiedostot, selvittää riippuvuudet ja kirjoittaa ne levylle. Se ei muunna mitään. WordPress-lohkokansio on samanlainen kaikkialla.

Tuetut lohkot

Rekisteri ei ole sidottu lohkotyyppiin. Se kopioi kansioita, joten kaikki hakemistossa sijaitsevat lohkot toimivat:

  • Blockstudio-lohkot: block.json + PHP/Twig/Blade-malli ja valinnaiset resurssit
  • @wordpress/create-block-lohkot: täydellinen JS-koosteen tuloste, jossa on edit.js, save.js jne.
  • Tavalliset PHP-lohkot: kaikki lohkot, jotka on rekisteröity komennolla register_block_type()
  • Staattiset lohkot: lohkot, joissa on vain block.json eikä palvelinpuolen renderöintiä

CLI ei välitä kansion sisällöstä. Se lukee tiedostomanifestin rekisteristä ja lataa täsmälleen siinä luetellut tiedostot.

WordPress-hallinta

Jos käytössä olevassa teemassa on rekistereillä määritetty blocks.json, samat rekisterit näkyvät myös wp-adminissa kohdassa Työkalut > Blockstudio > Registry.

Hallintanäkymässä voit tarkastella saatavilla olevia lohkoja ja tuoda niitä koskematta CLI-tiedostoon. Määritysmuoto pysyy samana. blocks.json on edelleen ensisijainen tietolähde.

Pika-aloitus

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Katso täydelliset määritysohjeet kohdasta Aloittaminen.