Add adminBarMenuItems option

- Add a new "adminBarMenuItems" option.
  This is a JSON object that defines the menu items to display in the
  admin bar.

Author: john-shaffer

CHANGELOG.md

@@ -4,6 +4,11 @@
 - Fix an error when applying an option's default blob_value.
 - Fix a missing import on the logs-page that was breaking the
   "Delete Logs" button.
+- Add an "object" option type.
+  This is used for the new "adminBarMenuItems" option.
+- Add a new "adminBarMenuItems" option.
+  This is a JSON object that defines the menu items to display in the
+  admin bar.
 
 ## Static Deploy 9.0.1 (2025-07-16)
 

src/AdminBar.php

@@ -46,27 +46,27 @@ public static function adminBarMenuHook( \WP_Admin_Bar $wp_admin_bar ): void {
         ];
         $wp_admin_bar->add_node( $node );
 
-        $node = [
-            'id' => 'static-deploy-github',
-            'parent' => 'static-deploy-status',
-            'title' => '<a href="https://github.com/staticweb-io/static-deploy" ' .
-            ' target="_blank">GitHub</a>',
-        ];
-        $wp_admin_bar->add_node( $node );
-
-        $node = [
-            'id' => 'static-deploy-news',
-            'parent' => 'static-deploy-status',
-            'title' => '<a href="https://staticweb.io/news/" target="_blank">News</a>',
-        ];
-        $wp_admin_bar->add_node( $node );
+        $menu_items = Options::getBlobValue( 'adminBarMenuItems' );
+        $menu_items = (array) json_decode( $menu_items );
+
+        // Sort alphabetically by label
+        uasort(
+            $menu_items,
+            function ( $a, $b ) {
+                return strcmp( $a->label, $b->label );
+            }
+        );
 
-        $node = [
-            'id' => 'static-deploy-platform',
-            'parent' => 'static-deploy-status',
-            'title' => '<a href="https://staticweb.io/platform/" target="_blank">Platform</a>',
-        ];
-        $wp_admin_bar->add_node( $node );
+        foreach ( $menu_items as $id => $item ) {
+            $label = sanitize_text_field( $item->label );
+            $href = esc_url( $item->href );
+            $node = [
+                'id' => $id,
+                'parent' => 'static-deploy-status',
+                'title' => '<a href="' . $href . '" target="_blank">' . $label . '</a>',
+            ];
+            $wp_admin_bar->add_node( $node );
+        }
     }
 
     public static function afterAdminBarRender(): void {

src/Options.php

@@ -56,7 +56,30 @@ public static function optionSpecs(): array {
             return self::$cached_option_specs;
         }
 
+        $default_admin_bar_menu_items = [
+            'static-deploy-github' => [
+                'href' => 'https://github.com/staticweb-io/static-deploy',
+                'label' => 'GitHub',
+            ],
+            'static-deploy-news' => [
+                'href' => 'https://staticweb.io/news/',
+                'label' => 'News',
+            ],
+            'static-deploy-platform' => [
+                'href' => 'https://staticweb.io/platform/',
+                'label' => 'Platform',
+            ],
+        ];
+
         $specs = [
+            new OptionSpec(
+                'object',
+                'adminBarMenuItems',
+                '1',
+                'Admin Bar Menu Items',
+                '',
+                json_encode( $default_admin_bar_menu_items ),
+            ),
             new OptionSpec(
                 'boolean',
                 'detectCustomPostTypes',
@@ -730,6 +753,7 @@ public static function savePosted( string $screen = 'core' ): void {
                 break;
             case 'advanced':
                 $names = [
+                    'adminBarMenuItems',
                     'crawlConcurrency',
                     'crawledSitePath',
                     'debugLogging',

views/advanced-options-page.php

@@ -74,6 +74,16 @@
 
     <p/>
 
+    <h2>UI Options</h2>
+
+    <table class="widefat striped">
+        <tbody>
+            <?php echo $row( 'adminBarMenuItems' ); ?>
+        </tbody>
+    </table>
+
+    <p/>
+
     <?php wp_nonce_field( strval( $view['nonce_action'] ) ); ?>
     <input name="action" type="hidden" value="<?php echo Controller::getHookName( 'ui_save_advanced_options' ); ?>" />