Ga naar de inhoud

Algemeen

Het Blockstudio-register is een CLI-tool voor het verspreiden en installeren van WordPress-blokken uit gehoste registers.

Het werkt als shadcn/ui-, maar dan voor WordPress-blokken. U hoeft geen npm-pakket te installeren. U voert een opdracht uit, de broncode van het blok wordt naar uw project gekopieerd en u hebt er volledig zeggenschap over.

Werking

  1. Auteurs van blokken publiceren een registry.json op een URL met een lijst van hun beschikbare blokken.
  2. U voegt een blocks.json toe aan uw thema of plugin die verwijst naar de registers die u wilt gebruiken.
  3. U voert npx blockstudio add ui/tabs uit en de blokmap wordt aan uw project toegevoegd.

Dat is alles. De CLI downloadt de bestanden, lost afhankelijkheden op en schrijft ze naar schijf. De tool transformeert niets. Een WordPress-blokmap is overal hetzelfde.

Wat wordt ondersteund

Het register is onafhankelijk van het bloktype. Het kopieert mappen. Elk blok in een map werkt:

  • Blockstudio-blokken: block.json + PHP/Twig/Blade-template + optionele assets
  • @wordpress/create-block-blokken: volledige buildoutput van JS met edit.js, save.js, enzovoort
  • Gewone PHP-blokken: elk blok dat is geregistreerd met register_block_type()
  • Statische blokken: blokken met alleen een block.json en zonder server-side rendering

Het maakt de CLI niet uit wat er in de map staat. De tool leest het bestandsmanifest uit het register en downloadt precies die bestanden.

Beheer van WordPress

Als het actieve thema een blocks.json heeft met geconfigureerde registers, verschijnen die registers ook in Tools > Blockstudio > Registry in wp-admin.

Met die beheerbrowser kunt u de beschikbare blokken bekijken en importeren zonder de CLI aan te raken. De configuratie-indeling blijft hetzelfde. blocks.json blijft de enige bron van waarheid.

Snel aan de slag

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Lees Aan de slag voor de volledige configuratie.