Pokaż spis treści

Administracja

Komponenty treści

Komponenty treści są kontraktem między panelem, importerem i rendererem. Każdy typ ma nazwę techniczną, opis, komponent Astro oraz zestaw pól w builderze. Administrator może ograniczyć listę dostępnych komponentów, ale nie może aktywować typu spoza rejestru.

Jak działa ekran

W poprzedniej wersji portal opisywał tylko część bloków. Pełny rejestr obejmuje również blog, szczegóły wpisu, galerie YouTube i lokalnego wideo, prezentacje slajdów oraz formularz kontaktowy. To istotne, bo właśnie te bloki pokazują, że uni-site jest czymś więcej niż prostym układem hero plus tekst.

Zakładka komponentów w panelu zapisuje ustawienie enabledBlockTypes. Endpoint filtruje formularz przez znane typy z rejestru, więc paleta buildera może być uproszczona dla danej witryny bez ryzyka dodania nieistniejącego renderera.

Przepływ i odpowiedzialności

flowchart LR
  A["blockRegistry.ts"] --> B["Paleta buildera"]
  A --> C["Walidacja importu YAML"]
  B --> D["content_blocks.block_type"]
  C --> D
  D --> E["Renderer komponentu Astro"]
  F["settings.enabledBlockTypes"] --> B

Podstrony komponentów

Hero (hero)

Sekcja otwierająca stronę, używana do ustawienia pierwszego komunikatu, najważniejszej akcji i kontekstu wizualnego. Renderer: HeroBlock.

Otwórz

Rich text (rich-text)

Blok redakcyjny dla dłuższych opisów, instrukcji, dokumentacji, tabel, list, linków i osadzonych obrazów w treści. Renderer: RichTextBlock.

Otwórz

Mermaid (mermaid)

Diagram procesów, stanów i zależności zapisany jako tekst Mermaid. Renderer: MermaidBlock.

Otwórz

Media text (media-text)

Sekcja łącząca opis z jedną grafiką lub zrzutem ekranu. Renderer: MediaTextBlock.

Otwórz

Feature grid (feature-grid)

Lista cech, linków lub elementów nawigacyjnych z opcjonalnymi grafikami. Renderer: FeatureGridBlock.

Otwórz

Image gallery (image-gallery)

Galeria zdjęć, zrzutów ekranu lub wariantów wizualnych z lightboxem. Renderer: ImageGalleryBlock.

Otwórz

Blog (blog-list)

Lista wpisów blogowych pobierana z opublikowanych stron znajdujących się pod wskazaną ścieżką. Renderer: BlogListBlock.

Otwórz

Blog details (blog-details)

Metadane pojedynczego wpisu: tytuł, zajawka, autor, kategoria, daty, tagi i okładka. Renderer: BlogDetailsBlock.

Otwórz

Stats row (stats-row)

Sekcja liczb i wyróżników używana wtedy, gdy są realne dane do pokazania. Renderer: StatsRowBlock.

Otwórz

FAQ (faq)

Lista pytań i odpowiedzi dla sekcji pomocy, wdrożenia lub oferty. Renderer: FaqBlock.

Otwórz

CTA banner (cta-banner)

Sekcja wezwania do działania, przejścia do kontaktu, importu, kolejnej strony albo pobrania materiału. Renderer: CtaBannerBlock.

Otwórz

Contact form (contact-form)

Formularz kontaktowy z danymi kontaktowymi, zgodą i komunikatami statusu. Renderer: ContactFormBlock.

Otwórz

YouTube gallery (youtube-gallery)

Galeria filmów YouTube z tytułem, opisem i kontrolowaną liczbą kolumn. Renderer: YouTubeGalleryBlock.

Otwórz

Video gallery (video-gallery)

Galeria lokalnych plików wideo, np. tutoriali lub nagrań działania aplikacji. Renderer: VideoGalleryBlock.

Otwórz

Slide deck (slide-deck)

Prezentacja slajdów osadzona na stronie, z trybem zwykłym albo sceną prezentacyjną. Renderer: SlideDeckBlock.

Otwórz