Von der Installation bis zur Abnahme: Umwandlung steuern, Vorschaubilder datenschutzfreundlich beschaffen, je Verkaufskanal abweichen - und nachweisen, dass es wirkt.
Shopware 6.7 mit Storefront, PHP 8.2 oder neuer. Für das Holen der Vorschaubilder im Hintergrund genügt der eingebaute Vorgangsplaner.
theme:compile nötig.ZIP im Admin unter Erweiterungen hochladen, installieren, aktivieren. Danach den Lizenzschlüssel eintragen. Die Einstellungen liegen im Menü unter Marketing, Eintrag „Lite YouTube".
Auf der Konsole nach der ersten Installation:
bin/console plugin:refresh
bin/console plugin:install --activate StawLiteYoutube
bin/console theme:compile
bin/console cache:clearAb dem zweiten Deployment tritt plugin:update StawLiteYoutube an die Stelle der Installation.
Ohne gültige Lizenz zeigt der Menüpunkt statt der Oberfläche einen Aktivierungsbildschirm mit der erkannten Shop-Domain, einem Feld für den Schlüssel und einem Knopf zum Aktivieren.
Der Schlüssel wird auf dem Server gespeichert und geht nie an den Browser. Geprüft wird gegen plugins.staw.io, und zwar die Kombination aus Schlüssel und Domain. Eine gültige Prüfung gilt 15 Minuten, damit nicht jeder Klick im Admin eine Anfrage auslöst.
Ganz oben wird festgelegt, für welchen Verkaufskanal die Einstellungen gelten. „Standard - alle Verkaufskanäle" ist die Grundeinstellung. Wird ein einzelner Kanal gewählt, gelten die dort gesetzten Werte nur für ihn.
Weicht ein Kanal vom Standard ab, erscheint ein Hinweis mit den betroffenen Feldern. „Auf Standard zurücksetzen" löscht alle eigenen Werte dieses Kanals, danach folgt er wieder dem Standard.
/Jagd/* erfasst also alles unterhalb von /Jagd.Für das Vorschaubild gibt es drei Wege:
Zu den Seitenverhältnissen: maxresdefault und mqdefault sind nahezu 16:9, sddefault und hqdefault sind 4:3 und haben schwarze Balken. Die werden im Shop weggeschnitten, im Ergebnis sieht man davon nichts.
Vorschaubild verzögert laden setzt das Attribut loading auf lazy. Damit werden Bilder von Videos in geschlossenen Modalboxen nicht schon beim Seitenaufruf geholt.Der Reiter zeigt, welche Videos der Shop kennt und wie es um ihre Bilder steht.
Sobald eine Seite mit einem Video ausgeliefert wird, holt der Server das Vorschaubild automatisch - erst nachdem die Seite beim Besucher angekommen ist, es kostet ihn also keine Wartezeit. Je Seitenaufruf werden höchstens vier Bilder geholt, damit eine Seite mit vielen Videos keinen Prozess blockiert. Der stündliche Vorgang bleibt als Netz für alles, was dabei nicht geklappt hat.
Die Bilder liegen im öffentlichen Dateisystem unter staw-lite-youtube, was auch mit S3 oder anderem entfernten Speicher funktioniert. Kann das Dateisystem keine öffentliche Adresse liefern, liefert das Plugin sie über eine eigene Route mit einem Zwischenspeicher-Hinweis von einem Jahr aus.
Umgewandelt werden alle iframes mit einer Adresse von youtube.com oder youtube-nocookie.com - gleich ob aus einem Template, aus einer Produktbeschreibung im Editor oder aus einem Erlebniswelten-Element.
Nicht angefasst werden:
Auf einer Produktseite mit zwei Videos:
document.querySelectorAll('lite-youtube').length die Anzahl der Videos auf der Seite.customElements.get('lite-youtube') liefert die Klasse zurück.Vorschaubilder holt das Plugin normalerweise über Shopware. Liegt dein Auslieferungsnetz ausserhalb - etwa ein eigenes Netz, von dem Shopware nichts weiss -, trag die Adresse im Feld Eigene Bildadresse ein.
Die Adresse wird bei jedem Aufruf neu gebildet. Ein Wechsel des Netzes greift damit sofort, ohne dass Zwischenspeicher geleert werden müssen.
Der Bilddownload läuft über i.ytimg.com - das macht der Server, nicht der Besucher, und nur einmal je Video. WebP unterstützen alle aktuellen Browser; nur wer sehr alte bedienen muss, wählt „Nur JPEG".
Fragen und Wünsche gern direkt an uns - der Support kommt vom Entwickler, nicht aus einer Warteschleife. Über die Plugin Suite im Admin lässt sich zusätzlich ein Feature anfragen.
Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.2.8).
Hier wählst du, für welchen Verkaufskanal die Einstellungen gelten. Ohne Auswahl gilt der Standard überall, solange ein Kanal nichts Eigenes hinterlegt hat.
Ersetzt alle YouTube-iframes im Storefront durch Lite-Embeds mit Vorschaubild und Play-Button. Ist der Schalter aus, bleibt die Seite unverändert.
Ein Pfad pro Zeile. Leer bedeutet: alle Seiten. Ein Stern am Ende wirkt als Platzhalter, zum Beispiel /Jagd/*
Ein Pfad pro Zeile. Wird vor der Positivliste geprüft und schlägt diese.
Beim Klick wird der Player von youtube-nocookie.com geladen statt von youtube.com.
Von YouTube geladene Vorschaubilder sehen besser aus, bauen aber schon beim Seitenaufruf eine Verbindung zu Google auf. Ohne Vorschaubild bleibt die Seite bis zum Klick frei von externen Verbindungen.
Was gezeigt wird, bis der Server das Vorschaubild geholt hat. Betrifft nur frisch eingebaute Videos.
Nur nötig, wenn der Shop hinter einem CDN steht, von dem Shopware nichts weiß. Der Dateiname wird an diese Adresse angehängt. Leer lassen, damit die Adresse automatisch gebildet wird.
WebP-Vorschaubilder sind deutlich kleiner als JPEG und für die meisten Videos verfügbar. Automatisch probiert WebP zuerst und fällt auf JPEG zurück.
Obergrenze. maxres ist am schärfsten, existiert aber nicht für jedes Video. Fehlt eine Größe, wird automatisch die nächstkleinere genommen.
Setzt am Vorschaubild das Attribut loading auf lazy. Bilder in geschlossenen Modalboxen werden dadurch nicht mitgeladen.
Alle Preise netto zzgl. USt.
Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.
Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.