Einrichtung
Das Plugin kann einfach über den Shopware Plugin Manager in Erweiterungen -> Meine Erweiterungen
Wie zu verwenden
Nach der Installation und Aktivierung ist das Plugin einsatzbereit. Gehen Sie zu Produkte bearbeiten, wo Sie drei neue Registerkarten im Abschnitt Medien sehen:
- Datei - Auf dieser Registerkarte können Sie wie zuvor Mediendateien hinzufügen
- Video einbetten - In dieser Registerkarte können Sie Videos von YouTube, Vimeo, Facebook und Dailymotion einbetten. Wenn Sie mehr als 1 Sprache in Ihrem Shop haben, sehen Sie zwei Registerkarten: Allgemein und Andere Sprachen, ansonsten ist nur der Inhalt der Registerkarte Allgemein sichtbar.
Um ein Video einzubetten, gehen Sie folgendermaßen vor:- Kopieren Sie die URL des Videos und fügen Sie sie in das Feld URL ein
- Wählen Sie aus der Mediathek oder laden Sie das Thumbnail des Videos in das Feld Thumbnail hoch. Dies ist ein Pflichtfeld, wenn Sie ein Video von Facebook oder Dailymotion einbetten. Bei Videos von YouTube und Vimeo wird das Vorschaubild automatisch heruntergeladen, wenn Sie es nicht auswählen.
- Wenn Sie mehrere Sprachen haben, gehen Sie auf die Registerkarte Andere Sprachen, wo Sie eine separate URL für das Video in jeder anderen Sprache angeben können. Lassen Sie die Felder leer, wenn Sie die URL auf der Registerkarte Allgemein verwenden möchten. Denken Sie daran, dass die Quelle aller URLs auf der Registerkarte Andere Sprachen dieselbe sein muss wie die Quelle der URL auf der Registerkarte Allgemein. Mit anderen Worten: Wenn Sie die URL zu einem YouTube-Video auf der Registerkarte Allgemein einfügen, müssen alle Videos in anderen Sprachen ebenfalls von YouTube stammen.
- Nachdem Sie alle erforderlichen Felder ausgefüllt haben, können Sie das Video über die Schaltfläche Hinzufügen zur Produktgalerie hinzufügen.
- Video - in this tab you can add video files such as .mp4, .webm, etc.
Um eine Videodatei hinzuzufügen, gehen Sie folgendermaßen vor:- Wählen Sie aus der Medienbibliothek oder laden Sie das Video im Feld Video hoch. Wenn Sie das ausgewählte Video in mehr als einem Format haben, klicken Sie auf die Schaltfläche Dieses Video in einem anderen Format hinzufügen und wählen Sie die nächste Datei aus der Bibliothek. Aufgrund der begrenzten Unterstützung von Videoformaten durch mobile Geräte (insbesondere iPhones), empfehlen wir, jede Videodatei auch als MP4 hinzuzufügen.
- Wählen Sie aus der Medienbibliothek oder laden Sie die Miniaturansicht des Videos in das Feld Miniaturansicht hoch
- Wenn Sie mehrere Sprachen haben, gehen Sie auf die Registerkarte Andere Sprachen, wo Sie eine separate Videodatei in jeder anderen Sprache bereitstellen können. Lassen Sie die Felder leer, wenn Sie das Video von der Registerkarte Allgemein verwenden möchten
- Nachdem Sie alle erforderlichen Felder ausgefüllt haben, können Sie das Video über die Schaltfläche Hinzufügen zur Produktgalerie hinzufügen
Sie können die Videos im Kachel-Layout auch wie gewohnt per Drag & Drop verschieben, um ihre Reihenfolge festzulegen. Um ein zuvor hinzugefügtes Video zu bearbeiten oder als Cover festzulegen, verwenden Sie das Kontextmenü des ausgewählten Elements.
Konfiguration
Nachdem Sie das Plugin installiert haben, klicken Sie auf die Schaltfläche im Kontextmenü, um zur Konfiguration zu gelangen, wo Sie die folgenden Optionen anpassen können:
- Alternative Domain youtube-nocookie.com für YouTube-Videos verwenden - YouTube bietet an, Videos von der alternativen Domain www.youtube-nocookie.com abzuspielen, die keine Cookies setzt. Nach Aktivierung dieser Option ist es nicht mehr notwendig, Cookies von YouTube zu akzeptieren, um diese Videos abzuspielen
- Deaktivieren Sie die Cookie-Prüfung von Drittanbietern - um GDPR-konform zu sein, ist die Möglichkeit, Videos abzuspielen, standardmäßig blockiert, bis der Kunde Cookies von Drittanbietern akzeptiert hat. Nach der Aktivierung dieser Option ist es möglich, Videos abzuspielen, ohne Cookies von Drittanbietern zu akzeptieren. Diese Option wird nicht empfohlen, wenn Sie einen Shop in einem Land haben, in dem die GDPR-Vorschriften gelten
- Um das Laden der Seite zu beschleunigen, wird standardmäßig eine Videovorschau anstelle eines iframe angezeigt. Erst wenn der Kunde auf die Bildvorschau klickt, wird das Video als Iframe eingebettet. Beachten Sie, dass nur YouTube, Vimeo und Dailymotion das automatische Abspielen des Videos nach dem Laden des iframe ermöglichen. Bei Facebook ist es notwendig, direkt auf das Video innerhalb des iframe zu klicken, um die Wiedergabe zu starten, so dass der Kunde zweimal klicken muss, um das Video abzuspielen (zum ersten Mal auf das Vorschaubild, um den iframe zu laden, und zum zweiten Mal auf das Video innerhalb des iframe, um es abzuspielen). Mit dieser Option können Sie wählen, für welche Quellen der iframe sofort geladen wird.
- Sie können zwischen zwei Modi für die Anzeige des Vorschaubildes von eingebetteten Videos wählen (diese Option ist nützlich, wenn iframes nicht sofort geladen werden):
- inhalt - das Bild unter Beibehaltung seines Seitenverhältnisses (falls vorhanden) auf die größte Größe skalieren, so dass sowohl seine Breite als auch seine Höhe in den Hintergrund-Positionierungsbereich passen
- abdeckung - das Bild unter Beibehaltung seines Seitenverhältnisses (falls vorhanden) auf die kleinste Größe skalieren, so dass sowohl seine Breite als auch seine Höhe den Hintergrund-Positionierungsbereich vollständig abdecken kann
- Wenn Sie eine benutzerdefinierte Thumbnail-Listenansicht haben, können Sie auch einen zusätzlichen Container-Selektor festlegen, dem das Abspielsymbol hinzugefügt wird. Diese Einstellung kann nützlich sein, wenn Sie eine benutzerdefinierte Vorlage verwenden. Wenn Sie jedoch keine Kenntnisse in HTML/JavaScript haben, sollten Sie in diesem Feld nichts eingeben, ohne Ihren Entwickler zu konsultieren
Wichtiger Hinweis: Wenn Sie die Plugin-Konfiguration geändert haben und Ihre Änderungen nicht angezeigt werden, gehen Sie bitte zu Einstellungen -> System -> Caches & Indizes -> und klicken Sie auf die Schaltfläche Caches leeren
API
Um die API verwenden zu können, müssen Sie sie in der Plugin-Konfiguration aktivieren. Die automatische Thumbnail-Erstellung (mit Parameter: autoThumbnail) zum Hinzufügen von Videos über die API ist für Videos von Facebook nicht verfügbar.
Wie zu verwenden