UP Admin Sidebar

Fixed adaptive admin sidebar for OpenCart and ocStore 2.3 and 3.x

What it does

Fixes the sidebar below the admin header and lets you collapse it to icons to free up workspace. Use the familiar menu button in the header. On a phone, the menu opens over the page.

How the menu works

• Full menu - 235px, with icons and section names. Opens by default on large screens unless you previously selected compact mode.
• Compact menu - 60px, with icons only. Click a section to open its submenu and expand nested sections inside it. This mode is automatic on screens 768-991px wide.
• On a phone - the menu stays hidden until opened and takes no space on the page.
• Open mobile menu - appears over the page with a dimmed backdrop. Close it with the menu button, a click on the backdrop, or Escape. Background scrolling is locked while it is open.

Features

• The menu stays in place while scrolling a long page. When it has many items, the menu itself scrolls independently.
• Your full or compact desktop choice is remembered in this browser separately for each user and admin path. Opening the menu on a phone does not change it.
• Submenus open by click, without hover opening or delays. Nested sections and links retain their original elements. Another click, Escape, or a click outside the menu closes the submenu.
• Keyboard control: Tab and Shift+Tab move focus within the open mobile menu; Escape closes it and returns focus to the button.
• Keeps your admin colors. Row and icon sizes, indentation, and the menu toggle are aligned across 2.3 and 3.
• OpenCart and ocStore 2.3 and 3.x in one .ocmod.zip.
• No separate settings page or module database tables.
• UP Admin Sidebar controls the side menu; UP Admin Width controls the admin workspace width.

Installation and upgrade

Upload the .ocmod.zip through the extension installer, refresh Modifications, and reload the admin page.

Upgrade on 2.3: first delete the previous UP Admin Sidebar entry from Modifications and refresh. Then install the new ZIP and refresh again. The native ZIP installer requires working FTP settings.

Upgrade on the tested 3.x versions: installing the new ZIP replaces the previous modification. Refresh Modifications afterward.

If version 1.0.x is still installed, first uninstall its old entry under Extensions -> Modules.

Terms of use

The module is provided as is, with no warranties. Conflicts caused by the uniqueness of your OCMOD modifications or custom admin theme are not my problem. Released for free to the community. You may adapt and modify this mini-module for your own needs, but please preserve attribution.

License and requirements

Free. MIT license.

Platform - OpenCart and ocStore 2.3 and 3.x.
Server - no separate services or additional software for the module itself.
Browser - a modern browser for full mobile menu functionality.

Tested - OpenCart 2.3.0.2 / 3.0.3.8 and ocStore 2.3.0.2.4 / 3.0.3.7, standard admin themes, Chrome. All menu sections and destinations, installation, and upgrade from the legacy implementation were checked. Other versions, browsers, and custom themes need separate qualification.