Prerequisites

  •  Shopware 6.6.x 

Installation Steps

To install Product Detail YouTube/Vimeo Integration Plugin, follow the steps below.

Step 1: Download the package. 

Step 2: Access your web server directories and unzip and upload the Pits\ ProductDetailYoutubeVimeoIntegration folder to the path custom\plugins 

Step 3: Run below commands on terminal. 

    • bin/console plugin:install - - activate

PitsProductDetailYoutubeVimeoIntegration 

    • bin/build-administration.sh 
    • bin/build-storefront.sh 
    • bin/console cache:clear 

Product Specification

The Product Detail YouTube/Vimeo Integration Plugin for Shopware 6 smoothly combines YouTube videos with product images on your online store. Administrators can easily link YouTube or Vimeo videos to products from the backend, enhancing the product detail page for customers browsing your website. Plus, you can toggle video display on or off for each product, giving you control over how videos are shown in product detail page. 

Admin Configuration

 1. Module Configuration: Login to the Admin and choose Extensions → My extensions → Apps → Pits Product Detail Youtube Vimeo Integration for Shopware 6. 

 Figure 1. Module Configuration 

How it works in Administration

Administrators can assign YouTube URLs to products in backend which will be featured in product detail page in frontend. 

Follow the below steps to assign YouTube or Vimeo video URLs to products in administration. 

 1. Navigate to Catalogues → Products

 Figure 2. Products Tab 

 2. Choose a product and navigate to custom ‘Video URL’ tab in Product Edit Page 

 Figure 3. Video URL tab in Product Edit Page 

 3. Clicking on (+) button in grid toolbar result in a popup to add Video URL and its status. 

 Figure 4. Popup to add new video URL 

 4. Choose the videotype of the URL to be either YouTube or Vimeo in ‘Videotype’ field based on the URL to be added in ‘Video URL’ field. 

 Figure 5. Setting ‘Videotype’ of URL 

 5. Toggling the ‘Enable’ button to right allows the video URL to appear on frontend. 

 Figure 6. Adding a reference url and enabling it. 

 6. Click on ’Save Video Url’ button to save video URL and its status. 

Note: Only a specific format of youTube Video URLs is accepted and it should be in the format of ‘https://www.youtube.com/embed/videoID’ and ‘Save Video URL’ button is disabled if video URL doesn’t meet the format and the video does not exist. 

The admin grid gets updated with saved Video URL after clicking on ‘save Video URL’ as shown in Figure 7. 

 Figure 7. The video URL grid gets updated after adding a new YouTube URL 

Adding a Vimeo URL

Adding a Vimeo URL is similar in adding a YouTube URL in backend as shown in Figure 8. The administrators can choose ‘Videotype’ field as Vimeo and then add a valid vimeo URL in the format of https://player.vimeo.com/video/videoID so it can get rendered on frontend when enabled. 

 Figure 8. Adding a reference vimeo UR 

Note: Only a specific format of vimeo Video URLs is accepted and it should be in the format of ‘https://player.vimeo.com/video/videoID’ and ‘Save Video URL’ button is disabled if video URL doesn’t meet the format and the video does not exist. 

Actions

The administrators can also edit and delete video URLs 

Edit Action 

 Figure 9: ‘Edit’ and ‘Delete’ actions in Video URL grid 

The ‘edit’ action in admin grid result in a popup to edit VideoURL and its status. 

 Figure 10: Editing the videoUR 

 Setting ‘Cover Image 

The frame of videoURL gets added to Product Media as shown in Figure 11 when a videoURL is added and enabled . The admin can set the cover image manually. Then the frame of URL becomes ‘cover image’ on product listing and detail page on frontend as shown in Figure 12. 

Note: The admin must delete video URL first before deleting video frame of URL in Product Media. 

 Figure 11. Setting ‘cover image’ to video frame generated from URL added in Product Media 

 Figure 12. URL frame becomes the cover image 

How it works on Frontend

The videoURL which are enabled in backend gets rendered on product detail page within image gallery slider. In case of editing the URLs in backend, it gets reflected on frontend accordingly. The URLs which are edited on backend will be reflected on frontend as shown in Figure 14. The URLs before it undergoes editing rendered on Product Detail Page is shown in Figure 13. 

 Figure 13. The videoURL before it undergoes editing rendered on Product Detail Page 

 Figure 14. The videoURL after it undergoes editing rendered on Product Detail Page 

Supported Languages

 English(United Kingdom), German 

Change Log / Release Notes

Version: 1.0.0 : August, 2024 

  • Initial version 

Support

 If you have questions, use our contact form in https://www.webshopextension.com or email to support@webshopextension.com