Referencja bloku CMS

Blok CMS Mediaverse pozwala umieścić treści wideo / karuzela / hotspot / 360° / 3D na dowolnej Shopping Experience. Ta strona to referencja techniczna; dla user-facing flow zobacz Shopping Experiences.

Identyfikator bloku

Name — p2lab-cms-mediaverse
Label — “Mediaverse” (tłumaczone)
Category — video
Tryby rozmiaru — boxed, boxed-stretch, fullwidth

Sloty

Slot	Typ	Cel
`content`	`p2lab-cms-mediaverse`	Faktyczne medium (jeden slot, jedna referencja do medium).

Typ elementu jest niestandardowy (p2lab-cms-mediaverse) — Shopware nie dostarcza ogólnego typu elementu “video”, więc Mediaverse deklaruje swój własny.

Kształt konfiguracji slotu

Przechowywany w cms_slot.config jako JSON. Przybliżony kształt:

{
    "mediaverseData": {
        "value": {
            "type": "embed | local | panorama | model | splide | hotspot",
            "source": "youtube | vimeo | ...",
            "url": "...",
            "mediaId": "uuid",
            "playback": {
                "autoplay": true,
                "muted": true,
                "loop": false,
                "controls": true
            },
            "height": null,
            "translation": {
                "de-DE": { "mediaId": "uuid", "url": null }
            }
        }
    }
}

height nadpisuje domyślną wysokość bloku — ustaw jako długość CSS (400px, 60vh) albo zostaw null dla wartości domyślnej theme’a.

Szablony

Blok dostarczany jest z dwoma szablonami storefrontowymi:

views/storefront/block/cms-block-p2lab-cms-mediaverse.html.twig — zewnętrzny wrapper respektujący tryb rozmiaru.
views/storefront/element/cms-element-p2lab-cms-mediaverse.html.twig — wewnętrzny element delegujący do odpowiedniego renderera w zależności od type.

Podgląd w adminie

Blok ma mały komponent podglądu, który pokazuje obraz placeholder, gdy konfiguracja jest pusta, oraz miniaturę / placeholder, gdy konfiguracja jest ustawiona. Faktyczny bogaty podgląd jest dostępny tylko w storefroncie.

Użycie wewnątrz innych bloków

Nie można zagnieździć bloku Mediaverse wewnątrz innego bloku. Aby połączyć treści Mediaverse z tekstem, umieść osobny element tekstowy obok bloku Mediaverse w tej samej sekcji CMS.