STICKY-ADMIN 1.0.7
By Jouweb Agency. For Joomla 5 and 6 using the Atum administrator template.
Licence: GNU General Public License version 2 or later.

INSTALLATION AND UPGRADE
1. Open System > Install > Extensions in Joomla.
2. Upload plg_system_stickyadminmenu-1.0.7.zip without extracting it.
3. On first installation the plugin is enabled automatically.
4. Reload the administrator page to activate the sticky header and menu.
Updates preserve the existing enabled/disabled state and spacing settings.
If the plugin was already disabled, enable System - Sticky-Admin under
System > Manage > Plugins. The completion message explains its actual state.
Install over earlier Jouweb Sticky Admin Menu versions; do not uninstall.
The internal element remains stickyadminmenu so existing installations are
upgraded, rather than creating a second plugin.

BEHAVIOUR
On desktop widths (576px and above), the main Joomla header stays at the
top, including the Joomla logo, dashboard title and user controls. The left
menu stays beneath it and scrolls internally when longer than the available
viewport height. Atum's full-height sidebar background remains visible below
short menus. The existing sticky action toolbar is offset below the header.
The article and module editors' primary tab rows (Content, Images and Links, Articirra
Social, Social Overrides; Module, Menu Assignment, Options, etc.) stick below the header and action toolbar
at widths of 768px and above. Long tab rows scroll horizontally. Joomla's
native accordion is preserved on smaller screens. No tabs are moved or cloned.
Header and toolbar resizing are detected automatically. No colours are hard-coded.
Atum's native menu widths, collapsed mode and right-to-left layout remain
in control. Native titles provide tooltips for clipped collapsed labels.
Below 576px Joomla's original mobile layout remains in control.

SETTINGS
Additional top offset: 0-200 pixels; default 0, for the sidebar menu.
Bottom gap: 0-100 pixels; default 8, for the sidebar menu scroll area.

SCOPE AND REMOVAL
Only authenticated administrator HTML pages using Atum are affected.
Frontend pages, login pages, component-only popups and other administrator
templates are excluded. No Joomla core files or article data are edited.
The installer changes only this plugin's enabled flag on first installation.
Disable System - Sticky-Admin to restore Joomla's original behaviour.
Uninstall through System > Manage > Extensions when no longer needed.

VALIDATION
Previous 1.0.3 PHP lint and contract checks passed on PHP 8.3.6.
1.0.5 changes PHP asset version strings only; PHP is unavailable in this run.
JavaScript syntax/DOM-stub checks and manifest/ZIP checks passed.
The user reported live success with the original menu functionality; 1.0.5
still requires a live check of article and module tab positioning.
See SECURITY-REVIEW.txt for test scope and limitations.

CHANGES IN 1.0.5
- Module-edit tabs now use the same sticky positioning as article-edit tabs.

CHANGES IN 1.0.4
- Article-edit tabs stay below the sticky header and toolbar.
- Wide tab rows scroll horizontally; mobile accordion remains native.

CHANGES IN 1.0.3
- Display name changed to System - Sticky-Admin.
- Main administrator header now stays sticky on desktop.
- Sidebar and existing sticky action toolbar sit beneath the header.
- New installs automatically enable the plugin.
- Updates preserve enabled/disabled status and existing settings.
- Post-install messages report the actual activation state and next step.

RETAINED FIXES
1.0.2: full-height sidebar background with sticky, scrolling inner menu.
1.0.1: missing-user guard, integer settings filters and asset versioning.

CHANGES IN 1.0.6
Added Joomla Update System manifest entry. Feed and installer must be hosted:
https://jouweb.co.za/updates/sticky-admin.xml
https://jouweb.co.za/downloads/sticky-admin/plg_system_stickyadminmenu-1.0.7.zip
The feed includes the exact installer SHA-256 checksum. Rebuilding or changing
the installer requires regenerating that checksum. Future versions must update
the feed version, download URL and checksum. No server files were uploaded
by this release preparation. Live update retrieval remains to be verified.

CHANGES IN 1.0.7
Added authorEmail (domains@jouweb.co.za) and authorUrl (https://jouweb.co.za/)
to the installation manifest to resolve optional JED Checker notices.
