From ac5c8d18b2ba52c2da430e8054df637a84d4deab Mon Sep 17 00:00:00 2001
From: Jonathan Miller <jmiller-moko@noreply.git.mokoconsulting.tech>
Date: Thu, 28 May 2026 14:39:27 -0500
Subject: [PATCH] feat: add YouTube video support for hero background

Detect YouTube URLs (youtube.com/watch, youtu.be, youtube.com/embed)
and render a privacy-enhanced iframe embed instead of a <video> tag.
Local video files still work as before via the <video> element.

- Extract YouTube video ID via regex in entry point
- Render iframe with autoplay, muted, looped, no controls
- Use youtube-nocookie.com for privacy
- Add pointer-events: none to prevent interaction with video layer
- Update video field label/description to mention YouTube support

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/css/template.css                        |  2 ++
 src/language/en-GB/mod_mokojoomhero.sys.ini |  4 ++--
 src/mod_mokojoomhero.php                    | 16 +++++++++++-----
 src/tmpl/default.php                        |  5 ++++-
 4 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/src/css/template.css b/src/css/template.css
index 795a90c..fde141a 100644
--- a/src/css/template.css
+++ b/src/css/template.css
@@ -48,6 +48,8 @@
 	width: 100%;
 	height: 100%;
 	object-fit: cover;
+	border: 0;
+	pointer-events: none;
 }
 
 /* ============================================================
diff --git a/src/language/en-GB/mod_mokojoomhero.sys.ini b/src/language/en-GB/mod_mokojoomhero.sys.ini
index ffdc730..4d3533e 100644
--- a/src/language/en-GB/mod_mokojoomhero.sys.ini
+++ b/src/language/en-GB/mod_mokojoomhero.sys.ini
@@ -27,8 +27,8 @@ MOD_MOKOJOOMHERO_SLIDE_INTERVAL_LABEL="Slide Interval (ms)"
 MOD_MOKOJOOMHERO_SLIDE_INTERVAL_DESC="Time between slides in milliseconds (e.g. 5000 = 5 seconds)."
 
 ; Video settings
-MOD_MOKOJOOMHERO_VIDEO_FILE_LABEL="Video File"
-MOD_MOKOJOOMHERO_VIDEO_FILE_DESC="Path or URL to the background video file (MP4 recommended)."
+MOD_MOKOJOOMHERO_VIDEO_FILE_LABEL="Video File / YouTube URL"
+MOD_MOKOJOOMHERO_VIDEO_FILE_DESC="Path to a local video file (MP4), or a YouTube URL (e.g. https://www.youtube.com/watch?v=abc123)."
 
 ; Hero height
 MOD_MOKOJOOMHERO_HERO_HEIGHT_LABEL="Hero Height"
diff --git a/src/mod_mokojoomhero.php b/src/mod_mokojoomhero.php
index f8e908a..a03804c 100644
--- a/src/mod_mokojoomhero.php
+++ b/src/mod_mokojoomhero.php
@@ -60,13 +60,19 @@ if ($heroMode === 'images') {
     }
 }
 
-// Build video URL (relative path → absolute)
-$videoUrl = '';
+// Build video URL — detect YouTube vs local file
+$videoUrl   = '';
+$youtubeId  = '';
 
 if ($heroMode === 'video' && $videoFile) {
-    $videoUrl = (strpos($videoFile, '://') !== false)
-        ? $videoFile
-        : Uri::root() . ltrim($videoFile, '/');
+    // Match youtube.com/watch?v=ID, youtu.be/ID, youtube.com/embed/ID
+    if (preg_match('/(?:youtube\.com\/(?:watch\?v=|embed\/)|youtu\.be\/)([\w-]{11})/', $videoFile, $m)) {
+        $youtubeId = $m[1];
+    } else {
+        $videoUrl = (strpos($videoFile, '://') !== false)
+            ? $videoFile
+            : Uri::root() . ltrim($videoFile, '/');
+    }
 }
 
 // Module content from the editor (overlay text)
diff --git a/src/tmpl/default.php b/src/tmpl/default.php
index f4042b8..5ed6791 100644
--- a/src/tmpl/default.php
+++ b/src/tmpl/default.php
@@ -16,6 +16,7 @@ use Joomla\CMS\Language\Text;
 /** @var array  $heroImages */
 /** @var int    $slideInterval */
 /** @var string $videoUrl */
+/** @var string $youtubeId */
 /** @var string $heroHeight */
 /** @var string $overlayColor */
 /** @var float  $overlayOpacity */
@@ -40,7 +41,9 @@ $heightAttr = htmlspecialchars($heroHeight, ENT_QUOTES, 'UTF-8');
 	<?php endif; ?>
 >
 	<?php // Background layer — single image, slideshow, or video ?>
-	<?php if ($heroMode === 'video' && $videoUrl) : ?>
+	<?php if ($heroMode === 'video' && $youtubeId) : ?>
+		<iframe class="mokojoomhero__video" src="https://www.youtube-nocookie.com/embed/<?php echo htmlspecialchars($youtubeId, ENT_QUOTES, 'UTF-8'); ?>?autoplay=1&mute=1&loop=1&playlist=<?php echo htmlspecialchars($youtubeId, ENT_QUOTES, 'UTF-8'); ?>&controls=0&showinfo=0&rel=0&modestbranding=1&playsinline=1" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
+	<?php elseif ($heroMode === 'video' && $videoUrl) : ?>
 		<video class="mokojoomhero__video" autoplay muted loop playsinline>
 			<source src="<?php echo htmlspecialchars($videoUrl, ENT_QUOTES, 'UTF-8'); ?>">
 		</video>