Widgety
V administraci DiDom rozlišujeme dva hlavní kontexty:
- Widgety v Page Builderu – bloky uvnitř layoutu stránek (a obdobně u detailů událostí / novinek / kariéry, kde je builder k dispozici).
- Widgety na dashboardu – dlaždice na úvodní přehledové obrazovce po přihlášení.
Nastavení se v obou případech ukládá do JSON struktur; u stránek jako součást layoutu stránky, u dashboardu jako uživatelská preference layoutu (viz také dokument Dashboard).
Page Builder – přehled typů
V editoru stránky přidáváte widgety do sekcí a sloupců. Každý typ má vlastní panel nastavení (modal) s poli specifickými pro daný blok. Níže jsou vestavěné typy z administrace (interní type je v prvním sloupci – technický identifikátor).
Typ (type) | Název v UI | Kategorie | Účel a typická nastavení |
|---|---|---|---|
HeroWidget | Hero Banner | obsah | Velký úvodní blok: nadpis, podnadpis, obrázek na pozadí, výška min., primární a sekundární CTA (text + URL). |
TextWidget | Text / HTML | obsah | Svobodný HTML / text (WYSIWYG nebo zdroj dle editoru). |
ImageWidget | Obrázek | média | Obrázek z URL nebo z knihovny, alt text, případně odkaz a zarovnání (dle verze). |
VideoWidget | Video | média | Video (např. embed / soubor – dle sdílené definice widgetu). |
person | Osoba | obsah | Zobrazení content itemu typu osoba – výběr záznamu (ciId / identifikátor dle editoru). |
numbers | Statistiky | obsah | Jedna nebo více statistik z content itemů nebo přímo zadaných čísel (dle editoru). |
benefits | Benefity | obsah | Výpis benefitů – obvykle výběr více CI nebo filtr podle nastavení. |
collapses | Collapse / Akordeon | obsah | Skládací panely z typu rozbalovací panel (content items). |
cta | CTA | obsah | Výzva k akci – buď z content itemu CTA, nebo přímá konfigurace (dle props ve sdíleném widgetu). |
ImageContentWidget | Obrázkový obsah (zig-zag) | obsah | Sekce obrázek + text (zig-zag layout), často napojená na CI image_content. |
form | Formular | obsah | Vložení formuláře: tenant (tenantCodeName), výběr formuláře (formId / formSlug), volitelně vlastní nadpis nebo skrytí titulku. |
wizard | Průvodce (wizard) | obsah | Vložení wizardu: tenant, výběr průvodce (wizardId / wizardSlug), globální šablony s viditelností pro tenant, volitelný nadpis. |
eventsTeaser | Události (výpis) | obsah | Výpis / teaser událostí – limit, řazení, filtry (dle konkrétního panelu editoru). |
newsTeaser | Novinky (výpis) | obsah | Stejně pro novinky. |
careerTeaser | Kariéra (výpis) | obsah | Stejně pro pracovní pozice. |
documents | Dokumenty | obsah | Výpis nebo výběr dokumentů z modulu dokumentů (filtry / počet dle editoru). |
Widgety Osoba, Benefity, Collapse, Statistiky, Obrázkový obsah nebo CTA často odkazují na jeden nebo více content itemů. Nejdřív záznam vytvořte v modulu Content items, poté ho v panelu widgetu vyberte nebo zadejte identifikátor, který editor nabízí.
Společné principy Page Builderu
- Sekce a sloupce – šířky sloupců, mezery a pozadí sekce lze upravovat v nastavení sekce (dle verze UI).
- Náhled – editor umí náhled v různých šířkách zařízení (emulace breakpointů).
- Publikace layoutu – uložení stránky / publikace probíhá standardním workflow modulu stránek.
Dashboard – typy widgetů a konfigurace
Identifikátory v uloženém JSON odpovídají kódu administrace:
| ID widgetu | Účel | Konfigurace (configuration) |
|---|---|---|
content-publication | Fronta / přehled publikace obsahu (např. čekající změny) | prázdný objekt {} |
dashboard-menu | Zástupci do modulů | {} – které moduly se v dlaždici objeví, řídí se zvlášť v Můj profil → Dashboard menu (pořadí a viditelnost podle view). |
latest-form-submissions | Poslední odeslané formuláře | topN: 1–5 (kolik řádků). |
recently-added | Nedávno přidané záznamy | topN: 1–5. |
quick-action | Rychlé akce | actions: pole z hodnot create-page, create-event, create-news – pořadí na tlačítkách je vždy stránka → událost → novinka (i když v konfiguraci zadáte jinak). |
rich-text | Poznámka / interní text | html: řetězec s HTML (uložený v preferencích layoutu). |
Rozložení sloupců (presety)
Uživatel si v režimu úpravy layoutu vybírá preset:
1col– jeden sloupec (100 %).2col-50-50– dva sloupce poloviční šířky.2col-66-33a2col-33-66– poměr 2:1 nebo 1:2.3col-33-33-33– tři sloupce.
Widgety přetahujete mezi sloupci; každý typ widgetu může být v layoutu nejvýše jednou. Nepoužité widgety zůstávají v paletě a lze je znovu přidat.
Titulky widgetů
U každého widgetu lze upravit vlastní titulek (zobrazený v hlavičce karty); při chybějícím textu se použije výchozí z interní konfigurace.
Kde dál číst
- Dashboard – obecné chování přehledu a odkaz na preference menu.
- Stránky – strom URL a Page Builder.
- Content items – typy záznamů pro obsahové widgety.
- Komponenty UI – URL selector – výběr odkazů v obsahu a CI.