Select your language

Privacy Embed for YouTube – Documentation

Privacy Embed for YouTube provides privacy-friendly embedding of YouTube videos in Joomla 5 and Joomla 6. Simply add a normal YouTube URL to your content. The actual YouTube video is loaded only after the visitor explicitly chooses to load it.

Installation

Install the downloaded ZIP package using the Joomla Extension Installer:

System → Install → Extensions

Select the downloaded ZIP file and complete the installation.

Privacy Embed for YouTube is a content plugin. After installation, check System → Plugins to make sure the plugin is enabled.

Adding a YouTube Video

To embed a video, simply insert the normal YouTube URL into your Joomla article.

Supported YouTube URL formats include:

  • youtube.com/watch
  • youtu.be
  • youtube.com/shorts/
  • youtube.com/live/

Example:

https://www.youtube.com/watch?v=VIDEO-ID

The plugin automatically detects the YouTube URL and replaces it with the privacy-friendly video display when the article is rendered.

Video Alignment

The alignment can be specified directly in the YouTube URL by adding one of the following parameters:

  • #left – align left
  • #center – center
  • #right – align right

Examples:

https://www.youtube.com/watch?v=VIDEO-ID#left

https://www.youtube.com/watch?v=VIDEO-ID#center

https://www.youtube.com/watch?v=VIDEO-ID#right

If no alignment is specified, the video is centered by default.

Setting an Individual Width

The desired video width can also be added directly to the YouTube URL. The number specifies the desired width in pixels.

Example for a width of 500 pixels:

https://www.youtube.com/watch?v=VIDEO-ID#500

Without an individual width setting, the plugin uses 50% of the available content width by default.

Combining Alignment and Width

Alignment and width can be combined. The order of the parameters does not matter.

Examples:

https://www.youtube.com/watch?v=VIDEO-ID#left#500

https://www.youtube.com/watch?v=VIDEO-ID#500#left

https://www.youtube.com/watch?v=VIDEO-ID#right#700

https://www.youtube.com/watch?v=VIDEO-ID#center#400

TinyMCE and JCE

Privacy Embed for YouTube is designed for use with the Joomla TinyMCE and JCE editors.

The plugin can also detect and process a YouTube URL if the editor automatically converts the inserted URL into a link.

With JCE, the additional alignment and width parameters are also recognized if the editor places them inside the link or linked text while editing the URL.

Privacy-Friendly Loading

When the page is initially opened, no YouTube video or YouTube iframe is loaded.

Instead, the visitor first sees a preview or local placeholder together with the configured privacy notice and button for loading the video.

The video is embedded only after the visitor clicks the button to load the YouTube video. Playback uses YouTube's privacy-enhanced No-Cookie domain.

Consent is not stored permanently. A YouTube video therefore does not automatically load on subsequent page visits.

Plugin Settings

The plugin settings provide several options for controlling the appearance and behaviour of embedded videos, including:

  • privacy notice text
  • video loading button text
  • privacy policy link
  • privacy link colour
  • autoplay after the video has been enabled
  • video aspect ratio
  • maximum width
  • thumbnail quality
  • thumbnail cache duration

Available aspect ratios are 16:9, 4:3, 9:16 and 1:1.

Thumbnails

YouTube thumbnails used for the preview are cached locally. This avoids an immediate connection to YouTube during a normal page request.

If no suitable thumbnail is available, a local neutral placeholder can be used.

Updates

New versions are detected through Joomla's integrated update system.

To access protected update packages, the email address used for the Fourthwall purchase is entered once. Purchase eligibility is verified and update access is then configured for the installation.

No additional license key or mandatory activation is required. Privacy Embed for YouTube remains fully functional even without configured update access. Only the download of new update packages is protected.

A newer version downloaded manually through Fourthwall can also be installed using the Joomla Extension Installer.

Bild für Facebook auswählen

Wähle das Bild, das beim Teilen dieses Beitrags über Facebook verwendet werden soll.

Kein geeignetes Artikelbild gefunden.

Es werden nur lokale Bilder mit mindestens 600 × 315 Pixel angeboten.

Bild für WhatsApp auswählen

Wähle das Bild, das beim Teilen dieses Beitrags über WhatsApp verwendet werden soll.

Kein geeignetes Artikelbild gefunden.

Es werden nur lokale Bilder mit mindestens 600 × 315 Pixel angeboten.