chore(release): build 01.20.00 [skip ci]

Update module description to reflect all current capabilities. Rewrite
README from old template-era content to accurate module documentation
with feature list, project structure, and installation instructions.
Update Gitea repo description.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.mokogitea/manifest.xml

@@ -10,7 +10,7 @@
     <display-name>Package - MokoJoomHero</display-name>
     <org>MokoConsulting</org>
     <description>A Joomla Module designed to provide a random image from a folder with content on top as a Hero.</description>
-    <version>01.08.00</version>
+    <version>01.20.00</version>
     <license spdx="GPL-3.0-or-later">GNU General Public License v3</license>
   </identity>
   <governance>

.mokogitea/workflows/auto-release.yml

@@ -102,13 +102,14 @@ jobs:
         run: |
           php /tmp/moko-platform-api/cli/release_publish.php \
             --path . --stability rc --bump minor --branch rc \
-            --token "${{ secrets.MOKOGITEA_TOKEN }}"
+            --token "${{ secrets.MOKOGITEA_TOKEN }}" \
+            --skip-update-stream
 
       - name: Summary
         if: always()
         run: |
           echo "## Promoted to Release Candidate" >> $GITHUB_STEP_SUMMARY
-          echo "Branch renamed to rc, minor bump, RC + lesser stream releases built, updates.xml synced" >> $GITHUB_STEP_SUMMARY
+          echo "Branch renamed to rc, minor bump, RC release built (updates.xml managed by Gitea Pages)" >> $GITHUB_STEP_SUMMARY
 
   # ── Merged PR → Build & Release (or promote RC to stable) ────────────────────
   release:
@@ -167,7 +168,8 @@ jobs:
         run: |
           php /tmp/moko-platform-api/cli/release_publish.php \
             --path . --stability stable --bump minor --branch main \
-            --token "${{ secrets.MOKOGITEA_TOKEN }}"
+            --token "${{ secrets.MOKOGITEA_TOKEN }}" \
+            --skip-update-stream
 
       # -- STEP 9: Mirror to GitHub (stable only) --------------------------------
       - name: "Step 9: Mirror release to GitHub"

.mokogitea/workflows/issue-branch.yml

@@ -5,7 +5,7 @@
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: moko-platform.Automation
-# VERSION: 01.08.00
+# VERSION: 01.20.00
 # BRIEF: Auto-create feature branch when an issue is opened
 
 name: "Universal: Issue Branch"

.mokogitea/workflows/pr-check.yml

@@ -147,6 +147,98 @@ jobs:
           echo "PHP lint: ${ERRORS} error(s)"
           [ "$ERRORS" -eq 0 ] || { echo "::error::PHP syntax errors found"; exit 1; }
 
+      - name: Joomla JEXEC guard check
+        if: steps.platform.outputs.platform == 'joomla'
+        run: |
+          ERRORS=0
+          while IFS= read -r -d '' file; do
+            # Skip vendor, node_modules, and index.html stub files
+            case "$file" in ./vendor/*|./node_modules/*) continue ;; esac
+            # Check first 10 lines for JEXEC or JPATH guard
+            if ! head -20 "$file" | grep -qE "defined\s*\(\s*['\"](_JEXEC|JPATH_BASE|\\\\JPATH_PLATFORM)['\"]"; then
+              echo "::error file=${file}::Missing JEXEC guard: ${file}"
+              ERRORS=$((ERRORS + 1))
+            fi
+          done < <(find . -name "*.php" -path "*/src/*" -not -path "./.git/*" -not -path "./vendor/*" -print0)
+          if [ "$ERRORS" -gt 0 ]; then
+            echo "::error::${ERRORS} PHP file(s) missing defined('_JEXEC') or die guard"
+            echo "## JEXEC Guard Check: Failed" >> $GITHUB_STEP_SUMMARY
+            echo "${ERRORS} file(s) in src/ are missing the Joomla execution guard." >> $GITHUB_STEP_SUMMARY
+            exit 1
+          fi
+          echo "JEXEC guard: OK"
+
+      - name: Joomla directory listing protection
+        if: steps.platform.outputs.platform == 'joomla'
+        run: |
+          MISSING=0
+          SOURCE_DIR="src"
+          [ ! -d "$SOURCE_DIR" ] && exit 0
+          while IFS= read -r dir; do
+            if [ ! -f "${dir}/index.html" ]; then
+              echo "::warning::Missing index.html in ${dir} (directory listing protection)"
+              MISSING=$((MISSING + 1))
+            fi
+          done < <(find "$SOURCE_DIR" -type d -not -path "./.git/*" -not -path "*/vendor/*" -not -path "*/node_modules/*")
+          if [ "$MISSING" -gt 0 ]; then
+            echo "## Directory Protection" >> $GITHUB_STEP_SUMMARY
+            echo "${MISSING} director(ies) missing index.html" >> $GITHUB_STEP_SUMMARY
+          fi
+          echo "Directory protection: ${MISSING} missing (advisory)"
+
+      - name: Joomla script file and asset checks
+        if: steps.platform.outputs.platform == 'joomla'
+        run: |
+          ERRORS=0
+          MANIFEST=$(find . -maxdepth 3 -name "*.xml" ! -path "./.git/*" -exec grep -l '<extension' {} \; 2>/dev/null | head -1)
+          [ -z "$MANIFEST" ] && exit 0
+          MANIFEST_DIR=$(dirname "$MANIFEST")
+
+          # Check scriptfile exists if declared
+          SCRIPTFILE=$(sed -n 's/.*<scriptfile>\([^<]*\)<\/scriptfile>.*/\1/p' "$MANIFEST" 2>/dev/null)
+          if [ -n "$SCRIPTFILE" ]; then
+            if [ ! -f "${MANIFEST_DIR}/${SCRIPTFILE}" ]; then
+              echo "::error::Manifest declares <scriptfile>${SCRIPTFILE}</scriptfile> but file not found at ${MANIFEST_DIR}/${SCRIPTFILE}"
+              ERRORS=$((ERRORS + 1))
+            else
+              echo "Script file: ${MANIFEST_DIR}/${SCRIPTFILE} (OK)"
+            fi
+          fi
+
+          # Require joomla.asset.json and validate it
+          ASSET_JSON=$(find "$MANIFEST_DIR" -name "joomla.asset.json" -not -path "./.git/*" 2>/dev/null | head -1)
+          if [ -z "$ASSET_JSON" ]; then
+            echo "::error::joomla.asset.json not found — Joomla asset system is required"
+            ERRORS=$((ERRORS + 1))
+          else
+            if command -v php &> /dev/null; then
+              php -r "json_decode(file_get_contents('$ASSET_JSON')); if(json_last_error()!==JSON_ERROR_NONE){echo json_last_error_msg();exit(1);}" 2>&1 || {
+                echo "::error::joomla.asset.json is not valid JSON"
+                ERRORS=$((ERRORS + 1))
+              }
+            fi
+            echo "joomla.asset.json: valid"
+          fi
+
+          # Validate all XML files in src/ are well-formed
+          XML_ERRORS=0
+          if command -v php &> /dev/null; then
+            while IFS= read -r -d '' xmlfile; do
+              if ! php -r "libxml_use_internal_errors(true); \$x = simplexml_load_file('$xmlfile'); if(!\$x){foreach(libxml_get_errors() as \$e) echo trim(\$e->message) . ' in $xmlfile'; exit(1);}" 2>&1; then
+                XML_ERRORS=$((XML_ERRORS + 1))
+              fi
+            done < <(find "$MANIFEST_DIR" -name "*.xml" -not -path "./.git/*" -print0)
+          fi
+          if [ "$XML_ERRORS" -gt 0 ]; then
+            echo "::error::${XML_ERRORS} XML file(s) are malformed"
+            ERRORS=$((ERRORS + 1))
+          else
+            echo "XML well-formedness: OK"
+          fi
+
+          [ "$ERRORS" -gt 0 ] && exit 1
+          echo "Joomla asset checks: OK"
+
       - name: Validate platform manifest
         run: |
           PLATFORM="${{ steps.platform.outputs.platform }}"
@@ -164,6 +256,13 @@ jobs:
               for ELEMENT in name version description; do
                 grep -q "<${ELEMENT}>" "$MANIFEST" || { echo "::error::Missing <${ELEMENT}> in manifest"; exit 1; }
               done
