3D Preview Generator

Der 3D Preview Generator steht dir ab Shopware 6.7.1.0 in Verbindung mit einem Shopware Rise Plan (oder höher) zur Verfügung.

Der 3D Preview Generator ist ein Shopware-Service, der automatisch Vorschaubilder für 3D-Dateien im .glb-Format erstellt. Sobald eine entsprechende Datei in Shopware hochgeladen wird, generiert der Service ein statisches Vorschaubild, das anschließend beispielsweise im Produktlisting oder auf der Produktdetailseite angezeigt werden kann.

Diese Vorschauen werden sowohl in der Storefront als auch im Medienmanager im Admin-Bereich angezeigt – so wird 3D-Content genauso visuell dargestellt wie andere Medienarten.

Hinweis: Dieses Feature befindet sich derzeit im Beta-Status.
Der Funktionsumfang ist in dieser Version noch eingeschränkt und kann in zukünftigen Updates weiter ausgebaut werden. Es kann sich in Verhalten und Umfang noch ändern.

Wir freuen uns über dein Feedback, um die Funktion gezielt weiterzuentwickeln.

Wie funktioniert der 3D Preview Generator?

Automatisch & ohne Konfiguration: Sobald eine .glb-Datei hochgeladen wird – egal ob direkt am Produkt oder über den Medienmanager – startet die Generierung der Vorschau automatisch im Hintergrund.
Vollständig integriert: Es sind keine zusätzlichen Einstellungen notwendig. Die Funktion arbeitet im Hintergrund und erfordert keinen manuellen Aufwand.

Beispielhafter Ablauf

Du lädst eine .glb-Datei z. B. unter Inhalte > Medien im Admin hoch
Die Vorschau wird automatisch im Hintergrund erstellt
Du wirst per Benachrichtigung informiert, sobald die Vorschau bereit ist
Im Medienmanager ist das Vorschau-Bild sichtbar
In der Storefront erscheint das Bild z. B. auf der Produktdetailseite auf der linken Seite in der Galerie-Slider-Thumbnails

Technische Umsetzung

Die 3D-Datei wird temporär an einen sicheren, von Shopware betriebenen Rendering-Service übermittelt.

Dieser läuft in einer geschützten AWS-Cloud-Umgebung mit:

Ende-zu-Ende-Verschlüsselung
Strengen Zugriffsbeschränkungen

Dort wird die .glb-Datei in ein statisches 2D-Vorschaubild gerendert und anschließend zurück an Shopware übertragen. Das Vorschau-Bild wird automatisch in deinen Medien gespeichert und überall dort verwendet, wo die 3D-Datei verknüpft ist.

Hinweise

Datenfreigabe

Je nach Systemkonfiguration kann es erforderlich sein, einer Datenverarbeitung durch Shopware-Dienste vorab zuzustimmen. In diesem Fall wirst du automatisch über die Service Registry benachrichtigt und kannst dort bequem deine Zustimmung erteilen. Shopware verarbeitet deine 3D-Dateien ausschließlich zur Erstellung von Vorschaubildern. Eine anderweitige Nutzung findet nicht statt.

Aktueller Funktionsumfang

Diese Funktion ist standardmäßig aktiv und bietet derzeit keine weiteren Einstellungen. In zukünftigen Versionen könnten erweiterte Optionen folgen (z. B. Anpassung des Hintergrunds für das Vorschaubild), abhängig vom Feedback der Community.

Hinweis zur Aktualisierung bestehender Installationen

Bei einem Update auf eine Shopware-Version, die den 3D Preview Generator enthält, werden für bereits vorhandene .glb-Dateien keine Vorschaubilder automatisch nachträglich erzeugt.

So kannst du Vorschaubilder dennoch erstellen:

Datei erneut hochladen: Lade die .glb-Datei erneut hoch – entweder über den Medienmanager oder direkt im Produkt. Dadurch wird die Vorschauerstellung erneut angestoßen.
Manuell über Code triggern: Alternativ kann die Generierung über ein eigenes Script oder Plugin manuell angestoßen werden (z. B. per Symfony Command oder Repository-Service-Aufruf). Dieser Weg richtet sich an technisch versierte Nutzer oder Entwickler.

Wichtig: Ohne eines dieser beiden Verfahren bleiben bestehende 3D-Dateien ohne Vorschau in der Storefront und im Admin sichtbar.