Skip to main content

Documentation Smart YouTube Embed

Compatibility:  
Extension type:  
Version:   2.0

YouTube SmartEmbed Module

Modern YouTube Video Embedding for Joomla 4+

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

  1. Log in to your Joomla administrator panel
  2. Navigate to System → Install → Extensions
  3. Select the Upload Package File tab
  4. Click Browse and select the downloaded mod_xxxxxx.zip file
  5. Click Upload & Install
  6. Navigate to Content → Site Modules
  7. Click New and select YouTube Smart Embed from the module type list
  8. Configure the module settings (see details below)
  9. 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
  10. Publish the module to your desired position

Manual Installation

  1. Unzip the downloaded package on your computer
  2. Using FTP, upload the mod_youtube_smartembed folder to the /modules/ directory of your Joomla installation
  3. Log in to your Joomla administrator panel
  4. Navigate to System → Discover
  5. Find the YouTube SmartEmbed module and click Install
  6. 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).

Order Now

Single Website
(12 months)

€ 19,99
  • Support for a single website.
  • 12 months of support.
  • 12 months of access to downloads.

Multiple websites
(6 months)

€ 29,99
  • Support for unlimited websites.
  • 6 months of support.
  • 6 months of access to downloads.