use own class, use toggler

Author: dgrammatiko

administrator/language/en-GB/plg_behaviour_compat.ini

@@ -11,3 +11,5 @@ PLG_COMPAT_FIELD_ES5_ASSETS_LABEL="ES5 Assets"
 PLG_COMPAT_FIELD_REMOVED_ASSETS_DESCRIPTION="Activate this option if your extension requires removed assets which has resulted in an exception. The assets provided are empty but prevent the exception."
 PLG_COMPAT_FIELD_REMOVED_ASSETS_LABEL="Removed Assets"
 PLG_COMPAT_XML_DESCRIPTION="If you use extensions which are not using the current Joomla Coding standards then this plugin, when enabled, will provide backward compatibility to the prior major version."
+PLG_COMPAT_FIELD_HTML_HELPERS_LABEL="HTMLHelper classes/functions"
+PLG_COMPAT_FIELD_HTML_HELPERS_DESCRIPTION="Activate this option if your extension requires deprecated HTMLHelper classes or functions. When enabled, will provide backward compatibility to the prior major version."

plugins/behaviour/compat/compat.xml

@@ -33,6 +33,18 @@
 					<option value="0">JNO</option>
 					<option value="1">JYES</option>
 				</field>
+				<field
+					name="html_helpers"
+					type="radio"
+					label="PLG_COMPAT_FIELD_HTML_HELPERS_LABEL"
+					description="PLG_COMPAT_FIELD_HTML_HELPERS_DESCRIPTION"
+					layout="joomla.form.field.radio.switcher"
+					default="1"
+					filter="integer"
+					>
+					<option value="0">JNO</option>
+					<option value="1">JYES</option>
+				</field>
 				<field
 					name="es5_assets"
 					type="radio"

plugins/behaviour/compat/src/Extension/Compat.php

@@ -11,12 +11,11 @@
 namespace Joomla\Plugin\Behaviour\Compat\Extension;
 
 use Joomla\CMS\Event\Application\AfterInitialiseDocumentEvent;
-use Joomla\CMS\Factory;
-use Joomla\CMS\HTML\HTMLHelper;
 use Joomla\CMS\Plugin\CMSPlugin;
 use Joomla\Event\DispatcherInterface;
 use Joomla\Event\Priority;
 use Joomla\Event\SubscriberInterface;
+use Joomla\Plugin\Behaviour\Compat\HTMLHelper\Bootstrap;
 
 // phpcs:disable PSR1.Files.SideEffects
 \defined('_JEXEC') or die;
@@ -94,8 +93,13 @@ public function __construct(DispatcherInterface $dispatcher, array $config = [])
      */
     public function onAfterInitialiseDocument(AfterInitialiseDocumentEvent $event)
     {
-        if (!HTMLHelper::isRegistered('bootstrap.framework')) {
-            HTMLHelper::register('bootstrap.framework', 'Joomla\Plugin\Behaviour\Compat\Extension\Compat::framework');
+        /**
+         * Load the deprecated HTMLHelper classes/functions
+         * likely be removed in Joomla 7.0
+         */
+        if ($this->params->get('html_helpers', '1')) {
+            // Restore HTMLHelper::Bootstrap('framework')
+            new Bootstrap();
         }
 
         /**
@@ -121,29 +125,4 @@ public function onAfterInitialiseDocument(AfterInitialiseDocumentEvent $event)
                 ->addRegistryFile('media/plg_behaviour_compat/removed.asset.json');
         }
     }
-
-    /**
-     * Method to load the ALL the Bootstrap Components
-     *
-     * If debugging mode is on an uncompressed version of Bootstrap is included for easier debugging.
-     *
-     * @param   mixed  $debug  Is debugging mode on? [optional]
-     *
-     * @return  void
-     *
-     * @deprecated  4.0 will be removed in 6.0
-     *              Will be removed without replacement
-     *              Load the different scripts with their individual method calls
-     */
-    public static function framework($debug = null): void
-    {
-        $wa = Factory::getApplication()->getDocument()->getWebAssetManager();
-
-        array_map(
-            function ($script) use ($wa) {
-                $wa->useScript('bootstrap.' . $script);
-            },
-            ['alert', 'button', 'carousel', 'collapse', 'dropdown', 'modal', 'offcanvas', 'popover', 'scrollspy', 'tab', 'toast']
-        );
-    }
 }

plugins/behaviour/compat/src/HTMLHelper/Bootstrap.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * @copyright   (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Plugin\Behaviour\Compat\HTMLHelper;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\HTML\HTMLHelper;
+
+Class Bootstrap
+{
+    public function __construct()
+    {
+        if (!HTMLHelper::isRegistered('bootstrap.framework')) {
+            HTMLHelper::register('bootstrap.framework', 'Joomla\Plugin\Behaviour\Compat\HTMLHelper\Bootstrap::framework');
+        }
+    }
+
+    /**
+     * Method to load the ALL the Bootstrap Components
+     *
+     * If debugging mode is on an uncompressed version of Bootstrap is included for easier debugging.
+     *
+     * @param   mixed  $debug  Is debugging mode on? [optional]
+     *
+     * @return  void
+     *
+     * @deprecated  4.0 will be removed in 6.0
+     *              Will be removed without replacement
+     *              Load the different scripts with their individual method calls
+     */
+    public static function framework($debug = null): void
+    {
+        $wa = Factory::getApplication()->getDocument()->getWebAssetManager();
+
+        array_map(
+            function ($script) use ($wa) {
+                $wa->useScript('bootstrap.' . $script);
+            },
+            ['alert', 'button', 'carousel', 'collapse', 'dropdown', 'modal', 'offcanvas', 'popover', 'scrollspy', 'tab', 'toast']
+        );
+    }
+}