Files
MokoCassiopeia/docs/ROADMAP.md
2026-01-27 15:24:04 +00:00

750 lines
22 KiB
Markdown

<!--
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
# FILE INFORMATION
DEFGROUP: Joomla.Template.Site
INGROUP: Moko-Cassiopeia.Documentation
REPO: https://github.com/mokoconsulting-tech/moko-cassiopeia
FILE: docs/ROADMAP.md
VERSION: 03.05.00
BRIEF: Version-specific roadmap for Moko-Cassiopeia template
PATH: /docs/ROADMAP.md
-->
# Moko-Cassiopeia Roadmap (VERSION: 03.05.00)
This document provides a comprehensive, version-specific roadmap for the Moko-Cassiopeia Joomla template, tracking feature evolution, current capabilities, and planned enhancements.
## Table of Contents
- [Version Timeline](#version-timeline)
- [Past Releases](#past-releases)
- [Future Roadmap (5-Year Plan)](#future-roadmap-5-year-plan)
- [Current Release (v03.05.00)](#current-release-v030500)
- [Implemented Features](#implemented-features)
- [Planned Features](#planned-features)
- [Development Priorities](#development-priorities)
- [Long-term Vision](#long-term-vision)
- [External Resources](#external-resources)
---
## Version Timeline
### Past Releases
### v03.05.01 (2026-01-09) - Standards & Security
**Status**: Released (CHANGELOG entry exists, code files pending version update)
**Added**:
- Dependency review workflow for vulnerability scanning
- Standards compliance workflow for MokoStandards validation
- Dependabot configuration for automated security updates
- Documentation index (`docs/README.md`)
**Changed**:
- Removed custom CodeQL workflow (using GitHub's default setup)
- Enforced repository compliance with MokoStandards
- Improved security posture with automated scanning
### v03.05.00 (2026-01-04) - Workflow & Governance
**Status**: Current Release (in code)
**Added**:
- `.github/workflows` directory structure
- CODE_OF_CONDUCT.md from MokoStandards
- CONTRIBUTING.md from MokoStandards
**Changed**:
- TODO items to be split to separate file (tracked)
### v03.01.00 (2025-12-16) - CI/CD Foundation
**Added**:
- Initial GitHub Actions workflows
### v03.00.00 (2025-12-09) - Font Awesome 7 Upgrade
**Updated**:
- Copyright headers to MokoCodingDefaults standards
- Fixed color style injection in `index.php`
- Upgraded Font Awesome 6 to Font Awesome 7 Free
- Added Font Awesome 7 Free style fallback
**Removed**:
- Deprecated CODE_OF_CONDUCT.md
- Deprecated CONTRIBUTING.md
### v02.01.05 (2025-09-04) - CSS Refinement
**Fixed**:
- Removed vmbasic.css
- Repaired template.css and colors_standard.css
### v02.00.00 (2025-08-30) - Dark Mode & TOC
**Major Features**:
- **Dark Mode Toggle System**
- Frontend toggle switch with localStorage persistence
- Admin-configurable default mode
- CSS rules for light/dark themes
- JavaScript-powered mode switching
- **Enhanced Template Parameters**
- Logo parameter support
- GTM container ID configuration
- Dark mode defaults in settings
- Updated metadata and copyright headers
- **Expanded Table of Contents**
- Automatic TOC injection
- User-selectable placement (`toc-left` or `toc-right`)
- Article options integration
**Improvements**:
- Cleaned up `index.php` (removed duplicate skip-to-content calls)
- Consolidated JavaScript asset loading
- Streamlined CSS for toggle switch
- Accessibility refinements (typography, color contrast)
- Fixed missing logo parameter in header
- Corrected stylesheet inconsistencies
- Patched redundant script includes
### v01.00.00 - Initial Public Release
**Core Features**:
- Font Awesome 6 integration
- Bootstrap 5 helpers and utilities
- Automatic Table of Contents (TOC) utility
- Moko Expansions: Google Tag Manager / GA4 hooks
- Built on Joomla's Cassiopeia template
---
### Future Roadmap (5-Year Plan)
The following versions represent our planned annual major releases, each building upon the previous version's foundation.
#### v04.00.00 (Q4 2027) - Enhanced Accessibility & Performance
**Status**: Planned
**Target Release**: December 2027
**Major Features**:
- **WCAG 2.1 AA Compliance**
- Full accessibility audit and remediation
- High-contrast theme options
- Screen reader optimizations
- Keyboard navigation enhancements
- ARIA landmark improvements
- **Performance Optimizations**
- Critical CSS inlining
- Lazy loading for images and below-fold content
- WebP image support with automatic fallbacks
- Advanced asset bundling and minification
- Service worker for offline functionality
- **Developer Experience**
- Development mode enablement (unminified assets, debug output)
- Live reload during development
- Enhanced error logging and diagnostics
- Template debugging tools
- **Content Features**
- Soft offline mode (category-based access during maintenance)
- Enhanced article layouts (grid, masonry options)
- Advanced typography controls
**Infrastructure**:
- Codeception test coverage expanded to 80%+
- Automated performance testing in CI/CD
- Enhanced security scanning with additional tools
---
#### v05.00.00 (Q4 2028) - Visual Builder & Advanced SEO
**Status**: Planned
**Target Release**: December 2028
**Major Features**:
- **Visual Page Builder Integration**
- Drag-and-drop layout editor
- Real-time preview
- Preset layout templates library
- Custom component builder
- Style preset management
- **Advanced SEO Module**
- Schema markup generator (JSON-LD)
- Open Graph and Twitter Card management
- Automatic sitemap generation
- Meta tag optimization tools
- Rich snippets support
- **E-commerce Enhancements**
- Expanded VirtueMart integration
- WooCommerce bridge support
- Shopping cart widget improvements
- Product showcase layouts
- **Social Integration**
- Social media feed aggregation
- Share buttons with analytics
- Social login integration
- Comment system enhancements
**Infrastructure**:
- Joomla 6.x compatibility (if released)
- PHP 8.2+ requirement
- Multi-site template synchronization
- Cloud storage integration for media
---
#### v06.00.00 (Q4 2029) - Enterprise Features & Headless CMS
**Status**: Planned
**Target Release**: December 2029
**Major Features**:
- **Headless CMS Mode**
- API-first rendering capability
- RESTful API endpoints for template data
- JSON:API compliance
- GraphQL support
- Decoupled frontend options
- **Enterprise Support Tier**
- Advanced caching strategies
- CDN integration (Cloudflare, AWS CloudFront)
- Multi-language management system
- Advanced user role customization
- White-label branding options
- **AI-Powered Features**
- AI accessibility checker
- Automated content suggestions
- Smart image optimization
- Intelligent layout recommendations
- **Advanced Customization**
- Theme marketplace ecosystem
- Community-contributed extensions
- Style inheritance system
- CSS variable management UI
**Infrastructure**:
- Containerized deployment options (Docker)
- Kubernetes support for scaling
- Advanced monitoring and analytics
- Enterprise security features (SSO, 2FA)
---
#### v07.00.00 (Q4 2030) - AI Integration & Advanced Personalization
**Status**: Planned
**Target Release**: December 2030
**Major Features**:
- **AI-Powered Personalization**
- Content recommendation engine
- Adaptive layouts based on user behavior
- A/B testing framework
- Predictive analytics dashboard
- Smart content organization
- **Advanced Newsletter Integration**
- Mailchimp, Sendinblue, SendGrid support
- Automated email campaigns
- Subscriber segmentation
- Template-based email design
- Analytics and reporting
- **Progressive Web App (PWA)**
- Full offline functionality
- Install to home screen
- Push notifications
- Background sync
- App shell architecture
- **Advanced Media Management**
- Video hosting integration (YouTube, Vimeo, self-hosted)
- Image gallery enhancements
- 3D model support
- Audio player integration
- Media CDN optimization
**Infrastructure**:
- Edge computing support
- Serverless deployment options
- Advanced caching with Redis/Memcached
- Real-time collaboration features
---
#### v08.00.00 (Q4 2031) - Next-Generation Platform
**Status**: Conceptual
**Target Release**: December 2031
**Major Features**:
- **Next-Gen Web Standards**
- HTTP/3 optimization
- WebAssembly components
- Web Components integration
- Modern CSS features (Container Queries, Cascade Layers)
- Advanced animations and transitions
- **Immersive Technologies**
- WebXR support for AR/VR content
- 3D visualization tools
- Interactive media experiences
- Spatial navigation
- **Blockchain Integration** (if relevant)
- Decentralized content verification
- NFT showcase capabilities
- Web3 wallet integration
- Smart contract interactions
- **Advanced Analytics & Business Intelligence**
- Real-time visitor analytics
- Conversion tracking and optimization
- Heatmap and session recording
- Custom reporting dashboards
- Data warehouse integration
- **Ecosystem & Marketplace**
- Extensive plugin marketplace
- Template derivatives and child themes
- Professional support network
- Training and certification programs
- Community-driven roadmap
**Infrastructure**:
- Quantum-ready cryptography
- Carbon-neutral hosting optimization
- Advanced security with zero-trust architecture
- Multi-cloud deployment strategies
---
## Current Release (v03.05.00)
### System Requirements
- **Joomla**: 4.4.x or 5.x
- **PHP**: 8.0+
- **Database**: MySQL/MariaDB compatible
### Architecture
- **Base Template**: Joomla Cassiopeia
- **Enhancement Layer**: Non-invasive overrides
- **Asset Management**: Joomla Web Asset Manager (WAM)
- **Frontend Framework**: Bootstrap 5
- **Icon Library**: Font Awesome 7 Free
---
## Implemented Features
### 🎨 Theming & Visual Design
#### Color Palette System
- **3 Built-in Palettes**: Standard, Alternative, Custom
- **Dual Mode Support**: Separate light and dark configurations
- **Custom Palettes**: User-definable via `colors_custom.css`
- **Location**: `src/media/css/colors/{light|dark}/`
#### Dark Mode System
- **Toggle Controls**: Switch (Light↔Dark) or Radios (Light/Dark/System)
- **Default Mode**: Admin-configurable (system, light, or dark)
- **Persistence**: localStorage for user preferences
- **Auto-Detection**: Optional system preference detection
- **Meta Tags**: `color-scheme` and `theme-color` support
- **ARIA Bridge**: Bootstrap ARIA compatibility
#### Typography
- **Font Schemes**:
- Local: Roboto
- Web (Google Fonts): Fira Sans, Roboto + Noto Sans
- **Admin-Configurable**: Template settings dropdown
#### Branding
- **Logo Support**: Custom logo upload
- **Site Title**: Text-based branding option
- **Site Description**: Tagline/subtitle field
- **Font Awesome Kit**: Optional custom kit integration
### 📐 Layout & Structure
#### Module Positions (23 Total)
**Header Area**:
- topbar, below-topbar, below-logo, menu, search, banner
**Content Area**:
- top-a, top-b, main-top, main-bottom, breadcrumbs
- sidebar-left, sidebar-right
**Footer Area**:
- bottom-a, bottom-b, footer-menu, footer
**Special**:
- debug, offline-header, offline, offline-footer
- drawer-left, drawer-right
#### Layout Options
- **Container Type**: Fluid or Static
- **Sticky Header**: Optional fixed navigation
- **Back-to-Top Button**: Scrollable page support
### 📝 Content Features
#### Table of Contents (TOC)
- **Automatic Generation**: From article headings
- **Placement Options**: `toc-left` or `toc-right` layouts
- **Article Integration**: Via Options → Layout dropdown
- **Responsive**: Mobile-friendly sidebar placement
#### Article Layouts
- **Default**: Standard Cassiopeia layout
- **TOC Variants**: Left-sidebar or right-sidebar TOC
- **Custom Overrides**: Located in `html/com_content/article/`
### 📊 Analytics & Tracking
#### Google Tag Manager (GTM)
- **Enable/Disable**: Admin toggle
- **Container ID**: Template parameter field
- **Implementation**: Head and body script injection
- **GDPR-Ready**: Configurable consent defaults
#### Google Analytics 4 (GA4)
- **Enable/Disable**: Admin toggle
- **Property ID**: Template parameter field
- **Universal Analytics Fallback**: Legacy UA support
- **Privacy-First**: Conditional loading based on settings
### 🎛️ Customization & Developer Tools
#### Custom Code Injection
- **Head Start**: Custom HTML/JS before `</head>`
- **Head End**: Custom HTML/JS at end of `<head>`
- **Raw HTML**: Unfiltered code injection for advanced users
#### Drawer System
- **Left/Right Drawers**: Offcanvas menu areas
- **Icon Customization**: Font Awesome icon selection
- **Default Icons**:
- Left: `fa-solid fa-chevron-right`
- Right: `fa-solid fa-chevron-left`
#### Asset Management
- **Joomla WAM**: Complete asset registry in `joomla.asset.json`
- **Development/Production Modes**: Minified and unminified assets
- **Dependency Management**: Automatic script/style loading
### 🏗️ Template Overrides
#### Component Overrides
**Content (com_content)**:
- Article layouts (default, toc-left, toc-right)
- Category layouts (blog, list)
- Featured articles
**Contact (com_contact)**:
- Contact form layouts
**Engage (com_engage)**:
- Comment system integration
#### Module Overrides
**Menu (mod_menu)**:
- Metis dropdown menu
- Offcanvas navigation
**VirtueMart**:
- Product display (`mod_virtuemart_product`)
- Shopping cart (`mod_virtuemart_cart`)
- Manufacturer display (`mod_virtuemart_manufacturer`)
- Category display (`mod_virtuemart_category`)
- Currency selector (`mod_virtuemart_currencies`)
**Other Modules**:
- Custom HTML (`mod_custom`)
- GABble social integration (`mod_gabble`)
**Membership System (OS Membership)**:
- Plan layouts (default, pricing tables)
- Member management interfaces
### 🔧 Configuration Parameters
#### Theme Tab
**General**:
- `theme_enabled` - Enable/disable theme system
- `theme_control_type` - Toggle UI type (switch/radios/none)
- `theme_default_choice` - Default mode (system/light/dark)
- `theme_auto_dark` - Auto-detect system preference
- `theme_meta_color_scheme` - Inject `color-scheme` meta tag
- `theme_meta_theme_color` - Inject `theme-color` meta tag
- `theme_bridge_bs_aria` - Bootstrap ARIA compatibility
**Variables & Palettes**:
- `colorLightName` - Light mode color scheme
- `colorDarkName` - Dark mode color scheme
**Typography**:
- `useFontScheme` - Font selection (local/web)
**Branding & Icons**:
- `brand` - Show/hide branding
- `logoFile` - Logo upload path
- `siteTitle` - Site title text
- `siteDescription` - Site tagline
- `fA6KitCode` - Font Awesome kit code
**Header & Navigation**:
- `stickyHeader` - Fixed navigation
- `backTop` - Back-to-top button
**Toggle UI**:
- `theme_fab_enabled` - Floating action button for theme toggle
- `theme_fab_pos` - FAB position (br/bl/tr/tl)
#### Google Tab
- `googletagmanager` - Enable GTM
- `googletagmanagerid` - GTM container ID
- `googleanalytics` - Enable GA4
- `googleanalyticsid` - GA4 property ID
#### Custom Code Tab
- `custom_head_start` - Custom code at head start
- `custom_head_end` - Custom code at head end
#### Drawers Tab
- `drawerLeftIcon` - Left drawer icon (Font Awesome class)
- `drawerRightIcon` - Right drawer icon (Font Awesome class)
#### Advanced Tab
- `fluidContainer` - Container layout (static/fluid)
### 🛠️ Development Tools
#### Quality Assurance
- **Codeception**: Automated testing framework
- **PHPStan**: Static analysis (level 8+)
- **PHPCS**: Code style validation (PSR-12)
- **PHPCompatibility**: PHP 8.0+ compatibility checks
#### CI/CD Workflows
- **Dependency Review**: Vulnerability scanning
- **Standards Compliance**: MokoStandards validation
- **CodeQL**: Security analysis (GitHub default)
- **Dependabot**: Automated dependency updates
#### Documentation
- **Quick Start**: 5-minute developer setup
- **Workflow Guide**: Git strategy, branching, releases
- **Joomla Development**: Testing, packaging, multi-version support
---
## Planned Features
### 🚧 In Development
#### Soft Offline Mode (v2.1.5 - Mentioned)
**Status**: Planned/In Development
**Description**: Keep selected categories accessible during maintenance mode
**Use Cases**:
- Legal documents remain viewable during downtime
- Policy pages accessible for compliance
- Terms of service always available
**Configuration**:
- Admin-selectable categories
- Per-category offline access control
#### TODO Tracking System
**Status**: Mentioned in CHANGELOG (v03.05.00)
**Description**: Separate TODO tracking file
**Purpose**: Centralized issue and feature tracking outside changelog
### 🔮 Future Enhancements
#### Development Mode (Commented Out)
**Status**: Code exists but disabled
**Location**: `templateDetails.xml` line 91
**Description**: Comprehensive development mode toggle
**Potential Features**:
- Unminified asset loading
- Debug output
- Performance profiling
- Template cache bypass
#### Potential Features (Community Requested)
*Note: These are conceptual and not yet officially planned*
**Enhanced Accessibility**:
- WCAG 2.1 AAA compliance mode
- High-contrast themes
- Screen reader optimizations
- Keyboard navigation improvements
**Performance Optimizations**:
- Critical CSS inlining
- Lazy loading for below-the-fold content
- WebP image support with fallbacks
- Service worker for offline functionality
**Additional Integrations**:
- More e-commerce platform support
- Newsletter integration (Mailchimp, Sendinblue)
- Social media feed aggregation
- Advanced SEO tools
**Content Builder**:
- Visual page builder integration
- Drag-and-drop layout editor
- Preset layout templates
- Style presets library
---
## Development Priorities
### Immediate Focus (v03.x - 2026)
1. **TODO Tracking System**: Implement separate file for issue tracking
2. **Soft Offline Mode**: Complete category-based offline access
3. **Security Updates**: Maintain Dependabot and CodeQL scans
4. **Documentation**: Keep docs synchronized with features
5. **Bug Fixes**: Address reported issues and edge cases
### v04.00.00 Priorities (2027)
1. **WCAG 2.1 AA Compliance**: Full accessibility audit and implementation
2. **Performance Optimizations**: Critical CSS, lazy loading, WebP support
3. **Development Mode**: Enable comprehensive developer tools
4. **Testing**: Achieve 80%+ Codeception coverage
### v05.00.00 Priorities (2028)
1. **Visual Page Builder**: Drag-and-drop layout editor
2. **Advanced SEO**: Schema markup, meta optimization
3. **E-commerce Enhancements**: Expanded platform support
4. **Social Integration**: Feed aggregation and sharing
### v06.00.00 Priorities (2029)
1. **Headless CMS Mode**: API-first architecture
2. **Enterprise Features**: Advanced caching, CDN integration
3. **AI-Powered Tools**: Accessibility checker, content optimization
4. **Marketplace Ecosystem**: Theme and extension marketplace
### v07.00.00+ Priorities (2030+)
1. **AI Personalization**: Adaptive layouts and content recommendations
2. **Progressive Web App**: Full offline functionality
3. **Advanced Analytics**: Real-time insights and BI integration
4. **Immersive Technologies**: AR/VR support, 3D visualization
---
## Long-term Vision
### Mission Statement
Moko-Cassiopeia aims to be the **most developer-friendly, user-customizable, and standards-compliant Joomla template** while maintaining minimal core overrides for maximum upgrade compatibility.
### Core Principles
1. **Non-Invasive**: Minimal Cassiopeia overrides
2. **Standards-First**: MokoStandards compliance
3. **Accessibility**: WCAG 2.1 compliance
4. **Performance**: Fast, optimized delivery
5. **Security**: Proactive vulnerability management
6. **Developer Experience**: Clear docs, easy setup, powerful tools
### 5-Year Strategic Roadmap
#### 2027 (v04.00.00) - Accessibility & Performance
- Achieve WCAG 2.1 AA compliance
- Implement critical performance optimizations
- Enable development mode for developers
- Expand automated testing coverage
#### 2028 (v05.00.00) - Visual Builder & SEO
- Launch integrated visual page builder
- Deploy advanced SEO tools and schema markup
- Enhance e-commerce capabilities
- Integrate social media features
#### 2029 (v06.00.00) - Enterprise & Headless
- Introduce headless CMS capabilities
- Launch enterprise support tier
- Deploy AI-powered features
- Build marketplace ecosystem
#### 2030 (v07.00.00) - AI & Personalization
- AI-driven content personalization
- Progressive Web App functionality
- Advanced newsletter integration
- Real-time analytics and optimization
#### 2031 (v08.00.00) - Next-Generation Platform
- Next-gen web standards (HTTP/3, WebAssembly)
- Immersive technologies (WebXR)
- Advanced business intelligence
- Extensive ecosystem and marketplace
---
## External Resources
### Official Links
- **Full Roadmap**: [https://mokoconsulting.tech/support/joomla-cms/moko-cassiopeia-roadmap](https://mokoconsulting.tech/support/joomla-cms/moko-cassiopeia-roadmap)
- **Repository**: [https://github.com/mokoconsulting-tech/moko-cassiopeia](https://github.com/mokoconsulting-tech/moko-cassiopeia)
- **Issue Tracker**: [GitHub Issues](https://github.com/mokoconsulting-tech/moko-cassiopeia/issues)
- **Changelog**: [CHANGELOG.md](../CHANGELOG.md)
### Community
- **Email Support**: hello@mokoconsulting.tech
- **Contributing**: [CONTRIBUTING.md](../CONTRIBUTING.md)
- **Code of Conduct**: [CODE_OF_CONDUCT.md](../CODE_OF_CONDUCT.md)
### Documentation
- **Quick Start**: [docs/QUICK_START.md](./QUICK_START.md)
- **Workflow Guide**: [docs/WORKFLOW_GUIDE.md](./WORKFLOW_GUIDE.md)
- **Joomla Development**: [docs/JOOMLA_DEVELOPMENT.md](./JOOMLA_DEVELOPMENT.md)
- **Main README**: [README.md](../README.md)
---
## Contributing to the Roadmap
Have ideas for future features? We welcome community input!
**How to Suggest Features**:
1. Check the [GitHub Issues](https://github.com/mokoconsulting-tech/moko-cassiopeia/issues) for existing requests
2. Open a new issue with the `enhancement` label
3. Provide clear use cases and benefits
4. Engage in community discussion
**Feature Evaluation Criteria**:
- Alignment with core principles
- User demand and use cases
- Technical feasibility
- Maintenance burden
- Performance impact
- Security implications
---
## Metadata
* Document: docs/ROADMAP.md
* Repository: [https://github.com/mokoconsulting-tech/moko-cassiopeia](https://github.com/mokoconsulting-tech/moko-cassiopeia)
* Path: /docs/ROADMAP.md
* Owner: Moko Consulting
* Version: 03.05.00
* Status: Active
* Last Updated: 2026-01-27
* Classification: Public Open Source Documentation
## Revision History
| Date | Change Summary | Author |
| ---------- | ----------------------------------------------------- | --------------- |
| 2026-01-27 | Initial version-specific roadmap generated from codebase scan. | GitHub Copilot |
| 2026-01-27 | Added 5-year future roadmap with annual major version releases (v04-v08). | GitHub Copilot |