Feature: Add Bootstrap alert to Boost Union settings if Boost Union (or Boost Union Child) is not the active theme, resolves #773

Author: scha-ms

CHANGES.md

@@ -6,6 +6,7 @@ Changes
 
 ### Unreleased
 
+* 2025-10-16 - Feature: Add Bootstrap alert to Boost Union settings if Boost Union (or Boost Union Child) is not the active theme, resolves #773.
 * 2025-10-15 - Improvement: On course cards, display the course fields as Bootstrap badges, resolves #1070
 
 ### v5.0-r10

README.md

@@ -992,6 +992,7 @@ Moodle an Hochschulen e.V. would like to thank these main contributors (in alpha
 * RWTH Aachen, Tim Schröder: Code
 * Solent University, Mark Sharp: Code
 * ssystems GmbH, Alexander Bias: Code, Peer Review, Ideating, Funding
+* ssystems GmbH, Sangyul Cha: Code
 * Technische Universität Berlin, Lars Bonczek: Code
 * University of Bayreuth, Nikolai Jahreis: Code
 * University of California, San Francisco, Stefan Topfstedt: Code

classes/admin_settingspage_tabs_with_external_and_tertiary.php

@@ -82,6 +82,9 @@ public function output_html() {
         $this->override_selector_active_url(new \core\url('/theme/boost_union/snippets/overview.php'));
         $output .= $this->render_tertiary_navigation();
 
+        // Show alert if Boost Union is not the active theme.
+        $output .= theme_boost_union_is_not_active_alert();
+
         $activetab = optional_param('activetab', '', PARAM_TEXT);
         $context = ['tabs' => []];
         $havesetactive = false;

classes/admin_settingspage_tabs_with_tertiary.php

@@ -183,6 +183,9 @@ public function output_html() {
         // Add tertiary navigation as a select menu.
         $output .= $this->render_tertiary_navigation();
 
+        // Show alert if Boost Union is not the active theme.
+        $output .= theme_boost_union_is_not_active_alert();
+
         // Append parent output.
         $output .= parent::output_html();
 

flavours/overview.php

@@ -113,6 +113,9 @@
 echo $OUTPUT->header();
 echo \theme_boost_union\admin_settingspage_tabs_with_tertiary::get_tertiary_navigation_for_externalpage();
 
+// Show alert if Boost Union is not the active theme.
+echo theme_boost_union_is_not_active_alert();
+
 // Show flavours intro.
 $intro = new \core\output\notification(
         get_string('flavoursoverview_desc', 'theme_boost_union'), \core\output\notification::NOTIFY_INFO);

lang/en/theme_boost_union.php

@@ -33,6 +33,7 @@
 $string['choosereadme'] = 'Theme Boost Union is an enhanced child theme of Boost which is intended, on the one hand, to make Boost simply more configurable and, on the other hand, to provide helpful additional features for the daily Moodle operation of admins, teachers and students. Boost Union is maintained by Moodle an Hochschulen e.V., in cooperation with ssystems GmbH, together with bdecent GmbH and lern.link GmbH';
 $string['configtitle'] = 'Boost Union';
 $string['githubissueslink'] = '<a href="https://github.com/moodle-an-hochschulen/moodle-theme_boost_union/issues">Github issues</a>';
+$string['warningboostunioninactive'] = 'Boost Union (or a child theme of Boost Union) is currently <em>not</em> the active theme. Settings on these pages will not have any effect if you do not <a href="{$a->url}">make Boost Union the active theme</a> or allow Boost Union to be used as category / course / user / cohort theme.';
 
 // General select options.
 $string['never'] = 'Never';

locallib.php

@@ -2626,6 +2626,38 @@ function theme_boost_union_is_active_theme() {
     }
 }
 
+/**
+ * Helper function to generate HTML for an alert when Boost Union is not the active theme,
+ * but someone tries to access Boost Union's settings.
+ *
+ * @return string HTML for the alert.
+ */
+function theme_boost_union_is_not_active_alert() {
+    global $OUTPUT;
+
+    // Check if Boost Union or a child theme of it is active.
+    if (theme_boost_union_is_active_theme()) {
+        return '';
+    }
+
+    // Get the URL of the theme selector page for use in the alert.
+    $notificationurl = new core\url('/admin/themeselector.php');
+
+    // Create the notification object.
+    $notification = new core\output\notification(
+        get_string('warningboostunioninactive', 'theme_boost_union', [
+            'url' => $notificationurl->out(),
+        ]),
+        core\output\notification::NOTIFY_WARNING
+    );
+
+    // Do not show a close button.
+    $notification->set_show_closebutton(false);
+
+    // Return the HTML for the alert.
+    return $OUTPUT->render($notification);
+}
+
 /**
  * Helper function to check if a child theme of Boost Union (and _not_ Boost Union itself) is active.
  * This is needed at multiple locations to improve child theme support in Boost Union already.

settings_overview.php

@@ -51,6 +51,9 @@
 // Show page heading.
 echo $OUTPUT->heading(get_string('settingsoverview_title', 'theme_boost_union'));
 
+// Show alert if Boost Union is not the active theme.
+echo theme_boost_union_is_not_active_alert();
+
 // First, compose template context for Boost Union setting pages.
 $templatecontext['cards'][] = [
     'label' => get_string('configtitlelook', 'theme_boost_union'),

smartmenus/menus.php

@@ -107,6 +107,9 @@
 echo $OUTPUT->header();
 echo \theme_boost_union\admin_settingspage_tabs_with_tertiary::get_tertiary_navigation_for_externalpage();
 
+// Show alert if Boost Union is not the active theme.
+echo theme_boost_union_is_not_active_alert();
+
 // Show smart menus intro.
 $intro = new \core\output\notification(
         get_string('smartmenus_desc', 'theme_boost_union'), \core\output\notification::NOTIFY_INFO);

snippets/overview.php

@@ -128,6 +128,9 @@
 echo $OUTPUT->header();
 echo \theme_boost_union\admin_settingspage_tabs_with_tertiary::get_tertiary_navigation_for_externalpage();
 
+// Show alert if Boost Union is not the active theme.
+echo theme_boost_union_is_not_active_alert();
+
 // Create and render the tab tree.
 $tabtree = new \theme_boost_union\admin_externalpage_tabs();
 $tabtree->add_tab('snippetsoverview',