diff --git a/CHANGELOG.md b/CHANGELOG.md index 6abbfd7..8d10dda 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -19,6 +19,52 @@ All notable changes to the MokoCassiopeia Joomla template are documented in this The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [03.08.02] - 2026-02-27 + +### Removed - Fix Language Loading in All Module Overrides + +**Critical fix**: Removed standard Joomla module overrides to fix language string loading issues. Following Cassiopeia template approach. + +#### Problem +- Default language strings not loading in module overrides (mod_breadcrumbs, mod_login, mod_articles_latest) +- Language constants displayed instead of translated text (e.g., "MOD_LOGIN_VALUE_USERNAME" instead of "Username") +- Custom overrides interfered with Joomla's module initialization and language loading process + +#### Solution - Cassiopeia Approach +- **Removed** standard Joomla module overrides: + - `src/templates/html/mod_breadcrumbs/` (2 files) + - `src/templates/html/mod_login/` (2 files) + - `src/templates/html/mod_articles_latest/` (2 files) +- Template now uses Joomla's core module layouts for standard modules +- Language files load automatically via Joomla's module system +- Custom styling can still be applied via CSS using module-specific classes +- **Retained** third-party extension overrides where they add mobile-responsive value: + - VirtueMart modules (5): mod_virtuemart_cart, _category, _currencies, _manufacturer, _product + - Community Builder modules (2): mod_cblogin, mod_comprofilerOnline + - Other extensions (9): mod_acymailing, mod_hikashop_cart, mod_k2_content, mod_kunena*, mod_osmembership, mod_search + +#### Cassiopeia Template Philosophy +- Cassiopeia (Joomla's default template) does NOT override standard module layouts +- It relies on core Joomla module files and applies styling via CSS +- Overrides are only created when structural changes are absolutely necessary +- This ensures compatibility, automatic language loading, and easier maintenance + +#### Module Count Update +- **Before**: 19 module overrides +- **After**: 16 module overrides +- **Removed**: 3 standard Joomla modules (breadcrumbs, login, articles_latest) +- **Component overrides**: Still 7 (unchanged) + +#### Files Removed +- `src/templates/html/mod_breadcrumbs/default.php` +- `src/templates/html/mod_breadcrumbs/index.html` +- `src/templates/html/mod_login/default.php` +- `src/templates/html/mod_login/index.html` +- `src/templates/html/mod_articles_latest/default.php` +- `src/templates/html/mod_articles_latest/index.html` + +**Note**: This follows Joomla best practices by using core layouts for standard modules. Styling is handled via CSS. Third-party extension overrides remain for mobile responsiveness. + ## [03.08.01] - 2026-02-27 ### Removed - Fix Breaking Overrides diff --git a/docs/MODULE_OVERRIDES.md b/docs/MODULE_OVERRIDES.md index 0750889..490dc6d 100644 --- a/docs/MODULE_OVERRIDES.md +++ b/docs/MODULE_OVERRIDES.md @@ -24,7 +24,7 @@ INGROUP: MokoCassiopeia.Documentation REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia FILE: docs/MODULE_OVERRIDES.md - VERSION: 03.08.01 + VERSION: 03.08.02 BRIEF: Comprehensive guide to MokoCassiopeia mobile-responsive module overrides PATH: /docs/MODULE_OVERRIDES.md --> @@ -35,7 +35,9 @@ This document provides a comprehensive guide to all mobile-responsive module and ## Overview -MokoCassiopeia includes **19 mobile-responsive module overrides** and **7 component view overrides** designed to enhance the mobile user experience across standard Joomla, VirtueMart, Community Builder, and popular third-party extensions. +MokoCassiopeia includes **16 mobile-responsive module overrides** and **7 component view overrides** designed to enhance the mobile user experience for third-party extensions (VirtueMart, Community Builder, Kunena, etc.). + +**Important**: Following Cassiopeia template best practices, MokoCassiopeia does NOT override standard Joomla core modules (mod_breadcrumbs, mod_login, mod_articles_latest, etc.). These use Joomla's default layouts to ensure proper language loading and compatibility. ### Key Features diff --git a/src/templates/html/STANDARD_MODULES_README.md b/src/templates/html/STANDARD_MODULES_README.md index f0571c1..72be44b 100644 --- a/src/templates/html/STANDARD_MODULES_README.md +++ b/src/templates/html/STANDARD_MODULES_README.md @@ -1,42 +1,13 @@ # Standard Joomla & Community Builder Module Mobile Responsive Overrides ## Overview -This directory contains mobile-responsive overrides for standard Joomla and Community Builder modules, designed specifically for the MokoCassiopeia template. +This directory contains mobile-responsive overrides for Community Builder modules, designed specifically for the MokoCassiopeia template. -**Note**: The mod_menu override has been removed to prevent conflicts with Joomla's core menu system. Use Joomla's default menu rendering or apply custom CSS to the `.mod-menu` class for styling. - -## Standard Joomla Modules - -### 1. mod_breadcrumbs -Breadcrumb navigation module featuring: -- Schema.org structured data -- Responsive breadcrumb trail -- Home icon support -- Active page highlighting -- Touch-friendly links - -### 2. mod_login -User login form module with: -- Login and logout states -- Two-factor authentication support -- Remember me functionality -- Password recovery links -- User registration links -- Touch-friendly form inputs (48px on mobile) -- 16px input font (prevents iOS zoom) - -### 3. mod_articles_latest -Latest articles display module offering: -- Responsive article cards -- Optional metadata display (author, date, category, hits) -- Schema.org Article markup -- Introtext support -- Read more links -- Touch-friendly interactions +**Important**: Following Cassiopeia template best practices, standard Joomla core modules (mod_breadcrumbs, mod_login, mod_articles_latest, mod_menu) are NOT overridden. These use Joomla's default layouts to ensure proper language loading and compatibility. Apply custom styling via CSS. ## Community Builder Modules -### 4. mod_cblogin +### 1. mod_cblogin Community Builder login module with: - Avatar display in logged-in state - Profile link button @@ -46,7 +17,7 @@ Community Builder login module with: - Registration link - Pre/post text support -### 5. mod_comprofilerOnline +### 2. mod_comprofilerOnline Community Builder online users module featuring: - Online user count display - Members vs. guests breakdown diff --git a/src/templates/html/mod_articles_latest/default.php b/src/templates/html/mod_articles_latest/default.php deleted file mode 100644 index 6f1540b..0000000 --- a/src/templates/html/mod_articles_latest/default.php +++ /dev/null @@ -1,105 +0,0 @@ - - * @license GNU General Public License version 2 or later; see LICENSE.txt - * - * Mobile responsive override for mod_articles_latest module - */ - -defined('_JEXEC') or die; - -use Joomla\CMS\Factory; -use Joomla\CMS\HTML\HTMLHelper; -use Joomla\CMS\Language\Text; - -// Ensure module language file is loaded -$lang = Factory::getLanguage(); -$lang->load('mod_articles_latest', JPATH_SITE); - -$moduleclass_sfx = htmlspecialchars($params->get('moduleclass_sfx', ''), ENT_COMPAT, 'UTF-8'); - -// Add responsive wrapper class -$wrapperClass = 'mod-articles-latest mod-articles-latest-responsive ' . $moduleclass_sfx; -?> - -