Przejdź do treści

Ogólne

Blockstudio Registry to narzędzie CLI do dystrybucji i instalowania bloków WordPress z hostowanych rejestrów.

Działa jak menedżershadcn/uipakietów, ale w przypadku bloków WordPress. Nie trzeba instalować pakietu npm. Uruchamiasz polecenie, kod źródłowy bloku zostaje skopiowany do projektu i należy już w całości do Ciebie.

Jak to działa

  1. Autorzy bloków publikują registry.json pod adresem URL, gdzie wymieniają dostępne bloki.
  2. Dodajesz blocks.json do motywu lub wtyczki, wskazując rejestry, z których chcesz korzystać.
  3. Uruchamiasz npx blockstudio add ui/tabs, a folder bloku trafia do projektu.

To wszystko. CLI pobiera pliki, rozwiązuje zależności i zapisuje je na dysku. Niczego nie przekształca. Folder bloku WordPress jest wszędzie taki sam.

Obsługiwane elementy

Rejestr nie zależy od typu bloku. Kopiuje foldery. Działa z każdym blokiem znajdującym się w katalogu:

  • Bloki Blockstudio: block.json + szablon PHP/Twig/Blade + opcjonalne zasoby
  • Bloki @wordpress/create-block: pełny wynik kompilacji JS z plikami edit.js, save.js itd.
  • Zwykłe bloki PHP: dowolny blok zarejestrowany za pomocą register_block_type()
  • Bloki statyczne: bloki zawierające tylko block.json i bez renderowania po stronie serwera

CLI nie ma znaczenia, co znajduje się w folderze. Odczytuje manifest plików z rejestru i pobiera dokładnie te pliki.

Panel administracyjny WordPress

Jeśli aktywny motyw ma skonfigurowane rejestry w blocks.json, te same rejestry pojawiają się również w Narzędzia > Blockstudio > Registry w panelu wp-admin.

Ten panel administracyjny pozwala przeglądać dostępne bloki i importować je bez dotykania CLI. Format konfiguracji pozostaje taki sam. blocks.json nadal jest źródłem prawdy.

Szybki start

Powłoka
npx blockstudio init
npx blockstudio add ui/tabs

Pełną konfigurację znajdziesz w sekcji Pierwsze kroki.