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
- Lohkojen tekijät julkaisevat
registry.jsonn osoitteessa URL ja luettelevat siinä saatavilla olevat lohkonsa. - Lisäät teemaasi tai lisäosaasi
blocks.jsonn, joka osoittaa rekistereihin, joita haluat käyttää. - 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 onedit.js,save.jsjne.- Tavalliset PHP-lohkot: kaikki lohkot, jotka on rekisteröity komennolla
register_block_type() - Staattiset lohkot: lohkot, joissa on vain
block.jsoneikä 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
npx blockstudio init
npx blockstudio add ui/tabs
Katso täydelliset määritysohjeet kohdasta Aloittaminen.