+              # Block legacy raw/branch update server URLs on MokoGitea
+              RAW_URLS=$(grep -n 'raw/branch' "$MANIFEST" | grep -i 'mokoconsulting\|mokogitea\|git\.mokoconsulting\.tech' || true)
+              if [ -n "$RAW_URLS" ]; then
+                echo "::error::Manifest contains legacy raw/branch update server URL on MokoGitea. Use the Gitea Pages URL instead (e.g. /{REPO}/updates.xml not /{REPO}/raw/branch/main/updates.xml)"
+                echo "$RAW_URLS"
+                exit 1
+              fi
               echo "Joomla manifest valid"
               ;;
             dolibarr)
@@ -196,6 +295,138 @@ jobs:
               ;;
           esac
 
+      - name: Validate Joomla language files
+        if: steps.platform.outputs.platform == 'joomla'
+        run: |
+          ERRORS=0
+          WARNINGS=0
+
+          # Require both en-GB and en-US language directories
+          LANG_ROOT=$(find . -path "*/language" -type d -not -path "./.git/*" 2>/dev/null | head -1)
+          if [ -z "$LANG_ROOT" ]; then
+            echo "No language/ directory found — skipping"
+            exit 0
+          fi
+
+          if [ ! -d "$LANG_ROOT/en-GB" ]; then
+            echo "::error::Missing en-GB language directory (${LANG_ROOT}/en-GB)"
+            ERRORS=$((ERRORS + 1))
+          fi
+          if [ ! -d "$LANG_ROOT/en-US" ]; then
+            echo "::error::Missing en-US language directory (${LANG_ROOT}/en-US)"
+            ERRORS=$((ERRORS + 1))
+          fi
+
+          # Check that en-GB and en-US have matching .ini files
+          if [ -d "$LANG_ROOT/en-GB" ] && [ -d "$LANG_ROOT/en-US" ]; then
+            for GB_INI in "$LANG_ROOT/en-GB"/*.ini; do
+              [ ! -f "$GB_INI" ] && continue
+              US_INI="$LANG_ROOT/en-US/$(basename "$GB_INI")"
+              if [ ! -f "$US_INI" ]; then
+                echo "::error::$(basename "$GB_INI") exists in en-GB but missing from en-US"
+                ERRORS=$((ERRORS + 1))
+              fi
+            done
+            for US_INI in "$LANG_ROOT/en-US"/*.ini; do
+              [ ! -f "$US_INI" ] && continue
+              GB_INI="$LANG_ROOT/en-GB/$(basename "$US_INI")"
+              if [ ! -f "$GB_INI" ]; then
+                echo "::error::$(basename "$US_INI") exists in en-US but missing from en-GB"
+                ERRORS=$((ERRORS + 1))
+              fi
+            done
+          fi
+
+          # Find all .ini language files
+          INI_FILES=$(find . -path "*/language/*/*.ini" -not -path "./.git/*" 2>/dev/null)
+          if [ -z "$INI_FILES" ]; then
+            echo "No .ini language files found"
+            [ "$ERRORS" -gt 0 ] && exit 1
+            exit 0
+          fi
+
+          echo "Found $(echo "$INI_FILES" | wc -l) language file(s)"
+
+          for FILE in $INI_FILES; do
+            FNAME=$(basename "$FILE")
+            LINENUM=0
+            SEEN_KEYS=""
+
+            while IFS= read -r line || [ -n "$line" ]; do
+              LINENUM=$((LINENUM + 1))
+
+              # Skip empty lines and comments
+              [ -z "$line" ] && continue
+              echo "$line" | grep -qE '^\s*;' && continue
+              echo "$line" | grep -qE '^\s*$' && continue
+
+              # Must match KEY="VALUE" format
+              if ! echo "$line" | grep -qE '^[A-Z_][A-Z0-9_]*=".*"$'; then
+                echo "::error file=${FILE},line=${LINENUM}::Malformed line: ${line}"
+                ERRORS=$((ERRORS + 1))
+                continue
+              fi
+
+              # Extract key and check for duplicates
+              KEY=$(echo "$line" | sed 's/=.*//')
+              if echo "$SEEN_KEYS" | grep -qx "$KEY"; then
+                echo "::error file=${FILE},line=${LINENUM}::Duplicate key: ${KEY}"
+                ERRORS=$((ERRORS + 1))
+              fi
+              SEEN_KEYS="${SEEN_KEYS}
+          ${KEY}"
+            done < "$FILE"
+
+            echo "  ${FILE}: checked ${LINENUM} lines"
+          done
+
+          # Cross-check en-GB vs en-US key consistency
+          GB_DIR=$(find . -path "*/language/en-GB" -type d -not -path "./.git/*" 2>/dev/null | head -1)
+          US_DIR=$(find . -path "*/language/en-US" -type d -not -path "./.git/*" 2>/dev/null | head -1)
+
+          if [ -n "$GB_DIR" ] && [ -n "$US_DIR" ]; then
+            for GB_FILE in "$GB_DIR"/*.ini; do
+              [ ! -f "$GB_FILE" ] && continue
+              FNAME=$(basename "$GB_FILE")
+              US_FILE="$US_DIR/$FNAME"
+              [ ! -f "$US_FILE" ] && continue
+
+              GB_KEYS=$(grep -oP '^[A-Z_][A-Z0-9_]*(?==)' "$GB_FILE" 2>/dev/null | sort)
+              US_KEYS=$(grep -oP '^[A-Z_][A-Z0-9_]*(?==)' "$US_FILE" 2>/dev/null | sort)
+
+              # Keys in en-GB but not en-US
+              MISSING_US=$(comm -23 <(echo "$GB_KEYS") <(echo "$US_KEYS"))
+              if [ -n "$MISSING_US" ]; then
+                echo "::warning::Keys in en-GB/$FNAME but missing from en-US/$FNAME:"
+                echo "$MISSING_US" | while read -r k; do echo "  - $k"; done
+                WARNINGS=$((WARNINGS + 1))
+              fi
+
+              # Keys in en-US but not en-GB
+              MISSING_GB=$(comm -13 <(echo "$GB_KEYS") <(echo "$US_KEYS"))
+              if [ -n "$MISSING_GB" ]; then
+                echo "::warning::Keys in en-US/$FNAME but missing from en-GB/$FNAME:"
+                echo "$MISSING_GB" | while read -r k; do echo "  - $k"; done
+                WARNINGS=$((WARNINGS + 1))
+              fi
+            done
+          fi
+
+          {
+            echo "### Language File Validation"
+            echo "| Metric | Count |"
+            echo "|---|---|"
+            echo "| Files checked | $(echo "$INI_FILES" | wc -l) |"
+            echo "| Errors | ${ERRORS} |"
+            echo "| Warnings | ${WARNINGS} |"
+          } >> $GITHUB_STEP_SUMMARY
+
+          if [ "$ERRORS" -gt 0 ]; then
+            echo "::error::Language validation failed with ${ERRORS} error(s)"
+            exit 1
+          fi
+          echo "Language files: OK (${WARNINGS} warning(s))"
+
       - name: Check changelog has unreleased entry
         run: |
           if [ ! -f "CHANGELOG.md" ]; then

CHANGELOG.md

@@ -1,46 +1,27 @@
 # Changelog
-
 ## [Unreleased]
 
+## [01.20.00] --- 2026-06-04
 
-All notable changes to this project will be documented in this file.
+## [01.19.00] --- 2026-06-04
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
-Version format: `XX.YY.ZZ` (zero-padded semver).
 
-## [01.08.00] --- 2026-06-04
+## [01.18.00] --- 2026-06-04
 
-## [01.04.00] - 2026-05-30
+## [01.17] - 2026-06-04
 
 ### Added
-- Local Video hero mode with Joomla Media Manager file picker (`localVideoFile` param)
-- Install script (`script.php`) creates `images/heroes/` folder on install/update
-
-## [01.03.00] - 2026-05-30
-
-### Added
-- Configurable card fade-in delay with slide-up animation (`cardDelay` param, 0-5000ms) (#39)
-- Video mute/unmute toggle button (`showMuteToggle` param) -- supports YouTube, Vimeo, and native video (#40)
-
-## [01.02.00] - 2026-05-30
+- Download key support (`dlid`) in module manifest for update server authentication
+- Auto-remove deprecated system plugin (`plg_system_mokojoomhero`) on install/upgrade
 
 ### Fixed
-- WebAsset registration: added `#style`/`#script` suffixes to preset dependencies (was causing `UnsatisfiedDependencyException`)
-- Asset URI resolution: use `extension/filename` pattern instead of `extension/folder/filename` (Joomla auto-inserts `css/`/`js/` folders)
-- iframe video cover: split CSS into `<video>` (`object-fit: cover`) and `<iframe>` (oversize + centre-crop) rules since `object-fit` doesn't apply to iframes
-- Card link styling: exclude `.btn` elements from `color: inherit` so buttons retain their own styles
+- Skip overlay background on solid colour and gradient hero modes — gradient was invisible behind 50% black overlay
 
-### Added
-- Module title renders inside the hero card as `<h2>`, respecting Joomla's Show Title toggle
-- IntersectionObserver pauses/resumes videos when the hero scrolls out of/into the viewport (YouTube, Vimeo, and native `<video>`)
-- YouTube embeds include `enablejsapi=1` for postMessage playback control
-
-## [01.01.00] - 2026-05-30
+## [01.14] - 2026-06-04
 
 ### Changed
-- Migrated all workflow and template paths from `.github/` to `.mokogitea/`
-- Template source paths updated
-- HCL definition files removed -- Template repos are now the canonical source
+- Update server URL to new Gitea release system
+- Use pretty name format for update server entry
 
-### Added
-- `branch-cleanup.yml`: auto-delete merged feature branches after PR merge
+### Fixed
+- Add missing `<updateservers>` section to module manifest

CLAUDE.md

@@ -32,25 +32,21 @@ composer install  # Install PHP dependencies
 
 ## Architecture
 
-This is a Joomla **package** extension (`pkg_mokojoomhero`) containing two sub-extensions:
+This is a Joomla **site module** (`mod_mokojoomhero`).
 
-### mod_mokojoomhero (Site Module)
 - Random hero image slideshow or background video with content overlay
 - Supports image folders, YouTube, Vimeo, local video, solid colour, gradient
 - Configurable overlay, text alignment, card animation, parallax, content animations
-- Works independently — no plugin dependency required
-
-### plg_system_mokojoomhero (System Plugin)
-- Placeholder for future system-level features
-- Auto-enabled on package install via `pkg_script.php`
-- Namespace: `Joomla\Plugin\System\MokoJoomHero`
+- A/B testing with weighted variations, scheduling with start/end datetime
+- Article content source, per-slide unique content via subform
 
 ### Key files
-- `src/pkg_mokojoomhero.xml` — package manifest
-- `src/pkg_script.php` — auto-enables system plugin on install
-- `src/packages/mod_mokojoomhero/` — hero module source
-- `src/packages/plg_system_mokojoomhero/` — system plugin source
-- `updates.xml` — Joomla update server (includes legacy module entries for migration)
+- `src/mod_mokojoomhero.xml` — module manifest
+- `src/mod_mokojoomhero.php` — module entry point
+- `src/tmpl/default.php` — template
+- `src/media/` — CSS, JS, and web asset registry
+- `src/language/` — en-GB and en-US translations
+- `src/script.php` — install script (creates default image folder)
 
 ## Rules
 
@@ -65,7 +61,4 @@ This is a Joomla **package** extension (`pkg_mokojoomhero`) containing two sub-e
 ## Coding Standards
 
 - PHP 8.1+ minimum
-- Joomla 5/6 DI container pattern: `services/provider.php` → Extension class
-- Legacy stub `.php` file required for plugin loader but empty
-- `SubscriberInterface` for event subscription (not `on*` method naming)
 - SPDX license headers on all PHP files

CODE_OF_CONDUCT.md

@@ -14,7 +14,7 @@
 	DEFGROUP:
 	INGROUP: Project.Documentation
 	REPO:
-	VERSION: 01.08.00
+	VERSION: 01.20.00
 	PATH: ./CODE_OF_CONDUCT.md
 	BRIEF: Reference + packaging repo for Moko Consulting Developer GPT Other Default
 -->

Makefile

@@ -13,7 +13,7 @@
 
 # Extension Configuration
 EXTENSION_NAME := mokojoomhero
-EXTENSION_TYPE := package
+EXTENSION_TYPE := module
 # Options: module, plugin, component, package, template
 EXTENSION_VERSION := 1.0.0
 
@@ -156,29 +156,11 @@ clean: ## Clean build artifacts
 
 .PHONY: build
 build: clean ## Build extension package
-	@echo "$(COLOR_BLUE)Building Joomla package extension...$(COLOR_RESET)"
-	@mkdir -p $(DIST_DIR) $(BUILD_DIR)/packages
-
-	@# --- Build each sub-extension as a separate ZIP ---
-	@for EXT_DIR in $(SRC_DIR)/packages/*/; do \
-		EXT_NAME=$$(basename "$$EXT_DIR"); \
-		[ "$$EXT_NAME" = "index.html" ] && continue; \
-		echo "  Packaging $$EXT_NAME..."; \
-		cd "$$EXT_DIR" && $(ZIP) -r "$(CURDIR)/$(BUILD_DIR)/packages/$${EXT_NAME}.zip" . \
-			-x "*.git*" -x "*/index.html" 2>/dev/null; \
-		cd "$(CURDIR)"; \
-	done
-
-	@# --- Build the outer package ZIP ---
-	@echo "  Assembling pkg_$(EXTENSION_NAME)..."
-	@cp $(SRC_DIR)/pkg_mokojoomhero.xml $(BUILD_DIR)/pkg_mokojoomhero.xml
-	@cp $(SRC_DIR)/pkg_script.php $(BUILD_DIR)/pkg_script.php
-	@cd $(BUILD_DIR) && $(ZIP) -r "$(CURDIR)/$(DIST_DIR)/pkg_$(EXTENSION_NAME)-$(EXTENSION_VERSION).zip" \
-		pkg_mokojoomhero.xml pkg_script.php packages/
-
-	@echo "$(COLOR_GREEN)✓ Package created: $(DIST_DIR)/pkg_$(EXTENSION_NAME)-$(EXTENSION_VERSION).zip$(COLOR_RESET)"
-	@echo "  Contents:"
-	@unzip -l "$(DIST_DIR)/pkg_$(EXTENSION_NAME)-$(EXTENSION_VERSION).zip" | tail -n +4 | head -20
+	@echo "$(COLOR_BLUE)Building Joomla module extension...$(COLOR_RESET)"
+	@mkdir -p $(DIST_DIR)
+	@cd $(SRC_DIR) && $(ZIP) -r "$(CURDIR)/$(DIST_DIR)/mod_$(EXTENSION_NAME)-$(EXTENSION_VERSION).zip" . \
+		-x "*.git*" -x "*/index.html" 2>/dev/null
+	@echo "$(COLOR_GREEN)✓ Module created: $(DIST_DIR)/mod_$(EXTENSION_NAME)-$(EXTENSION_VERSION).zip$(COLOR_RESET)"
 
 .PHONY: package
 package: build ## Alias for build

