YouTube SmartEmbed is a premium Joomla module that allows you to embed YouTube videos on your website with advanced features like lightbox display, custom thumbnails, rounded corners, and responsive design.
Requirements
Joomla 4.0 or higher PHP 7.4 or higher
Modern browser with JavaScript enabled
Admin access to your Joomla website for installation
Installation Instructions
Standard Joomla Installation
Log in to your Joomla administrator panel
Navigate to System → Install → Extensions
Select the Upload Package File tab
Click Browse and select the downloaded mod_xxxxxx.zip file
Click Upload & Install
Navigate to Content → Site Modules
Click New and select YouTube Smart Embed from the module type list
Configure the module settings (see details below)
Go to the Menu Assignment tab and select which pages you want the module to appear on:
On all pages - The module will appear on every page of your site
No pages - The module will be disabled
Only on the pages selected - The module will only appear on pages you specifically select
On all pages except those selected - The module will appear on all pages except those you specifically exclude
Publish the module to your desired position
Manual Installation
Unzip the downloaded package on your computer
Using FTP, upload the mod_youtube_smartembed folder to the /modules/ directory of your Joomla installation
Log in to your Joomla administrator panel
Navigate to System → Discover
Find the YouTube SmartEmbed module and click Install
Navigate to Content → Site Modules to create and configure a new instance of the module
Module settings
Basic Settings
YouTube Video URL
Enter the full URL of the YouTube video you want to embed. The module accepts standard YouTube URLs (youtube.com/watch?v=VIDEO_ID), shortened URLs (youtu.be/VIDEO_ID), or embed URLs (youtube.com/embed/VIDEO_ID).
Lightbox Mode
When enabled, the video displays as a thumbnail that opens in a lightbox overlay when clicked. When disabled, the video is embedded directly on the page.
Custom Thumbnail
Upload a custom image to use as the video thumbnail instead of the default YouTube thumbnail. Only available when Lightbox Mode is enabled.
Thumbnail Quality
Select the quality level for the YouTube thumbnail (from Highest Quality to Default Quality). Only available when Lightbox Mode is enabled and no custom thumbnail is selected.
Video Settings
Autoplay
When enabled, the video will automatically start playing when loaded. Note: Due to browser policies, autoplay usually requires the video to be muted.
Loop
When enabled, the video will play continuously, restarting when it ends.
Mute
When enabled, the video will start with the sound off.
Controls
When enabled, the YouTube player controls will be visible. When disabled, the controls are hidden.
Display Settings
Lazy Loading
When enabled, the video will only load when it becomes visible in the viewport, improving page load performance.
Rounded Corners
When enabled, applies rounded corners to the video player and thumbnail for a modern look.
Video Width
Set the width of the video player as a percentage of its container (20%, 25%, 33%, 50%, 66%, or 100%).
Alignment
Set the horizontal alignment of the video player (Left, Center, or Right).
