v0 Hero-Slider: Quellen (manual, DOOH, News)
Was
Startseiten-Hero-Slider für individuelle v0-Websites (websiteTemplate null/default) können aus drei Körben kommen — nicht nur aus hardcodierten Bildern im Frontend.
Warum
Redaktion und Vertrieb (KAM) pflegen Inhalte an unterschiedlichen Stellen. Agenten und v0 sollen wissen: „Slider anpassen“ kann Webseiten → Hero-Slider, Digital Experience → DOOH oder Content → News bedeuten.
Wer ist betroffen
- Redaktion, Center-Betrieb, KAM-Vertretung im Urlaub
- v0-Entwicklung, MCP/AgencyOS-Agenten
Wo im Cockpit
| Quelle | Pfad | Speicher |
|---|---|---|
| Manuelle Slides | Webseiten → Hero-Slider (v0) | templateContent.base.hero.slides[] |
| News automatisch | Gleicher Reiter: News-Highlights im Slider | templateContent.base.hero.includeNewsSlides |
| DOOH-Playlist | Digital Experience → DOOH Video | dooh_playlist / Items |
| News Highlight | Content → News → Als Highlight markieren | news.featured / news.isHeroFeatured |
Öffentlich lesen (v0)
GET /api/centers/{centerId}/public-visitor-surface
→ data.hero.slides[]
Jeder Slide (aufgelöst):
| Feld | Bedeutung |
|---|---|
source | manual | dooh | news |
kind | image | video | dooh-inline |
imageDesktop / videoUrl | Medien-URL |
aspectRatio | z. B. 1/1 (Square), 16/9, 9/16 |
doohPlaylistSlug + doohItems | Nur bei kind: dooh-inline — @mall-os/ui DoohSlot |
durationSeconds | Anzeigedauer (DOOH-Item) |
newsId | Referenz auf News-Eintrag |
DOOH direkt (ohne Hero-Konfig):
data.apiHints.doohPublicPlaylistsListGetdata.apiHints.doohPublicPlaylistBySlugGet?slug=…- Playlist-Metadaten:
slotAspectRatio(16/9,4/3,1/1,9/16)
DOOH-Wiedergabe im Slider
| Cockpit-Einstellung | v0-Verhalten |
|---|---|
doohPlayback: expand (Standard) | Jedes VIDEO/IMAGE der Playlist = eigener Hero-Slide |
doohPlayback: inline | Ein Slide, kind: dooh-inline, alle Items in doohItems — Player spielt nacheinander (DoohSlot) |
Ohne expand laufen mehrere Playlist-Videos in einem Slide hintereinander — für Website-Slider oft ungewollt.
Agenten: Urlaubsvertretung
Typische Anfrage: „Kollege im Urlaub — Hero-Slider auf der Startseite ändern.“
cockpit_get_center_website_config→ Reiterbase-hero-slider, FeldtemplateContent.base.hero- Wenn leer oder unverändert: DOOH prüfen (
/dooh/playlists, Slug z. B.website-hero,idle) - News prüfen:
featured/isHeroFeatured,heroVideoUrl,image - Öffentlich verifizieren:
GET public-visitor-surface→data.hero.slides
News-Highlight setzen: Content → News bearbeiten → „Als Highlight markieren“ oder AgencyOS isHeroFeatured: true.
DOOH-Video tauschen: Digital Experience → DOOH → Playlist-Item ersetzen (kein v0-Deploy nötig, wenn v0 aus Surface liest).
So testen
- Center ohne Template, Website aktiv
- DOOH-Playlist mit Square-Format (
slotAspectRatio: 1/1) und einem VIDEO - Hero-Slider: Slide Quelle DOOH, Wiedergabe expand
GET public-visitor-surface→ Slidesource: dooh,kind: video- News mit Highlight +
includeNewsSlides: true→ zusätzliche Slidessource: news
Links
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/v0-hero-slider-quellen