Pokaż spis treści

Administracja

Import i eksport YAML / ZIP

Import YAML/ZIP przenosi gotową stronę między instancjami uni-site. Plik opisuje metadane, bloki i opcjonalny manifest plików, a importer tworzy albo nadpisuje stronę, odtwarza rodzica po slugu i przepisuje uploady do katalogu docelowego.

Uni-siteKomponenty treści

Jak działa ekran

Eksport strony działa z poziomu edytora. Endpoint pobiera stronę bieżącej witryny, ładuje wszystkie bloki, także nieaktywne, i buduje ZIP zawierający page.yaml oraz pliki z /uploads, jeżeli występują w danych bloków.

Import obsługuje tryb create i overwrite. Przy konflikcie sluga w trybie tworzenia operator dostaje status page-import-conflict. Przy nadpisaniu aktualizowane są metadane i lista bloków, ale dostęp strony pozostaje zgodny z istniejącą konfiguracją.

Walidator akceptuje tylko znane typy bloków. Normalizuje slug, szerokość strony, spis treści, publikację i sortOrder. ZIP może dodatkowo konwertować grafiki do WebP, kompresować obrazy i przepisać ścieżki w blokach.

Przepływ i odpowiedzialności

flowchart TD
  A["Plik YAML / ZIP"] --> B["readPageYamlFromImportFile"]
  B --> C["parsePageYaml"]
  C --> D{"Slug istnieje?"}
  D -->|create + istnieje| E["Konflikt"]
  D -->|overwrite lub nowy| F["createPage / updatePage"]
  F --> G["resolveImportedParentId"]
  G --> H["importPageBundleAssets"]
  H --> I["replaceContentBlocks"]
  I --> J["Edytor bloków importowanej strony"]

Powiązane obszary panelu

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

Panel stronEdytor bloków