From bde8fbbbc050116a677156e65d9bfffed97fcb43 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Sat, 4 Apr 2026 12:39:38 -0500
Subject: [PATCH] Add mod_menu default override with showtitle; fix a11y/FAB
 overlap

- Create default.php for mod_menu with showtitle support, suitable
  for sidebar and footer menu modules (simple nav list, not navbar).
- Fix accessibility toolbar overlapping theme FAB by stacking the
  a11y toggle above the FAB instead of beside it.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/html/mod_menu/default.php | 95 +++++++++++++++++++++++++++++++++++
 src/media/css/template.css    |  4 +-
 2 files changed, 97 insertions(+), 2 deletions(-)
 create mode 100644 src/html/mod_menu/default.php

diff --git a/src/html/mod_menu/default.php b/src/html/mod_menu/default.php
new file mode 100644
index 0000000..aecbceb
--- /dev/null
+++ b/src/html/mod_menu/default.php
@@ -0,0 +1,95 @@
+<?php
+/**
+ * Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ *
+ * This file is part of a Moko Consulting project.
+ *
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+/**
+ * Default layout override for mod_menu.
+ * Simple list menu with showtitle support, suitable for sidebars and footers.
+ */
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Helper\ModuleHelper;
+
+$id = '';
+
+if ($tagId = $params->get('tag_id', '')) {
+    $id = ' id="' . $tagId . '"';
+}
+
+$suffix      = htmlspecialchars($params->get('moduleclass_sfx', ''), ENT_COMPAT, 'UTF-8');
+$headerTag   = htmlspecialchars($params->get('header_tag', 'h3'), ENT_COMPAT, 'UTF-8');
+$headerClass = htmlspecialchars($params->get('header_class', ''), ENT_COMPAT, 'UTF-8');
+?>
+<nav class="mod-menu<?php echo $suffix ? ' ' . $suffix : ''; ?>"<?php echo $id; ?> aria-label="<?php echo htmlspecialchars($module->title, ENT_COMPAT, 'UTF-8'); ?>">
+    <?php if ($module->showtitle) : ?>
+        <<?php echo $headerTag; ?> class="mod-menu__title<?php echo $headerClass ? ' ' . $headerClass : ''; ?>"><?php echo $module->title; ?></<?php echo $headerTag; ?>>
+    <?php endif; ?>
+    <ul class="mod-menu__list nav flex-column">
+<?php foreach ($list as $i => &$item) :
+    $itemParams = $item->getParams();
+    $class = 'nav-item mod-menu__item item-' . $item->id;
+
+    if ($item->id == $default_id) {
+        $class .= ' default';
+    }
+
+    if ($item->id == $active_id || ($item->type === 'alias' && $itemParams->get('aliasoptions') == $active_id)) {
+        $class .= ' current';
+    }
+
+    if (in_array($item->id, $path)) {
+        $class .= ' active';
+    } elseif ($item->type === 'alias') {
+        $aliasToId = $itemParams->get('aliasoptions');
+
+        if (count($path) > 0 && $aliasToId == $path[count($path) - 1]) {
+            $class .= ' active';
+        } elseif (in_array($aliasToId, $path)) {
+            $class .= ' alias-parent-active';
+        }
+    }
+
+    if ($item->type === 'separator') {
+        $class .= ' divider';
+    }
+
+    if ($item->deeper) {
+        $class .= ' deeper';
+    }
+
+    if ($item->parent) {
+        $class .= ' parent';
+    }
+
+    echo '<li class="' . $class . '">';
+
+    switch ($item->type) :
+        case 'separator':
+        case 'component':
+        case 'heading':
+        case 'url':
+            require ModuleHelper::getLayoutPath('mod_menu', 'default_' . $item->type);
+            break;
+
+        default:
+            require ModuleHelper::getLayoutPath('mod_menu', 'default_url');
+            break;
+    endswitch;
+
+    if ($item->deeper) {
+        echo '<ul class="mod-menu__sub nav flex-column ms-3">';
+    } elseif ($item->shallower) {
+        echo '</li>';
+        echo str_repeat('</ul></li>', $item->level_diff);
+    } else {
+        echo '</li>';
+    }
+endforeach;
+?></ul>
+</nav>
diff --git a/src/media/css/template.css b/src/media/css/template.css
index 38b1474..0483f10 100644
--- a/src/media/css/template.css
+++ b/src/media/css/template.css
@@ -17274,9 +17274,9 @@ html.a11y-pause-animations *::after {
   right: 2.5rem;
 }
 
-/* When theme FAB is present, shift a11y toolbar to sit to its right */
+/* When theme FAB is present, stack a11y toolbar above it */
 body[data-theme-fab-enabled="1"] #mokoA11yToolbar {
-  right: calc(2.5rem + 200px);
+  bottom: 3.5rem;
 }
 
 /* Toggle button */