README.md

@@ -7,108 +7,83 @@
  # FILE INFORMATION
  REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero
  FILE: ./README.md
- VERSION: 01.08.00
- BRIEF: MokoJoomHero - Joomla Module
+ BRIEF: MokoJoomHero - Joomla Hero Module
  -->
 
 # MokoJoomHero
 
-A Joomla 5 site template developed following MokoStandards.
+A Joomla site module for random hero image slideshows, video backgrounds, solid colours, gradients, and content overlays.
 
 [![License](https://img.shields.io/badge/license-GPL--3.0--or--later-blue.svg)](LICENSE)
 
 ## Overview
 
-MokoJoomHero is a modern, accessible Joomla 5 template by Moko Consulting. It features a prominent hero section, flexible module positions, sticky header, customisable brand colour, and responsive layout — all built on Joomla's Web Asset Manager.
+MokoJoomHero is a free, open-source Joomla module that creates dynamic hero sections with multiple background modes, configurable content overlays, and advanced features like parallax scrolling, A/B testing, and scheduling. Designed for the MokoOnyx template but works with any Joomla 5/6 template.
 
 ## Features
 
-- **Hero Section**: Dedicated `hero` module position with gradient styling
-- **Flexible Layout**: 11 module positions including sidebars, topbar, banner, and footer
-- **Sticky Header**: Optional sticky navigation with smooth scroll
-- **Brand Customisation**: Configurable brand colour, logo, and tagline via Template Manager
-- **Responsive**: Mobile-first layout with CSS custom properties
-- **Accessibility**: Semantic HTML5, ARIA landmarks, skip-to-content support
-- **Web Asset Manager**: Modern asset loading via `joomla.asset.json`
-- **Error & Offline Pages**: Custom styled error and offline templates
+### Background Modes
+- **Image Slideshow** — random images from a folder with 4 transition types (crossfade, slide, fade-to-black, zoom/Ken Burns)
+- **Video** — YouTube, Vimeo, or local video with autoplay, mute toggle, and poster image
+- **Solid Colour** — single colour picker
+- **Gradient** — two-colour gradient with configurable angle
+
+### Content & Overlay
+- **WYSIWYG Editor** or **Joomla Article** as content source
+- **Per-slide content** — unique heading, body, and CTA per image slide via subform
+- **Card mode** — white card with shadow and fade-in delay
+- **Overlay** — solid or directional gradient (dark at bottom/top/left/right)
+- **Text alignment** — horizontal (left/center/right) and vertical (top/center/bottom)
+- **Content animations** — fade-in, slide-up, slide-left, slide-right with configurable delay
+
+### Advanced
+- **Parallax scroll** — background moves at configurable speed (0.1–0.9)
+- **A/B testing** — weighted random content variations, session-sticky per visitor
+- **Scheduling** — start/end datetime with site timezone support
+- **Scroll indicator** — animated chevron with smooth-scroll click handler
+- **Mobile height** — separate height setting for mobile viewports
+- **Reduced motion** — WCAG 2.1 AA compliant, respects `prefers-reduced-motion`
 
 ## Prerequisites
 
 - **PHP**: 8.1 or higher
-- **Joomla**: 5.x (also compatible with 6.x)
-- **Make**: GNU Make for build automation
+- **Joomla**: 5.x or 6.x
 
 ## Installation
 
-1. Build the template package:
-   ```bash
-   make build
-   ```
+1. Download the latest release from the [releases page](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases)
+2. Upload `mod_mokojoomhero-*.zip` via **System > Install > Upload Package File**
+3. Assign the module to a template position and configure
 
-2. Upload the generated `tpl_mokojoomhero-1.0.0.zip` via Joomla's Extension Manager
-
-3. Set as default template in **System → Site Template Styles**
-
-## Usage
+Or build from source:
 
 ```bash
-# Display available commands
-make help
-
-# Validate code
-make validate
-
-# Build template package
 make build
 ```
 
-## Module Positions
+## Usage
 
-| Position | Purpose |
-|----------|---------|
-| `topbar` | Slim bar above the header (contact info, social links) |
-| `banner` | Full-width banner below the header |
-| `menu` | Main navigation inside the header |
-| `hero` | Hero section with gradient background |
-| `breadcrumbs` | Breadcrumb trail |
-| `sidebar-left` | Left sidebar |
-| `sidebar-right` | Right sidebar |
-| `main-top` | Above the main content area |
-| `main-bottom` | Below the main content area |
-| `footer` | Footer area |
-| `debug` | Debug output (hidden from users) |
-
-## Template Parameters
-
-Configure via **System → Site Template Styles → MokoJoomHero**:
-
-- **Logo** — Upload a site logo image
-- **Site Description** — Tagline displayed next to the logo
-- **Brand Colour** — Primary accent colour (default: `#1a73e8`)
-- **Fluid Container** — Toggle full-width vs fixed-width layout
-- **Sticky Header** — Keep the header visible on scroll
-- **Back to Top** — Floating scroll-to-top button
+1. Go to **Content > Site Modules > MokoJoomHero**
+2. Select a **Hero Mode** (Images, Video, Solid Colour, or Gradient)
+3. Add content via the **Hero Content** tab
+4. Configure overlay, text alignment, and animations in **Overlay & Text**
+5. Assign to a module position and publish
 
 ## Project Structure
 
 ```
-.
-├── docs/                          # Documentation files
-├── scripts/                       # Build and deployment scripts
-├── src/                           # Template source code
-│   ├── css/template.css           # Main stylesheet
-│   ├── js/template.js             # Main JavaScript
-│   ├── images/                    # Template images
-│   ├── html/                      # Template overrides
-│   ├── language/en-GB/            # Language files
-│   ├── templateDetails.xml        # Joomla manifest
-│   ├── joomla.asset.json          # Web Asset Manager config
-│   ├── index.php                  # Main template
-│   ├── error.php                  # Error page
-│   ├── offline.php                # Offline page
-│   └── component.php              # Component-only output
-├── Makefile                       # Build automation
-└── README.md                      # This file
+src/
+├── mod_mokojoomhero.php      # Module entry point
+├── mod_mokojoomhero.xml      # Joomla manifest
+├── script.php                # Install script
+├── tmpl/default.php          # Template
+├── media/
+│   ├── css/mod_mokojoomhero.css
+│   ├── js/mod_mokojoomhero.js
+│   └── joomla.asset.json
+└── language/
+    ├── en-GB/
+    └── en-US/
 ```
 
 ## Contributing
@@ -117,9 +92,7 @@ We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guid
 
 ## Versioning
 
-This project uses [Semantic Versioning](https://semver.org/).
-
-See [CHANGELOG.md](CHANGELOG.md) for version history.
+This project uses [Semantic Versioning](https://semver.org/). See [CHANGELOG.md](CHANGELOG.md) for version history.
 
 ## License
 
@@ -131,6 +104,7 @@ SPDX-License-Identifier: GPL-3.0-or-later
 
 ## Support
 
-- **Documentation**: See the [docs/](docs/) directory
+- **Wiki**: [MokoJoomHero Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/wiki)
+- **Issues**: [Issue Tracker](https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/issues)
 - **Contact**: hello@mokoconsulting.tech
 - **Website**: [mokoconsulting.tech](https://mokoconsulting.tech)

SECURITY.md

@@ -23,7 +23,7 @@ DEFGROUP: [PROJECT_NAME]
 INGROUP: [PROJECT_NAME].Documentation
 REPO: [REPOSITORY_URL]
 PATH: /SECURITY.md
-VERSION: 01.08.00
+VERSION: 01.20.00
 BRIEF: Security vulnerability reporting and handling policy
 -->
 

src/language/en-GB/mod_mokojoomhero.ini

@@ -6,7 +6,7 @@
 ; INGROUP: MokoJoomHero.Module
 ; REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero
 ; PATH: /src/language/en-GB/mod_mokojoomhero.ini
-; VERSION: 01.08.00
+; VERSION: 01.20.00
 ; BRIEF: Language strings for MokoJoomHero module (frontend + admin form fields)
 
 MOD_MOKOJOOMHERO_NO_CONTENT="Add content to this module to display it over the hero image."
@@ -90,6 +90,25 @@ MOD_MOKOJOOMHERO_PARALLAX_DESC="Background moves at a slower rate than page cont
 MOD_MOKOJOOMHERO_PARALLAX_SPEED_LABEL="Parallax Speed"
 MOD_MOKOJOOMHERO_PARALLAX_SPEED_DESC="How much the background moves relative to scroll (0.1 = subtle, 0.9 = dramatic)."
 
+; A/B testing
+MOD_MOKOJOOMHERO_FIELDSET_AB="A/B Testing"
+MOD_MOKOJOOMHERO_AB_ENABLED_LABEL="Enable A/B Testing"
+MOD_MOKOJOOMHERO_AB_ENABLED_DESC="Randomly show different content variations to visitors. Assignment is sticky per session."
+MOD_MOKOJOOMHERO_AB_VARIATIONS_LABEL="Variations"
+MOD_MOKOJOOMHERO_AB_VARIATIONS_DESC="Define content variations with relative weights. Higher weight = higher chance of being shown."
+MOD_MOKOJOOMHERO_AB_VAR_LABEL="Label"
+MOD_MOKOJOOMHERO_AB_VAR_CONTENT="Content"
+MOD_MOKOJOOMHERO_AB_VAR_WEIGHT="Weight"
+
+; Scheduling
+MOD_MOKOJOOMHERO_FIELDSET_SCHEDULING="Scheduling"
+MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_LABEL="Enable Scheduling"
+MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_DESC="Only display the hero during a specific date/time range. Uses the site timezone."
+MOD_MOKOJOOMHERO_SCHEDULE_START_LABEL="Start Date/Time"
+MOD_MOKOJOOMHERO_SCHEDULE_START_DESC="The hero will not display before this date and time. Leave empty for no start restriction."
+MOD_MOKOJOOMHERO_SCHEDULE_END_LABEL="End Date/Time"
+MOD_MOKOJOOMHERO_SCHEDULE_END_DESC="The hero will not display after this date and time. Leave empty for no end restriction."
+
 ; Video poster
 MOD_MOKOJOOMHERO_VIDEO_POSTER_LABEL="Video Poster Image"
 MOD_MOKOJOOMHERO_VIDEO_POSTER_DESC="Fallback image displayed while the video loads. Prevents a blank hero on slow connections."

src/language/en-GB/mod_mokojoomhero.sys.ini

@@ -6,7 +6,7 @@
 ; INGROUP: MokoJoomHero.Module
 ; REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero
 ; PATH: /src/language/en-GB/mod_mokojoomhero.sys.ini
-; VERSION: 01.08.00
+; VERSION: 01.20.00
 ; BRIEF: System language strings — used in admin Extension Manager and Module Manager
 
 MOD_MOKOJOOMHERO="Module - MokoJoomHero"
@@ -91,6 +91,25 @@ MOD_MOKOJOOMHERO_PARALLAX_DESC="Background moves at a slower rate than page cont
 MOD_MOKOJOOMHERO_PARALLAX_SPEED_LABEL="Parallax Speed"
 MOD_MOKOJOOMHERO_PARALLAX_SPEED_DESC="How much the background moves relative to scroll (0.1 = subtle, 0.9 = dramatic)."
 
+; A/B testing
+MOD_MOKOJOOMHERO_FIELDSET_AB="A/B Testing"
+MOD_MOKOJOOMHERO_AB_ENABLED_LABEL="Enable A/B Testing"
+MOD_MOKOJOOMHERO_AB_ENABLED_DESC="Randomly show different content variations to visitors."
+MOD_MOKOJOOMHERO_AB_VARIATIONS_LABEL="Variations"
+MOD_MOKOJOOMHERO_AB_VARIATIONS_DESC="Define content variations with relative weights."
+MOD_MOKOJOOMHERO_AB_VAR_LABEL="Label"
+MOD_MOKOJOOMHERO_AB_VAR_CONTENT="Content"
+MOD_MOKOJOOMHERO_AB_VAR_WEIGHT="Weight"
+
+; Scheduling
+MOD_MOKOJOOMHERO_FIELDSET_SCHEDULING="Scheduling"
+MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_LABEL="Enable Scheduling"
+MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_DESC="Only display the hero during a specific date/time range."
+MOD_MOKOJOOMHERO_SCHEDULE_START_LABEL="Start Date/Time"
+MOD_MOKOJOOMHERO_SCHEDULE_START_DESC="The hero will not display before this date and time."
+MOD_MOKOJOOMHERO_SCHEDULE_END_LABEL="End Date/Time"
+MOD_MOKOJOOMHERO_SCHEDULE_END_DESC="The hero will not display after this date and time."
+
 ; Video poster
 MOD_MOKOJOOMHERO_VIDEO_POSTER_LABEL="Video Poster Image"
 MOD_MOKOJOOMHERO_VIDEO_POSTER_DESC="Fallback image displayed while the video loads."

src/language/en-US/mod_mokojoomhero.ini

@@ -6,7 +6,7 @@
 ; INGROUP: MokoJoomHero.Module
 ; REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero
 ; PATH: /src/language/en-US/mod_mokojoomhero.ini
-; VERSION: 01.08.00
+; VERSION: 01.20.00
 ; BRIEF: Language strings for MokoJoomHero module (en-US, frontend + admin form fields)
 
 MOD_MOKOJOOMHERO_NO_CONTENT="Add content to this module to display it over the hero image."
@@ -107,6 +107,25 @@ MOD_MOKOJOOMHERO_PARALLAX_DESC="Background moves at a slower rate than page cont
 MOD_MOKOJOOMHERO_PARALLAX_SPEED_LABEL="Parallax Speed"
 MOD_MOKOJOOMHERO_PARALLAX_SPEED_DESC="How much the background moves relative to scroll (0.1 = subtle, 0.9 = dramatic)."
 
+; A/B testing
+MOD_MOKOJOOMHERO_FIELDSET_AB="A/B Testing"
+MOD_MOKOJOOMHERO_AB_ENABLED_LABEL="Enable A/B Testing"
+MOD_MOKOJOOMHERO_AB_ENABLED_DESC="Randomly show different content variations to visitors. Assignment is sticky per session."
+MOD_MOKOJOOMHERO_AB_VARIATIONS_LABEL="Variations"
+MOD_MOKOJOOMHERO_AB_VARIATIONS_DESC="Define content variations with relative weights. Higher weight = higher chance of being shown."
+MOD_MOKOJOOMHERO_AB_VAR_LABEL="Label"
+MOD_MOKOJOOMHERO_AB_VAR_CONTENT="Content"
+MOD_MOKOJOOMHERO_AB_VAR_WEIGHT="Weight"
+
+; Scheduling
+MOD_MOKOJOOMHERO_FIELDSET_SCHEDULING="Scheduling"
+MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_LABEL="Enable Scheduling"
+MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_DESC="Only display the hero during a specific date/time range. Uses the site timezone."
+MOD_MOKOJOOMHERO_SCHEDULE_START_LABEL="Start Date/Time"
+MOD_MOKOJOOMHERO_SCHEDULE_START_DESC="The hero will not display before this date and time. Leave empty for no start restriction."
+MOD_MOKOJOOMHERO_SCHEDULE_END_LABEL="End Date/Time"
+MOD_MOKOJOOMHERO_SCHEDULE_END_DESC="The hero will not display after this date and time. Leave empty for no end restriction."
+
 ; Video poster
 MOD_MOKOJOOMHERO_VIDEO_POSTER_LABEL="Video Poster Image"
 MOD_MOKOJOOMHERO_VIDEO_POSTER_DESC="Fallback image displayed while the video loads. Prevents a blank hero on slow connections."

src/language/en-US/mod_mokojoomhero.sys.ini

@@ -6,7 +6,7 @@
 ; INGROUP: MokoJoomHero.Module
 ; REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero
 ; PATH: /src/language/en-US/mod_mokojoomhero.sys.ini
-; VERSION: 01.08.00
+; VERSION: 01.20.00
 ; BRIEF: System language strings — used in admin Extension Manager and Module Manager (en-US)
 
 MOD_MOKOJOOMHERO="Module - MokoJoomHero"
@@ -91,6 +91,25 @@ MOD_MOKOJOOMHERO_PARALLAX_DESC="Background moves at a slower rate than page cont
 MOD_MOKOJOOMHERO_PARALLAX_SPEED_LABEL="Parallax Speed"
 MOD_MOKOJOOMHERO_PARALLAX_SPEED_DESC="How much the background moves relative to scroll (0.1 = subtle, 0.9 = dramatic)."
 
+; A/B testing
+MOD_MOKOJOOMHERO_FIELDSET_AB="A/B Testing"
+MOD_MOKOJOOMHERO_AB_ENABLED_LABEL="Enable A/B Testing"
+MOD_MOKOJOOMHERO_AB_ENABLED_DESC="Randomly show different content variations to visitors."
+MOD_MOKOJOOMHERO_AB_VARIATIONS_LABEL="Variations"
+MOD_MOKOJOOMHERO_AB_VARIATIONS_DESC="Define content variations with relative weights."
+MOD_MOKOJOOMHERO_AB_VAR_LABEL="Label"
+MOD_MOKOJOOMHERO_AB_VAR_CONTENT="Content"
+MOD_MOKOJOOMHERO_AB_VAR_WEIGHT="Weight"
+
+; Scheduling
+MOD_MOKOJOOMHERO_FIELDSET_SCHEDULING="Scheduling"
+MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_LABEL="Enable Scheduling"
+MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_DESC="Only display the hero during a specific date/time range."
+MOD_MOKOJOOMHERO_SCHEDULE_START_LABEL="Start Date/Time"
+MOD_MOKOJOOMHERO_SCHEDULE_START_DESC="The hero will not display before this date and time."
+MOD_MOKOJOOMHERO_SCHEDULE_END_LABEL="End Date/Time"
+MOD_MOKOJOOMHERO_SCHEDULE_END_DESC="The hero will not display after this date and time."
+
 ; Video poster
 MOD_MOKOJOOMHERO_VIDEO_POSTER_LABEL="Video Poster Image"
 MOD_MOKOJOOMHERO_VIDEO_POSTER_DESC="Fallback image displayed while the video loads."

src/media/css/mod_mokojoomhero.css

@@ -6,8 +6,8 @@
  * DEFGROUP: MokoJoomHero.Module.Assets
  * INGROUP: MokoJoomHero.Module
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero
- * PATH: /src/packages/mod_mokojoomhero/media/css/mod_mokojoomhero.css
- * VERSION: 01.08.00
+ * PATH: /src/media/css/mod_mokojoomhero.css
+ * VERSION: 01.20.00
  * BRIEF: Hero module stylesheet — slideshow, video, colour/gradient, overlay, card, mute toggle, responsive
  */
 

src/media/js/mod_mokojoomhero.js

@@ -7,8 +7,8 @@
  * DEFGROUP: MokoJoomHero.Module.Assets
  * INGROUP: MokoJoomHero.Module
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero
- * PATH: /src/packages/mod_mokojoomhero/media/js/mod_mokojoomhero.js
- * VERSION: 01.08.00
+ * PATH: /src/media/js/mod_mokojoomhero.js
+ * VERSION: 01.20.00
  * BRIEF: Hero module JavaScript — slideshow crossfade, video viewport control, mute toggle
  */
 

src/mod_mokojoomhero.php

@@ -23,6 +23,73 @@ $wa = $app->getDocument()->getWebAssetManager();
 $wa->getRegistry()->addExtensionRegistryFile('mod_mokojoomhero');
 $wa->usePreset('mod_mokojoomhero');
 
+// Schedule check — skip rendering if outside the configured date range
+$scheduleEnabled = (bool) $params->get('scheduleEnabled', 0);
+
+if ($scheduleEnabled) {
+	$now           = new \DateTime('now', new \DateTimeZone($app->get('offset', 'UTC')));
+	$scheduleStart = $params->get('scheduleStart', '');
+	$scheduleEnd   = $params->get('scheduleEnd', '');
+
+	if ($scheduleStart) {
+		$start = new \DateTime($scheduleStart, new \DateTimeZone($app->get('offset', 'UTC')));
+
+		if ($now < $start) {
+			return;
+		}
+	}
+
+	if ($scheduleEnd) {
+		$end = new \DateTime($scheduleEnd, new \DateTimeZone($app->get('offset', 'UTC')));
+
+		if ($now > $end) {
+			return;
+		}
+	}
+}
+
+// A/B testing — weighted random variation, session-sticky per module instance
+$abEnabled = (bool) $params->get('abEnabled', 0);
+$abVariationContent = '';
+
+if ($abEnabled) {
+	$abVariations = $params->get('abVariations', '');
+	$abData = is_string($abVariations) ? json_decode($abVariations, true) : (array) $abVariations;
+
+	if (is_array($abData) && count($abData) > 0) {
+		$session    = \Joomla\CMS\Factory::getSession();
+		$sessionKey = 'mokojoomhero.ab.' . $module->id;
+		$picked     = $session->get($sessionKey, null);
+
+		if ($picked === null || !isset($abData[$picked])) {
+			// Weighted random selection
+			$totalWeight = 0;
+
+			foreach ($abData as $v) {
+				$totalWeight += (int) (((array) $v)['weight'] ?? 50);
+			}
+
+			$rand   = mt_rand(1, max($totalWeight, 1));
+			$cumulative = 0;
+			$picked = 0;
+
+			foreach ($abData as $i => $v) {
+				$cumulative += (int) (((array) $v)['weight'] ?? 50);
+
+				if ($rand <= $cumulative) {
+					$picked = $i;
+					break;
+				}
+			}
+
+			$session->set($sessionKey, $picked);
+		}
+
+		$variation = (array) ($abData[$picked] ?? []);
+		$abVariationContent = $variation['content'] ?? '';
+	}
+}
+
 // Module parameters
 $heroMode       = $params->get('heroMode', 'images');
 $imageFolder    = $params->get('imageFolder', 'images/heroes');
@@ -118,6 +185,11 @@ if (!in_array($contentAnimation, $allowedContentAnimations, true)) {
 $parallaxSpeed = max(0.1, min(0.9, $parallaxSpeed));
 $gradientAngle = max(0, min(360, $gradientAngle));
 
+// Apply A/B variation content if active
+if ($abEnabled && $abVariationContent) {
+	$heroContent = $abVariationContent;
+}
+
 // Collect hero images
 $heroImages = [];
 

src/mod_mokojoomhero.xml

@@ -10,20 +10,20 @@
   DEFGROUP: MokoJoomHero.Module
   INGROUP: MokoJoomHero
   REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero
-  PATH: /src/packages/mod_mokojoomhero/mod_mokojoomhero.xml
+  PATH: /src/mod_mokojoomhero.xml
   VERSION: 01.00.20
   BRIEF: Joomla module manifest — random hero image with content overlay
 -->
 <extension type="module" client="site" method="upgrade">
 	<name>Module - MokoJoomHero</name>
-	<creationDate>2026-05</creationDate>
+	<creationDate>2026-06-04</creationDate>
 	<author>Moko Consulting</author>
 	<authorEmail>hello@mokoconsulting.tech</authorEmail>
 	<authorUrl>https://mokoconsulting.tech</authorUrl>
 	<copyright>Copyright (C) 2026 Moko Consulting. All rights reserved.</copyright>
 	<license>GPL-3.0-or-later</license>
-	<version>01.08.00-rc</version>
-	<description>Displays a random hero image slideshow or background video with content overlaid. Designed for MokoOnyx template. By Moko Consulting.</description>
+	<version>01.20.00</version>
+	<description>Random hero image slideshow, video backgrounds, solid colour/gradient, parallax, content animations, A/B testing, scheduling, and overlay with card support. Free and open source. By Moko Consulting.</description>
 
 	<scriptfile>script.php</scriptfile>
 
@@ -48,6 +48,10 @@
 		<language tag="en-US">en-US/mod_mokojoomhero.sys.ini</language>
 	</languages>
 
+	<updateservers>
+		<server type="extension" name="Module - MokoJoomHero">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/updates.xml</server>
+	</updateservers>
+
 	<config>
 		<fields name="params">
 			<fieldset name="basic">
@@ -274,6 +278,89 @@
 					<option value="1">JYES</option>
 				</field>
 			</fieldset>
+			<fieldset name="abtesting"
+				label="MOD_MOKOJOOMHERO_FIELDSET_AB"
+			>
+				<field
+					name="abEnabled"
+					type="radio"
+					layout="joomla.form.field.radio.switcher"
+					label="MOD_MOKOJOOMHERO_AB_ENABLED_LABEL"
+					description="MOD_MOKOJOOMHERO_AB_ENABLED_DESC"
+					default="0"
+				>
+					<option value="0">JNO</option>
+					<option value="1">JYES</option>
+				</field>
+				<field
+					name="abVariations"
+					type="subform"
+					label="MOD_MOKOJOOMHERO_AB_VARIATIONS_LABEL"
+					description="MOD_MOKOJOOMHERO_AB_VARIATIONS_DESC"
+					multiple="true"
+					layout="joomla.form.field.subform.repeatable-table"
+					showon="abEnabled:1"
+					max="4"
+				>
+					<form>
+						<field
+							name="label"
+							type="text"
+							label="MOD_MOKOJOOMHERO_AB_VAR_LABEL"
+							filter="string"
+							default="Variation"
+						/>
+						<field
+							name="content"
+							type="textarea"
+							label="MOD_MOKOJOOMHERO_AB_VAR_CONTENT"
+							filter="safehtml"
+							rows="3"
+						/>
+						<field
+							name="weight"
+							type="number"
+							label="MOD_MOKOJOOMHERO_AB_VAR_WEIGHT"
+							default="50"
+							min="1"
+							max="100"
+						/>
+					</form>
+				</field>
+			</fieldset>
+			<fieldset name="scheduling"
+				label="MOD_MOKOJOOMHERO_FIELDSET_SCHEDULING"
+			>
+				<field
+					name="scheduleEnabled"
+					type="radio"
+					layout="joomla.form.field.radio.switcher"
+					label="MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_LABEL"
+					description="MOD_MOKOJOOMHERO_SCHEDULE_ENABLED_DESC"
+					default="0"
+				>
+					<option value="0">JNO</option>
+					<option value="1">JYES</option>
+				</field>
+				<field
+					name="scheduleStart"
+					type="calendar"
+					label="MOD_MOKOJOOMHERO_SCHEDULE_START_LABEL"
+					description="MOD_MOKOJOOMHERO_SCHEDULE_START_DESC"
+					format="%Y-%m-%d %H:%M"
+					showtime="true"
+					showon="scheduleEnabled:1"
+				/>
+				<field
+					name="scheduleEnd"
+					type="calendar"
+					label="MOD_MOKOJOOMHERO_SCHEDULE_END_LABEL"
+					description="MOD_MOKOJOOMHERO_SCHEDULE_END_DESC"
+					format="%Y-%m-%d %H:%M"
+					showtime="true"
+					showon="scheduleEnabled:1"
+				/>
+			</fieldset>
 			<fieldset name="content"
 				label="MOD_MOKOJOOMHERO_FIELDSET_CONTENT"
 			>

src/packages/mod_mokojoomhero/media/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/packages/mod_mokojoomhero/media/js/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/packages/mod_mokojoomhero/script.php

@@ -1,27 +0,0 @@
-<?php
-
-/**
- * @package     Joomla.Site
- * @subpackage  mod_mokojoomhero
- *
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GPL-3.0-or-later
- * SPDX-License-Identifier: GPL-3.0-or-later
- */
-
-defined('_JEXEC') or die;
-
-use Joomla\CMS\Filesystem\Folder;
-use Joomla\CMS\Installer\InstallerAdapter;
-
-class Mod_MokojoomheroInstallerScript
-{
-    public function postflight(string $type, InstallerAdapter $adapter): void
-    {
-        $heroesPath = JPATH_ROOT . '/images/heroes';
-
-        if (!is_dir($heroesPath)) {
-            Folder::create($heroesPath);
-        }
-    }
-}

src/packages/plg_system_mokojoomhero/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_system_mokojoomhero/language/en-GB/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_system_mokojoomhero/language/en-GB/plg_system_mokojoomhero.ini

@@ -1,2 +0,0 @@
-; Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-; SPDX-License-Identifier: GPL-3.0-or-later

src/packages/plg_system_mokojoomhero/language/en-GB/plg_system_mokojoomhero.sys.ini

@@ -1,5 +0,0 @@
-; Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-; SPDX-License-Identifier: GPL-3.0-or-later
-
-PLG_SYSTEM_MOKOJOOMHERO="System - MokoJoomHero"
-PLG_SYSTEM_MOKOJOOMHERO_DESCRIPTION="System plugin for MokoJoomHero"

src/packages/plg_system_mokojoomhero/language/en-US/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_system_mokojoomhero/language/en-US/plg_system_mokojoomhero.ini

@@ -1,2 +0,0 @@
-; Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-; SPDX-License-Identifier: GPL-3.0-or-later

src/packages/plg_system_mokojoomhero/language/en-US/plg_system_mokojoomhero.sys.ini

@@ -1,5 +0,0 @@
-; Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-; SPDX-License-Identifier: GPL-3.0-or-later
-
-PLG_SYSTEM_MOKOJOOMHERO="System - MokoJoomHero"
-PLG_SYSTEM_MOKOJOOMHERO_DESCRIPTION="System plugin for MokoJoomHero"

src/packages/plg_system_mokojoomhero/language/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_system_mokojoomhero/mokojoomhero.php

@@ -1,12 +0,0 @@
-<?php
-
-/**
- * @package     MokoJoomHero
- * @subpackage  plg_system_mokojoomhero
- * @author      Moko Consulting <hello@mokoconsulting.tech>
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
- * SPDX-License-Identifier: GPL-3.0-or-later
- */
-
-defined('_JEXEC') or die;

src/packages/plg_system_mokojoomhero/mokojoomhero.xml

@@ -1,34 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- * @package     MokoJoomHero
- * @subpackage  plg_system_mokojoomhero
- * @author      Moko Consulting <hello@mokoconsulting.tech>
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
- -->
-<extension type="plugin" group="system" method="upgrade">
-    <name>PLG_SYSTEM_MOKOJOOMHERO</name>
-    <version>01.08.00-rc</version>
-    <creationDate>2026-06-02</creationDate>
-    <author>Moko Consulting</author>
-    <authorEmail>hello@mokoconsulting.tech</authorEmail>
-    <authorUrl>https://mokoconsulting.tech</authorUrl>
-    <copyright>Copyright (C) 2026 Moko Consulting. All rights reserved.</copyright>
-    <license>GPL-3.0-or-later</license>
-    <description>PLG_SYSTEM_MOKOJOOMHERO_DESCRIPTION</description>
-
-    <namespace path="src">Joomla\Plugin\System\MokoJoomHero</namespace>
-
-    <files>
-        <filename plugin="mokojoomhero">mokojoomhero.php</filename>
-        <folder>services</folder>
-        <folder>src</folder>
-    </files>
-
-    <languages folder="language">
-        <language tag="en-GB">en-GB/plg_system_mokojoomhero.ini</language>
-        <language tag="en-GB">en-GB/plg_system_mokojoomhero.sys.ini</language>
-        <language tag="en-US">en-US/plg_system_mokojoomhero.ini</language>
-        <language tag="en-US">en-US/plg_system_mokojoomhero.sys.ini</language>
-    </languages>
-</extension>

src/packages/plg_system_mokojoomhero/services/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_system_mokojoomhero/services/provider.php

@@ -1,39 +0,0 @@
-<?php
-
-/**
- * @package     MokoJoomHero
- * @subpackage  plg_system_mokojoomhero
- * @author      Moko Consulting <hello@mokoconsulting.tech>
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
- * SPDX-License-Identifier: GPL-3.0-or-later
- */
-
-defined('_JEXEC') or die;
-
-use Joomla\CMS\Extension\PluginInterface;
-use Joomla\CMS\Factory;
-use Joomla\CMS\Plugin\PluginHelper;
-use Joomla\DI\Container;
-use Joomla\DI\ServiceProviderInterface;
-use Joomla\Event\DispatcherInterface;
-use Joomla\Plugin\System\MokoJoomHero\Extension\MokoJoomHero;
-
-return new class implements ServiceProviderInterface {
-	public function register(Container $container): void
-	{
-		$container->set(
-			PluginInterface::class,
-			function (Container $container) {
-				$plugin = new MokoJoomHero(
-					$container->get(DispatcherInterface::class),
-					(array) PluginHelper::getPlugin('system', 'mokojoomhero')
-				);
-
-				$plugin->setApplication(Factory::getApplication());
-
-				return $plugin;
-			}
-		);
-	}
-};

src/packages/plg_system_mokojoomhero/src/Extension/MokoJoomHero.php

@@ -1,25 +0,0 @@
-<?php
-
-/**
- * @package     MokoJoomHero
- * @subpackage  plg_system_mokojoomhero
- * @author      Moko Consulting <hello@mokoconsulting.tech>
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
- * SPDX-License-Identifier: GPL-3.0-or-later
- */
-
-namespace Joomla\Plugin\System\MokoJoomHero\Extension;
-
-defined('_JEXEC') or die;
-
-use Joomla\CMS\Plugin\CMSPlugin;
-use Joomla\Event\SubscriberInterface;
-
-class MokoJoomHero extends CMSPlugin implements SubscriberInterface
-{
-	public static function getSubscribedEvents(): array
-	{
-		return [];
-	}
-}

src/packages/plg_system_mokojoomhero/src/Extension/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/packages/plg_system_mokojoomhero/src/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

src/pkg_mokojoomhero.xml

@@ -1,30 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- * @package     MokoJoomHero
- * @author      Moko Consulting <hello@mokoconsulting.tech>
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
- -->
-<extension type="package" method="upgrade">
-    <name>Package - MokoJoomHero</name>
-    <packagename>mokojoomhero</packagename>
-    <version>01.08.00-rc</version>
-    <creationDate>2026-06-02</creationDate>
-    <author>Moko Consulting</author>
-    <authorEmail>hello@mokoconsulting.tech</authorEmail>
-    <authorUrl>https://mokoconsulting.tech</authorUrl>
-    <copyright>Copyright (C) 2026 Moko Consulting. All rights reserved.</copyright>
-    <license>GPL-3.0-or-later</license>
-    <description>Random hero image slideshow or background video with content overlay. Includes the hero module and system plugin. By Moko Consulting.</description>
-
-    <scriptfile>pkg_script.php</scriptfile>
-
-    <files folder="packages">
-        <file type="module" id="mod_mokojoomhero" client="site">mod_mokojoomhero.zip</file>
-        <file type="plugin" id="mokojoomhero" group="system">plg_system_mokojoomhero.zip</file>
-    </files>
-
-    <updateservers>
-        <server type="extension" name="MokoJoomHero Updates">https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/updates.xml</server>
-    </updateservers>
-</extension>

src/pkg_script.php

@@ -1,59 +0,0 @@
-<?php
-
-/**
- * @package     MokoJoomHero
- * @author      Moko Consulting <hello@mokoconsulting.tech>
- * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
- * SPDX-License-Identifier: GPL-3.0-or-later
- */
-
-defined('_JEXEC') or die;
-
-use Joomla\CMS\Factory;
-use Joomla\CMS\Installer\InstallerAdapter;
-
-class Pkg_MokoJoomHeroInstallerScript
-{
-	/**
-	 * Called after install/update — only enables the system plugin on fresh install.
-	 *
-	 * @param   string            $type    Action type
-	 * @param   InstallerAdapter  $parent  Installer adapter
-	 *
-	 * @return  void
-	 */
-	public function postflight(string $type, InstallerAdapter $parent): void
-	{
-		if ($type === 'install') {
-			try {
-				$db = Factory::getDbo();
-
-				// Enable the system plugin automatically on fresh install
-				$query = $db->getQuery(true)
-					->update($db->quoteName('#__extensions'))
-					->set($db->quoteName('enabled') . ' = 1')
-					->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
-					->where($db->quoteName('folder') . ' = ' . $db->quote('system'))
-					->where($db->quoteName('element') . ' = ' . $db->quote('mokojoomhero'));
-
-				$db->setQuery($query);
-				$db->execute();
-
-				if ($db->getAffectedRows() === 0) {
-					Factory::getApplication()->enqueueMessage(
-						'MokoJoomHero: The system plugin could not be auto-enabled. '
-						. 'Please enable it manually in Extensions &rarr; Plugins.',
-						'warning'
-					);
-				}
-			} catch (\Exception $e) {
-				Factory::getApplication()->enqueueMessage(
-					'MokoJoomHero: Failed to auto-enable system plugin: ' . $e->getMessage()
-					. ' — Please enable it manually in Extensions &rarr; Plugins.',
-					'warning'
-				);
-			}
-		}
-	}
-}

src/script.php

@@ -0,0 +1,58 @@
+<?php
+
+/**
+ * @package     Joomla.Site
+ * @subpackage  mod_mokojoomhero
+ *
+ * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
+ * @license     GPL-3.0-or-later
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Filesystem\Folder;
+use Joomla\CMS\Installer\InstallerAdapter;
+
+class Mod_MokojoomheroInstallerScript
+{
+	public function postflight(string $type, InstallerAdapter $adapter): void
+	{
+		// Create default image folder on fresh install
+		$heroesPath = JPATH_ROOT . '/images/heroes';
+
+		if (!is_dir($heroesPath)) {
+			Folder::create($heroesPath);
+		}
+
+		// Remove deprecated system plugin (was part of the old package extension)
+		$this->removeDeprecatedPlugin();
+	}
+
+	/**
+	 * Uninstall plg_system_mokojoomhero if it exists — no longer needed.
+	 */
+	private function removeDeprecatedPlugin(): void
+	{
+		try {
+			$db = Factory::getDbo();
+
+			$query = $db->getQuery(true)
+				->select($db->quoteName('extension_id'))
+				->from($db->quoteName('#__extensions'))
+				->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
+				->where($db->quoteName('folder') . ' = ' . $db->quote('system'))
+				->where($db->quoteName('element') . ' = ' . $db->quote('mokojoomhero'));
+			$db->setQuery($query);
+			$extensionId = (int) $db->loadResult();
+
+			if ($extensionId) {
+				$installer = new \Joomla\CMS\Installer\Installer();
+				$installer->uninstall('plugin', $extensionId);
+			}
+		} catch (\Exception $e) {
+			// Non-critical — plugin may already be gone
+		}
+	}
+}

src/tmpl/default.php

@@ -62,7 +62,10 @@ $overlayDirections = [
 	'gradient-right'  => 'to right',
 ];
 
-if ($overlayType !== 'solid' && isset($overlayDirections[$overlayType])) {
+// Skip overlay on solid colour/gradient modes — background is already a controlled design choice
+if ($heroMode === 'color' || $heroMode === 'gradient') {
+	$overlayBg = '';
+} elseif ($overlayType !== 'solid' && isset($overlayDirections[$overlayType])) {
 	$dir = $overlayDirections[$overlayType];
 	$overlayBg = "background: linear-gradient($dir, $rgbaTransparent, $rgbaOpaque);";
 } else {

update.xml

@@ -1,35 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-  Joomla Extension Update Server XML
-  See: https://docs.joomla.org/Deploying_an_Update_Server
-
-  This file is the update server manifest for mod_mokojoomhero.
-  The Joomla installer polls this URL to check for new versions.
-
-  The manifest in this repository must reference this file:
-    <updateservers>
-      <server type="extension" priority="1" name="MokoJoomHero Updates">
-        https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/updates.xml
-      </server>
-    </updateservers>
-
-  When a new release is made, run `make release` or the release workflow to
-  prepend a new <update> entry to this file automatically.
--->
-<updates>
-	<update>
-		<name>Module - MokoJoomHero</name>
-		<description>MokoJoomHero — A Joomla hero image module by Moko Consulting</description>
-		<element>mod_mokojoomhero</element>
-		<type>module</type>
-		<client>site</client>
-		<version>{{VERSION}}</version>
-		<downloads>
-			<downloadurl type="full" format="zip">
-				https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/v{{VERSION}}/mod_mokojoomhero.zip
-			</downloadurl>
-		</downloads>
-		<targetplatform name="joomla" version="(5|6).*" />
-		<php_minimum>8.1</php_minimum>
-	</update>
-</updates>

updates.xml

@@ -1,27 +0,0 @@
-<?xml version='1.0' encoding='UTF-8'?>
-<!-- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
- SPDX-License-Identifier: GPL-3.0-or-later
- VERSION: 01.12.00
- -->
-
-<updates>
-  <update>
-    <name>Package - MokoJoomHero</name>
-    <description>Package - MokoJoomHero stable build.</description>
-    <element>pkg_mokojoomhero</element>
-    <type>package</type>
-    <client>site</client>
-    <version>01.12.00</version>
-    <creationDate>2026-06-04</creationDate>
-    <infourl title='Package - MokoJoomHero'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/tag/stable</infourl>
-    <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/releases/download/stable/pkg_mokojoomhero-01.12.00.zip</downloadurl>
-    </downloads>
-    <sha256>675e97f0f66e206b09a256152efdccd8afca979d7d68321a9931eb3d65fb3e0d</sha256>
-    <tags><tag>stable</tag></tags>
-    <changelogurl>https://git.mokoconsulting.tech/MokoConsulting/MokoJoomHero/raw/branch/main/CHANGELOG.md</changelogurl>
-    <maintainer>Moko Consulting</maintainer>
-    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
-    <targetplatform name="joomla" version="(5|6)\..*" />
-  </update>
-</updates>