mod_wmamenumax
Joomla 6 module for multi-column megamenu.
What it does
- Reads items from a Joomla Menu Manager menu.
- Displays top-level items in the main bar.
- Distributes child items into configurable columns.
- Displays an image panel on the right with dynamic preview.
- Generates physical square thumbnails on disk.
- Supports mobile/accordion, JSON-LD, cache clearing, and regeneration.
How it works
- The module reads the menutype chosen in the configuration.
- It retrieves first-level items and second-level items. (Third-level items are not included)
- First-level items become the main menu bar.
- Children are distributed into columns.
- Each child can have a thumbnail and a hover image displayed on the right side of the panel.
- The menu panel displays the default image entered in the panel tab.
Data structure
- Items come from the Joomla Menu Manager.
- The module respects access levels, language, and published status.
- The current/active field follows the core Joomla menu logic.
Configuration
Menu Tab
- Menu: source menu.
- Initial level: starting level.
- Final level: ending level, 0 = no limit.
Columns Tab
- Number of columns: maximum number of columns the submenu should have.
- Item distribution: auto or manual.
- In manual mode, the fields col1_count ... col5_count define the distribution.
- Column titles: column titles with visibility options, starting column, and span. 2 or more columns can share the same title.
Desktop Colors Tab
Desktop menu colors: column titles, border, background, top level, hover, current, and submenu.
Mobile Colors Tab
Mobile menu colors with values separate from desktop.
Panel Tab
- Panel image height (%): height of the right image in %.
- Fallback image: default image in the submenu panel.
SEO Tab
- Column title tags: HTML tags for column titles.
- JSON-LD SiteNavigationElement: enables/disables the JSON-LD SiteNavigationElement.
Maintenance Tab
Buttons to:
- clear the thumbnail cache;
- regenerate all thumbnails.
The action goes through com ajax with a GET CSRF token.
Information Tab
Displays module data, author, email, website, license, and copyright.
Operational notes
- Thumbnails are saved in images/miniature.
- Remote HTTP/HTTPS images are left pass-through.
- The panel and columns have a breakpoint at 992px.
- JSON-LD is printed only if enabled and if the menu is not empty.
Updates
The module uses a remote update server via mod_wmamenumax_update.xml in the repository root.
Online Demo
You can see the module in action on the WMA website:
Requirements
- Joomla 6
- PHP compatible with Joomla 6
- GD or Imagick libraries for thumbnail generation