# YouTube-Videos in Shopware ohne Ladezeit: Anleitung > Handbuch für Lite YouTube: Umwandlung steuern, Vorschaubilder im Shop speichern, Einstellungen je Verkaufskanal und die Prüfliste für die Abnahme. Quelle / Source: https://stoneandwater.online/de/handbuch-lite-youtube.html # Handbuch Lite YouTube. Von der Installation bis zur Abnahme: Umwandlung steuern, Vorschaubilder datenschutzfreundlich beschaffen, je Verkaufskanal abweichen - und nachweisen, dass es wirkt. [Zur Produktseite](https://stoneandwater.online/de/lite-youtube.html)[Direkt anfragen](https://stoneandwater.online/de/kontakt.html) #### Inhalt / ## Systemvoraussetzungen Shopware 6.7 mit Storefront, PHP 8.2 oder neuer. Für das Holen der Vorschaubilder im Hintergrund genügt der eingebaute Vorgangsplaner. **Zum Kompilieren:** Skript und Stile des Plugins werden in das Theme-Bündel kompiliert. Nach Installation und nach jedem Update ist deshalb ein `theme:compile` nötig. ## Installation 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:clear` ``` Ab dem zweiten Deployment tritt `plugin:update StawLiteYoutube` an die Stelle der Installation. ## Lizenz 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. **Wenn der Lizenzserver ausfällt:** Das Plugin läuft drei Tage mit der letzten gültigen Prüfung weiter. Antwortet der Server dagegen eindeutig mit ungültig, wird sofort gesperrt. **Was ohne Lizenz passiert:** Die Verwaltung ist gesperrt und es werden keine Vorschaubilder mehr geholt. Der Shop läuft weiter, bereits umgewandelte Videos bleiben umgewandelt - Besucher merken nichts. ## Verkaufskanal 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. ## Umwandlung **Umwandlung aktiv** ist der Hauptschalter. Ist er aus, bleibt die Seite unverändert.**Nur diese Pfade** beschränkt die Umwandlung auf einzelne Seiten, ein Pfad je Zeile. Ist das Feld leer, greift sie überall. Ein Stern am Ende wirkt als Platzhalter, `/Jagd/*` erfasst also alles unterhalb von `/Jagd`. **Für einen Vergleich:** Erst eine einzelne Testseite eintragen, messen, danach das Feld wieder leeren. So lässt sich der Gewinn belegen, bevor der ganze Shop umgestellt wird. **Diese Pfade ausnehmen** nimmt einzelne Seiten heraus. Diese Liste wird zuerst geprüft und schlägt die Positivliste - sinnvoll für Landingpages, auf denen ein Video sofort spielen soll. ## Datenschutz und Vorschaubild **Ohne Cookies nachladen** holt den Player beim Klick von youtube-nocookie.com statt von youtube.com. Sollte eingeschaltet bleiben. Für das **Vorschaubild** gibt es drei Wege: - **Im Shop speichern** - empfohlen. Der Server holt jedes Bild einmalig und legt es im Shop ab. Beste Optik bei voller Cookie- und IP-Freiheit. - **Direkt von YouTube laden** - sieht genauso aus, überträgt aber schon beim Seitenaufruf die IP-Adresse des Besuchers an Google. Der Datenschutzgewinn ist damit nur teilweise. - **Ohne Vorschaubild** - dunkler Hintergrund mit Play-Knopf. Bis zum Klick gibt es keine einzige Verbindung nach außen. **Solange das Bild fehlt** greift nur bei lokaler Speicherung: Ein frisch eingebautes Video hat noch kein Bild, weil der Abruf im Hintergrund läuft. Bis dahin wird entweder vorläufig von YouTube geladen oder gar kein Bild gezeigt. Wer keine einzige Verbindung zu Google will, wählt hier „Ohne Vorschaubild".**Bildformat und Größe:** YouTube liefert jedes Bild als JPEG und als WebP. WebP ist bei gleicher Auflösung deutlich kleiner, „Automatisch" probiert es deshalb zuerst. Die Größe ist eine Obergrenze, keine Zusage - maxresdefault ist am schärfsten, existiert aber nicht für jedes Video; fehlt eine Größe, wird die nächstkleinere genommen. **Warum das umständlich wirkt:** Fehlt ein Vorschaubild, antwortet YouTube zwar mit Statuscode 404, liefert im Rumpf aber ein graues Platzhalterbild. Auf dem Server lässt sich der Statuscode auswerten, im Browser nicht - dort schlägt das Laden formal nie fehl. Deshalb prüft das Skript im Shop die tatsächliche Bildbreite: alles unter 200 Pixel ist der Platzhalter, und der nächste Eintrag der Kette wird versucht. 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. ## Vorschaubilder verwalten 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. **Zum Zwischenspeicher:** Solange auf einer Seite ein Bild fehlt, wird sie bewusst nicht in den Seiten-Cache gelegt - sonst würde das Ersatzbild dort einfrieren, obwohl das echte längst da ist. Videos, die nach drei Versuchen aufgeben, zählen dabei nicht mit, damit ein einzelnes kaputtes Video eine Seite nicht dauerhaft ausschließt. - **Videos vormerken** - Video-Kennungen oder komplette YouTube-Adressen einfügen, mehrere durch Komma oder Leerzeichen getrennt. So lässt sich der Vorrat füllen, bevor eine Seite live geht. - **Offene jetzt holen** - arbeitet zehn Einträge je Klick ab, für alle, die nicht warten wollen. - **Fehlgeschlagene erneut versuchen** - nach drei Fehlversuchen ruht ein Eintrag. War die Ursache vorübergehend, stellt der Knopf ihn zurück in die Warteschlange. - **Neu holen** an einer Zeile lädt genau dieses Bild noch einmal, etwa wenn der Kanal es geändert hat. - **Entfernen** löscht Bild und Eintrag. Beim nächsten Seitenaufruf wird das Video automatisch wieder vorgemerkt. 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. ## Was umgewandelt wird und was nicht 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: - iframe-Markup innerhalb von script, template, textarea, noscript und HTML-Kommentaren - iframes anderer Anbieter, etwa Vimeo oder Google Maps - iframes, die ein Lazy-Loader per data-src nachlädt - Links auf YouTube - es geht ausschließlich um eingebettete Player ## Prüfliste für die Abnahme Auf einer Produktseite mit zwei Videos: - Seitenquelltext ansehen, nicht das DOM in den Entwicklerwerkzeugen. Es darf kein iframe mit einer youtube.com-Adresse mehr vorkommen. - In der Konsole ergibt `document.querySelectorAll('lite-youtube').length` die Anzahl der Videos auf der Seite. - `customElements.get('lite-youtube')` liefert die Klasse zurück. - Netzwerk-Ansicht vor dem Klick: keine Anfragen an youtube.com, keine YouTube-Cookies. Bei lokalen Vorschaubildern zusätzlich keine Anfrage an i.ytimg.com. - Nach dem Klick startet das Video direkt, ohne zweiten Klick, auch auf iOS und Android. - Modalbox öffnen, Video starten, Modalbox schließen: der Ton stoppt. - Zwischen den Reitern der Produktseite wechseln - das Video bleibt bedienbar. - PageSpeed Insights vorher und nachher auf derselben Seite, Werte notieren. ## Eigene Bildadresse 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. - **Je Verkaufskanal** - jeder Kanal kann eine eigene Adresse bekommen. - **Vorschau** - unter dem Feld steht die Adresse, die daraus entsteht. - **Leer lassen** - dann gilt das in Shopware eingerichtete Auslieferungsnetz, falls vorhanden. Die Adresse wird bei jedem Aufruf neu gebildet. Ein Wechsel des Netzes greift damit sofort, ohne dass Zwischenspeicher geleert werden müssen. ## Zu beachten **Vollständige Cookie- und IP-Freiheit:** Bei „Direkt von YouTube laden" besteht weiterhin eine Verbindung zu Google beim Seitenaufruf. Wer das ausschließen will, nimmt „Im Shop speichern" zusammen mit dem Ersatzbild „Ohne Vorschaubild". **Nach Änderungen an den Einstellungen** zusätzlich den Seiten-Cache leeren, sonst werden weiterhin die alten Seiten ausgeliefert. **Bei einem Consent-Werkzeug** mit eigenen Platzhaltern über Videos sollte geprüft werden, dass nicht zwei Überlagerungen übereinander erscheinen. 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". ## Support 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. ## Alle Einstellungen 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). ### Lite YouTube **Verkaufskanal** Standard: Standard - alle Verkaufskanäle Hier wählst du, für welchen Verkaufskanal die Einstellungen gelten. Ohne Auswahl gilt der Standard überall, solange ein Kanal nichts Eigenes hinterlegt hat. ### Umwandlung **Umwandlung aktiv** Standard: an Ersetzt alle YouTube-iframes im Storefront durch Lite-Embeds mit Vorschaubild und Play-Button. Ist der Schalter aus, bleibt die Seite unverändert. **Nur diese Pfade** Standard: leer Ein Pfad pro Zeile. Leer bedeutet: alle Seiten. Ein Stern am Ende wirkt als Platzhalter, zum Beispiel /Jagd/* **Diese Pfade ausnehmen** Standard: leer Ein Pfad pro Zeile. Wird vor der Positivliste geprüft und schlägt diese. ### Datenschutz und Vorschaubild **Ohne Cookies nachladen** Standard: an Beim Klick wird der Player von youtube-nocookie.com geladen statt von youtube.com. **Vorschaubild** Standard: Direkt von YouTube laden 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. **Solange das Bild fehlt** Standard: Vorläufig von YouTube laden Was gezeigt wird, bis der Server das Vorschaubild geholt hat. Betrifft nur frisch eingebaute Videos. **Eigene Bildadresse** Standard: leer 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. **Bildformat** Standard: Automatisch - WebP mit JPEG als Reserve 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. **Größe des Vorschaubilds** Standard: hqdefault - 480 x 360 Obergrenze. maxres ist am schärfsten, existiert aber nicht für jedes Video. Fehlt eine Größe, wird automatisch die nächstkleinere genommen. **Vorschaubild verzögert laden** Standard: an Setzt am Vorschaubild das Attribut loading auf lazy. Bilder in geschlossenen Modalboxen werden dadurch nicht mitgeladen. ## Verfügbarkeit Direkt über Stone & Water ### Ab sofort möglich Monatlich 7,99 € Bester Preis Jährlich 81,50 € 15 % günstiger 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. [Direkt anfragen](https://stoneandwater.online/de/kontakt.html)[+49 2555 9997342](tel:+4925559997342) Shopware Store ### In Vorbereitung 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. [Bild: Stone & Water] Shopware E-Commerce Agentur aus Schöppingen. Beratung, Umsetzung und Optimierung - vom ersten Konzept bis zum laufenden Wachstum. ### Shopware - [Shopware Übersicht](https://stoneandwater.online/de/shopware.html) - [Migration (5 auf 6)](https://stoneandwater.online/de/shopware-migration.html) - [SEO-Optimierung](https://stoneandwater.online/de/shopware-seo.html) - [Performance](https://stoneandwater.online/de/shopware-performance.html) - [Template-Entwicklung](https://stoneandwater.online/de/shopware-template-entwicklung.html) - [Plugin-Entwicklung](https://stoneandwater.online/de/shopware-plugin-entwicklung.html) - [PIM für Shopware](https://stoneandwater.online/de/pim.html) - [Shopware Plugins](https://stoneandwater.online/de/plugins.html) ### Plugins [Plugin Suite kostenlos ](https://stoneandwater.online/de/plugin-suite.html)[Alle Plugins](https://stoneandwater.online/de/plugins.html)[Alle Videos](https://stoneandwater.online/de/videos.html) - [A/B Testing](https://stoneandwater.online/de/ab-testing.html) - [CLP Information](https://stoneandwater.online/de/clp-information.html) - [Cross-Selling im Checkout](https://stoneandwater.online/de/checkout-cross-selling.html) - [Crypto Payment](https://stoneandwater.online/de/crypto-payment.html) - [Datenbank Cleanup & Optimizer](https://stoneandwater.online/de/db-cleaner.html) - [Herstellerseiten](https://stoneandwater.online/de/herstellerseiten.html) - [Kategorie-Ebenen](https://stoneandwater.online/de/kategorie-ebenen.html) - [KI Agent Newsletter Marketing](https://stoneandwater.online/de/ki-newsletter-agent.html) - [KI Bild Hinweis](https://stoneandwater.online/de/ki-bild-hinweis.html) - [KI Bild-SEO](https://stoneandwater.online/de/ki-bild-seo.html) - [KI Blog & Landingpage](https://stoneandwater.online/de/ki-landingpage.html) - [KI Cross-Selling](https://stoneandwater.online/de/ki-cross-selling.html) - [KI Newsletter](https://stoneandwater.online/de/ki-newsletter.html) - [KI Produkt-Bundles](https://stoneandwater.online/de/ki-produkt-bundles.html) - [KI Produktberater](https://stoneandwater.online/de/ki-produktberater.html) - [KI Produktfragen](https://stoneandwater.online/de/ki-produktfragen.html) - [KI Produktsuche](https://stoneandwater.online/de/ki-produktsuche.html) - [KI Produktvideos](https://stoneandwater.online/de/ki-produktvideos.html) - [KI Übersetzungsmanager](https://stoneandwater.online/de/ki-uebersetzungsmanager.html) - [KI Zusatzinhalte](https://stoneandwater.online/de/ki-zusatzinhalte.html) - [Kundenbewertungen](https://stoneandwater.online/de/kundenbewertungen.html) - [Lite YouTube](https://stoneandwater.online/de/lite-youtube.html) - [Live-Viewer & Verkaufszähler](https://stoneandwater.online/de/live-viewer.html) - [Page Speed Optimierung](https://stoneandwater.online/de/page-speed.html) - [Plugin Update Manager](https://stoneandwater.online/de/update-manager.html) - [Read More - Beschreibung](https://stoneandwater.online/de/read-more.html) - [robots.txt Manager](https://stoneandwater.online/de/robots-txt.html) - [Shopping Like Dating](https://stoneandwater.online/de/shopping-like-dating.html) - [Varianten-Vorauswahl](https://stoneandwater.online/de/varianten-vorauswahl.html) - [Versand-Kalkulator](https://stoneandwater.online/de/versand-kalkulator.html) - [Zahlungsinformation auf PDF Beleg](https://stoneandwater.online/de/zahlungsinformation-pdf.html) Weitere Plugins [ALBIS Leasing](https://stoneandwater.online/de/albis-leasing.html)[Cache Warmer](https://stoneandwater.online/de/cache-warmer.html)[Shopware CDN](https://stoneandwater.online/de/shopware-cdn.html) ### Unternehmen - [Kontakt](https://stoneandwater.online/de/kontakt.html) - [Impressum](https://stoneandwater.online/de/impressum.html) - [Datenschutz](https://stoneandwater.online/de/datenschutz.html) - Cookie-Einstellungen © 2026 Stone & Water · Dominic Steiner Gehostet auf [Creoline](https://www.creoline.com/ref/tYq4UkumEqLtMCi3PpwEJo9JspG66udf) [LinkedIn](https://www.linkedin.com/company/18043592/) · [Xing](https://www.xing.com/pages/stone-water) · [Facebook](https://www.facebook.com/stoneandwateragency/)