Przejdź do treści

Administracja

Blockstudio zawiera ekran administracyjny w sekcji Narzędzia > Blockstudio. To dostępny na poziomie projektu widok kontrolny tego, co Blockstudio zarejestrował z systemu plików, a także przeglądarka rejestrów i rekordów bazy danych.

Celowo nie jest to strona ustawień. Chodzi o widoczność tego, jakie bloki, rozszerzenia, pola, strony, schematy, rejestry i rekordy bazy danych istnieją w danej chwili.

Dostęp

Strona administracyjna jest dostępna po spełnieniu obu warunków:

  • bieżący użytkownik ma uprawnienie manage_options
  • strona jest włączona przez blockstudio/admin/enabled

Całkowicie wyłącz ją za pomocą:

PHP
add_filter('blockstudio/admin/enabled', '__return_false');

Widoki

Przegląd

Przegląd to tylko do odczytu spis rejestracji Blockstudio. Zawiera osobne karty dla:

  • Bloki: zarejestrowane typy bloków, tryb renderowania, wersja API, liczba atrybutów
  • Rozszerzenia: obiekty docelowe, priorytet, tryb renderowania, liczba atrybutów
  • Pola: definicje wielokrotnego użytku field.json
  • Strony: strony oparte na plikach wraz z typem posta, statusem, silnikiem i stanem synchronizacji
  • Schematy: zarejestrowane schematy db.php z informacją o pamięci masowej i liczbie pól

Tabele korzystają z natywnych DataViews WordPress, dzięki czemu ekran pozostaje spójny z wp-admin, zamiast wprowadzać osobny interfejs.

Rejestr

Jeśli projekt ma blocks.json ze skonfigurowanymi rejestrami, na stronie administracyjnej pojawi się widok Rejestr. Pobiera on dostępne bloki z tych rejestrów i pozwala zaimportować je bezpośrednio do skonfigurowanego katalogu bloków.

Ta sama konfiguracja blocks.json obsługuje zarówno CLI, jak i przeglądarkę administracyjną:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blocks.json",
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json"
  }
}

Obsługiwane są uwierzytelnione rejestry w formacie obiektu z interpolacją headers i ${ENV_VAR}. Pełny format konfiguracji opisano w dokumentacji Rejestru.

Bazy danych

Jeśli projekt rejestruje jakiekolwiek schematy db.php, na stronie administracyjnej pojawi się widok Bazy danych. Każdy schemat ma własną kartę, na której rzeczywiste rekordy są wyświetlane w tabeli DataViews.

Ekran nie serializuje wszystkich rekordów do początkowego ładunku danych panelu administracyjnego. Zamiast tego:

  1. metadane schematów są lokalizowane na początku
  2. rekordy są pobierane na żądanie po otwarciu karty bazy danych
  3. tabele dzielą dane na strony za pomocą REST API

Dzięki temu ekran administracyjny pozostaje użyteczny nawet w projektach z większymi zbiorami danych.

Zakres

Obecny zakres jest celowo wąski:

  • sprawdzanie, co zarejestrował Blockstudio
  • importowanie bloków ze skonfigurowanych rejestrów
  • przeglądanie rekordów bazy danych

Nie zastępuje istniejącego procesu zarządzania ustawieniami i nie umożliwia bezpośredniej edycji definicji bloków ani stron.