MTS Sidebar Nav — Release Notes

v1.2.0

Headline: Per–Security-Group theming. Themes are now records you can create, assign to Security Groups, and one can be marked Global. The correct theme is resolved automatically for each user and injected into the page.

Added

• Record-based themes in the MTS Sidebar Nav module (List / Create / Edit / Detail) — each theme holds a full color + layout configuration.
• Automatic per-user resolution: group theme → global theme → none (default SuiteCRM look).
• Security Group assignment via the Security Groups subpanel; multi-group users resolve by primary group (deterministic fallback to earliest group).
• Global theme flag — one theme acts as the default and powers the login page.
• Enable Sidebar menu toggle per theme — sidebar layout on, or keep the default SuiteCRM navbar while still applying theme colors.
• Live preview in the theme editor (navbar, panels, dashlet, list view, tabs, buttons, inputs, links) that updates as you change colors.
• Clone action to duplicate a theme into a new record (full config copy, Active, not Global).
• Per-theme dark mode options (enable toggle, default-on).
• Admin entry Sidebar Nav Themes (opens the theme list) under MTS Sidebar Navigation.

Changed

• Themes are compiled to individual cached CSS files (/legacy/cache/mts_theme/theme__.css) and injected as <link /> tags, instead of a single shared inline <style scoped="scoped">. Content-hashed filenames auto-bust browser cache.
• Theme CSS is now injected server-side via the kernel.response listener only — no edits to dist/index.html.
• Marking a theme Global now deactivates any previously Global theme (only one Global at a time), with a confirmation prompt.
• The global colour settings file (settings.json) is now only a default template for new theme records — it is no longer a runtime fallback.

Removed

• The assignment “mode” concept (global / security_group / hybrid) and its admin screen. Resolution is now fully automatic, so no mode selection is needed.

Notes / behavior

• Changes take effect on the next full page reload (F5); in-app SPA navigation does not re-inject the theme.
• No server cache clear is required for theme value/assignment changes.
• The login page always uses the Global theme (no user/group context before login). If no Global theme exists, the login page keeps the default SuiteCRM look.
• If no theme matches and there is no Global theme, no theme is injected (default appearance).
• Requires a valid MTS Sidebar Nav license; otherwise nothing is injected.

Upgrade

• Run Admin → Repair → Quick Repair and Rebuild after deploying (adds the status, is_global fields and the Security Groups relationship to the MTS Sidebar Nav module).
• Existing global colours in settings.json remain as the template for new themes. To keep a global theme, create a theme, configure it, and mark it Global.

v1.1.0 (baseline)

• Single global sidebar/navbar theme configured via the admin Settings screen, applied to all users by injecting inline CSS into the app shell.

[Version 1.0]

Provide a tool to change the colors in the SuiteCRM v8 default theme includes:

• Navibar/menu bar
• Input/dropdown/button
• Error box
• Global search box
• Listview/ Table