Pokaż spis treści

Administracja

Edytor bloków

Edytor bloków jest najważniejszą częścią administracji treścią. Operator wybiera komponent z palety, wypełnia jego pola, ustawia obrazy i dane techniczne, zmienia kolejność kart, a zapis wysyła pełną tablicę bloków do endpointu, który zastępuje rekordy strony.

Jak działa ekran

Builder rozumie typy z rejestru i dla każdego z nich ma zestaw pól oraz domyślny obiekt danych. Karta bloku zawiera zakładki treści, obrazu, ustawień technicznych i JSON. Dzięki temu operator może pracować formularzowo, a techniczna osoba nadal ma podgląd dokładnej struktury danych.

Akcje na bloku

  • Aktywny: blok zostaje w bazie, ale może nie wejść do renderowania publicznego.
  • Usuń: usuwa kartę z bieżącej tablicy przed zapisem.
  • Przenieś: zapisany blok zmienia stronę docelową, a kolejność źródła jest normalizowana.
  • Kopiuj: tworzy nowy rekord bloku na końcu wybranej strony.
  • Upload: pola obrazu i wideo wysyłają plik do wspólnego endpointu uploadów.

Zapis formularza nie aktualizuje pojedynczego pola. Skrypt czyta wszystkie karty, przelicza sortOrder, zapisuje JSON w ukrytym polu i dopiero endpoint /admin/actions/page/:id/blocks wykonuje transakcję zastąpienia listy bloków.

Przepływ i odpowiedzialności

flowchart TD
  A["Karty buildera"] --> B["readCardsAsBlocks"]
  B --> C["blocksJson"]
  C --> D["POST /admin/actions/page/:id/blocks"]
  D --> E["parseBlocksJson"]
  E --> F["replaceContentBlocks"]
  F --> G["DELETE stare bloki strony"]
  G --> H["INSERT nowe bloki"]
  H --> I["status=saved"]

Powiązane obszary panelu

Ten ekran działa w praktyce razem z innymi częściami administracji: stronami, blokami, importem, motywem i dostępem.