MokoConsulting/MokoOnyx
1
0
Fork 0
Code Issues 10 Pull Requests Releases 5 Wiki Activity
Files
f47731a03dbfc0fddab8478d64f8a80d7b91068e
MokoOnyx/docs/ROADMAP.md
T
Jonathan Miller bb8f0e8c5e
Create Release / Build Release Package (push) Successful in 9s
Details
feat!: v02.00.00 Clean Slate — remove all MokoCassiopeia migration code 
BREAKING CHANGE: Sites still on MokoCassiopeia must install MokoOnyx
v01.x first to migrate settings before upgrading to v02.

Removed:
- helper/migrate.php — full migration engine (style cloning, file copy,
  update server rewrite)
- script.php migration methods: migrateFromCassiopeia(),
  copyUserFiles(), replaceCassiopeiaReferences() + OLD_NAME constants
- index.php first-load migration check (file_exists .migrated)
- Migration fieldset and language strings from admin UI
- "formerly MokoCassiopeia" from description
- MokoCassiopeia reference in bootstrap-toc.css comment

Updated:
- Roadmap rewritten for 01.xx→02.xx version line with clean future plan
- script.php MIN_JOOMLA bumped to 5.0.0 (Joomla 4.4 dropped)
- script.php postflight() simplified (favicon + lock only)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-27 05:08:26 -05:00

5.3 KiB
Raw Blame History

MokoOnyx Roadmap

Current State

  • Latest Stable: 01.00.30
  • Platform: Joomla 5.x / 6.x, PHP 8.1+
  • Base: Cassiopeia enhancement layer
  • Release System: Gitea Actions with stream tags (stable/rc/beta/alpha/development)

v02.00.00 — Clean Slate (In Progress)

Target: Q2 2026 Branch: dev

Breaking Changes

  • Remove MokoCassiopeia migration — helper/migrate.php, .migrated marker, migration check in index.php, and all postflight() migration logic in script.php
  • Remove MokoCassiopeia references — str_replace(mokocassiopeia, mokoonyx) logic, OLD_NAME/OLD_DISPLAY constants, content replacement code
  • Remove migration UI — Migration fieldset in templateDetails.xml, language strings, collapsed description warning

What Stays

  • preflight() version checks (PHP 8.1+, Joomla 4.4+)
  • install() / update() / uninstall() lifecycle hooks
  • syncCustomVariables() CSS variable sync on update
  • clearFaviconStamp() favicon regeneration
  • lockExtension() protection
  • All template features, overrides, and assets unchanged

Migration Notice

Sites still running MokoCassiopeia must install MokoOnyx v01.x first to migrate settings. The v01 line remains available at the stable release tag.

v02.01.00 — Soft Offline Mode (Planned)

Target: Q3 2026

Features

  • Category-based access during site maintenance mode
  • Persistent legal links (Terms of Service, Privacy Policy) on the offline page
  • Configurable via template parameters

Technical Plan

  1. Add category multiselect field to Advanced > Offline Mode Settings
  2. Add persistent link fields (TOS URL, Privacy URL, Contact URL, Custom 1-3)
  3. Modify offline.php to check allowed categories and render their content
  4. Display persistent links in offline page footer
  5. Respect Joomla access levels

v02.02.00 — Development Mode (Planned)

Target: Q4 2026

Features

  • Template development mode toggle (already exists as commented-out param)
  • Unminified asset loading
  • Debug output panel
  • Template cache bypass
  • Performance profiling

v03.00.00 — Accessibility & Performance (2027)

Features

  • WCAG 2.1 AA compliance audit and remediation
  • Critical CSS inlining for faster first paint
  • WebP image support with automatic fallbacks
  • Enhanced responsive grid layouts
  • Additional font pairing presets
  • Keyboard navigation improvements

v04.00.00 — Advanced Layouts & Customization (2028)

Features

  • Layout presets library (blog, portfolio, business, magazine)
  • Extended color palette management (unlimited palettes)
  • CSS variable editor in template settings
  • Mega menu support
  • Advanced header variations (transparent, sticky, minimal)
  • Footer layout options

v05.00.00 — Template Extensions (2029)

Features

  • Template addon system for modular features
  • Module animation effects
  • Background image/video options per section
  • Schema markup templates
  • Open Graph and Twitter Card management
  • Reading progress indicator

Implemented Features (v01.x)

Theming

  • 3 color palettes (Standard, Alternative, Custom) with light/dark modes
  • Dark mode toggle (switch, radios, or hidden) with localStorage persistence
  • System preference auto-detection
  • Bootstrap ARIA bridge

Layout

  • 23 module positions
  • Fluid/static container toggle
  • Sticky header, back-to-top button
  • Left/right drawers with configurable icons

Content

  • Automatic Table of Contents (toc-left, toc-right article layouts)
  • JoomGallery overrides (gallery, category, image views)
  • Font Awesome 7 Free integration

Analytics

  • Google Tag Manager with container ID
  • Google Analytics 4 with property ID
  • Custom head code injection (start + end)

Accessibility

  • Accessibility toolbar (text resize, color inversion, high contrast, link highlighting, readable font, pause animations)
  • Theme toggle FAB

Developer Tools

  • Joomla Web Asset Manager integration
  • Development mode toggle (param exists)
  • CSS variable sync on update (sync_custom_vars.php)
  • Favicon auto-generation from source image

Template Overrides

  • com_content article layouts (default, toc-left, toc-right)
  • com_joomgallery (gallery, category, image)
  • 20+ module overrides (menu, feed, articles, DPCalendar, Community Builder, VirtueMart)
  • Custom module chrome (card layout)

Release Workflow

All releases via .gitea/workflows/:

  • Stream tags: stable, release-candidate, beta, alpha, development
  • Cascade: stable updates all 5 channels; rc updates rc+lower; etc.
  • Auto-detect: Element from manifest, repo from context
  • SHA verified: Joomla checksum validation passes on every release

Links

Reference in New Issue View Git Blame Copy Permalink