feat: add ZM_WEB_SHOW_NAV_BUTTONS config to hide Back/Refresh buttons

connortechnology · claude · connortechnology · commit dca0f764681c · 2026-03-12T18:56:14.000-04:00
Add a boolean web config option to control visibility of the Back and
Refresh navigation buttons shown at the top of most views. Uses a body
class and CSS rule so no individual view files need changes.

Also remove the ZM_WEB_BUTTON_STYLE INSERT from the migration SQL since
zmupdate.pl handles Config table inserts from ConfigData.pm.in.

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/db/zm_update-1.39.4.sql b/db/zm_update-1.39.4.sql
@@ -17,17 +17,3 @@ UPDATE Config SET
       No: Checkbox is shown and unchecked by default. Users may check it to persist the session.
       '
 WHERE Name = 'ZM_OPT_USE_REMEMBER_ME';
-
---
--- Add ZM_WEB_BUTTON_STYLE config option
---
-
-SET @s = (SELECT IF(
-    (SELECT COUNT(*) FROM Config WHERE Name = 'ZM_WEB_BUTTON_STYLE') > 0,
-"SELECT 'ZM_WEB_BUTTON_STYLE already exists'",
-"INSERT INTO Config SET Id = 251, Name = 'ZM_WEB_BUTTON_STYLE', Value = 'icons+text', Type = 'string', DefaultValue = 'icons+text', Hint = 'icons+text|icons|text', Pattern = '(?^i:^([it]))', Format = ' $1 ', Prompt = 'How to display toolbar buttons throughout the interface', Help = 'Controls the display of toolbar buttons across the web interface. Icons + Text: Show both icon and label (default). Icons Only: Show only the icon; labels are hidden. Text Only: Show only the label; icons are hidden on buttons that have labels.', Category = 'web', Readonly = '0', Requires = ''"
-));
-
-PREPARE stmt FROM @s;
-EXECUTE stmt;
-DEALLOCATE PREPARE stmt;
diff --git a/scripts/ZoneMinder/lib/ZoneMinder/ConfigData.pm.in b/scripts/ZoneMinder/lib/ZoneMinder/ConfigData.pm.in
@@ -3035,6 +3035,19 @@ our @options = (
     },
     category    => 'web',
   },
+  {
+    name        => 'ZM_WEB_SHOW_NAV_BUTTONS',
+    default     => 'yes',
+    description => 'Show Back and Refresh buttons at the top of views.',
+    help        => q`
+      Controls whether the Back and Refresh navigation buttons are
+      displayed in the top-left corner of most views. If disabled,
+      the buttons are hidden to save screen space. You can still use
+      your browser's back and refresh functions.
+      `,
+    type        => $types{boolean},
+    category    => 'web',
+  },
   {
     name        => 'ZM_WEB_H_REFRESH_MAIN',
     default     => '240',
diff --git a/web/skins/classic/css/base/skin.css b/web/skins/classic/css/base/skin.css
@@ -1647,4 +1647,9 @@ video-stream[id^='liveStream'] video{
 .btn-text-only .btn:has(.text) > i.fa {
   display: none;
 }
+/* Hide Back and Refresh nav buttons when config disables them */
+.hide-nav-buttons #backBtn,
+.hide-nav-buttons #refreshBtn {
+  display: none;
+}
 /* --- This block should always be located at the end! */
diff --git a/web/skins/classic/includes/functions.php b/web/skins/classic/includes/functions.php
@@ -161,6 +161,7 @@ function getBodyTopHTML() {
   if (defined('ZM_WEB_FILTER_SETTINGS_POSITION') and ZM_WEB_FILTER_SETTINGS_POSITION == 'inline') $classes .= ' filter-inline';
   if (defined('ZM_WEB_BUTTON_STYLE') and ZM_WEB_BUTTON_STYLE == 'icons') $classes .= ' btn-icons-only';
   else if (defined('ZM_WEB_BUTTON_STYLE') and ZM_WEB_BUTTON_STYLE == 'text') $classes .= ' btn-text-only';
+  if (defined('ZM_WEB_SHOW_NAV_BUTTONS') and !ZM_WEB_SHOW_NAV_BUTTONS) $classes .= ' hide-nav-buttons';
   $classHTML = ' class="'.$classes.'"';
   echo '
 <body data-swipe-threshold="10" data-swipe-unit="vw" data-swipe-timeout="300"'.$classHTML.'>
