From installation to acceptance: control the conversion, obtain preview images the privacy-friendly way, deviate per sales channel - and prove that it works.
Shopware 6.7 with Storefront, PHP 8.2 or newer. The built-in task scheduler is enough for fetching preview images in the background.
theme:compile is therefore required after installation and after every update.Upload the ZIP in the admin under Extensions, install and activate it. Then enter the licence key. The settings live in the menu under Marketing, entry "Lite YouTube".
On the console after the first installation:
bin/console plugin:refresh
bin/console plugin:install --activate StawLiteYoutube
bin/console theme:compile
bin/console cache:clearFrom the second deployment onwards, plugin:update StawLiteYoutube takes the place of the installation.
Without a valid licence the menu entry shows an activation screen instead of the interface, with the detected shop domain, a field for the key and a button to activate.
The key is stored on the server and never reaches the browser. Verification runs against plugins.staw.io, checking the combination of key and domain. A valid check holds for 15 minutes so that not every click in the admin triggers a request.
At the top you define which sales channel the settings apply to. "Default - all sales channels" is the base setting. If a single channel is selected, the values set there apply to that channel only.
If a channel deviates from the default, a note lists the affected fields. "Reset to default" removes all its own values, after which it follows the default again.
/hunting/* covers everything below /hunting.For the preview image there are three routes:
On aspect ratios: maxresdefault and mqdefault are close to 16:9, sddefault and hqdefault are 4:3 and carry black bars. Those are cropped in the storefront, so nothing of them is visible.
Load preview image lazily sets the loading attribute to lazy, so images of videos inside closed modals are not fetched on page view.The tab shows which videos the shop knows about and how their images stand.
As soon as a page with a video is delivered, the server fetches the preview image automatically - only after the page has reached the visitor, so it costs no waiting time. At most four images are fetched per page view so a page with many videos does not block a process. The hourly task remains as a net for anything that did not work.
The images live in the public file system under staw-lite-youtube, which works with S3 or other remote storage too. If the file system cannot provide a public address, the plugin serves them through a route of its own with a cache header of one year.
Converted are all iframes with an address from youtube.com or youtube-nocookie.com - whether from a template, from a product description in the editor or from a shopping experience element.
Left untouched are:
On a product page with two videos:
document.querySelectorAll('lite-youtube').length gives the number of videos on the page.customElements.get('lite-youtube') returns the class.The plugin normally fetches preview images through Shopware. If your delivery network sits outside - a network of your own that Shopware does not know about - enter the address in the field Own image address.
The address is built on every request. Switching networks therefore takes effect at once, with no caches to clear.
The image download runs through i.ytimg.com - done by the server, not the visitor, and only once per video. WebP is supported by all current browsers; only shops that must serve very old ones pick "JPEG only".
Questions and requests come straight to us - support is from the developer, not from a queue. You can also request a feature through the Plugin Suite in the admin.
Every setting of the plugin with its default value and explanation, in the same order as in the administration. The texts come straight from the plugin (version 1.2.8).
Pick the sales channel these settings apply to. Without a selection the default applies everywhere, as long as no channel has a value of its own.
Replaces every YouTube iframe in the storefront with a lite embed showing a thumbnail and a play button. With the switch off the page stays untouched.
One path per line. Empty means every page. A trailing star acts as a wildcard, for example /hunting/*
One path per line. Checked before the allow list and wins over it.
On click the player is loaded from youtube-nocookie.com instead of youtube.com.
Thumbnails loaded from YouTube look better but open a connection to Google as soon as the page is opened. Without a thumbnail the page stays free of external connections until the click.
What is shown until the server has fetched the thumbnail. Only affects freshly added videos.
Only needed when the shop sits behind a CDN that Shopware does not know about. The file name is appended to this address. Leave empty to have the address built automatically.
WebP thumbnails are noticeably smaller than JPEG and available for most videos. Automatic tries WebP first and falls back to JPEG.
Upper bound. maxres is the sharpest but does not exist for every video. When a size is missing the next smaller one is used automatically.
Sets the loading attribute of the thumbnail to lazy. Images inside closed modals are then not loaded along with the page.
All prices net, plus VAT.
You buy the licence directly from us and receive an invoice from us. Installation by upload in the admin without SSH, updates through our licence platform, support straight from the developer.
The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager in the backend, billing through your Shopware account. We will link it here as soon as it is available.