MDL-76867 core: Add plugin management page

admin/amd/build/plugin_management_table.min.js

@@ -0,0 +1,3 @@
+define("core_admin/plugin_management_table",["exports","core_table/dynamic","core_table/local/dynamic/selectors","core/ajax","core/pending","core/notification"],(function(_exports,_dynamic,Selectors,_ajax,_pending,_notification){var obj;function _getRequireWildcardCache(nodeInterop){if("function"!=typeof WeakMap)return null;var cacheBabelInterop=new WeakMap,cacheNodeInterop=new WeakMap;return(_getRequireWildcardCache=function(nodeInterop){return nodeInterop?cacheNodeInterop:cacheBabelInterop})(nodeInterop)}function _defineProperty(obj,key,value){return(key=function(arg){var key=function(input,hint){if("object"!=typeof input||null===input)return input;var prim=input[Symbol.toPrimitive];if(void 0!==prim){var res=prim.call(input,hint||"default");if("object"!=typeof res)return res;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===hint?String:Number)(input)}(arg,"string");return"symbol"==typeof key?key:String(key)}(key))in obj?Object.defineProperty(obj,key,{value:value,enumerable:!0,configurable:!0,writable:!0}):obj[key]=value,obj}Object.defineProperty(_exports,"__esModule",{value:!0}),_exports.default=void 0,Selectors=function(obj,nodeInterop){if(!nodeInterop&&obj&&obj.__esModule)return obj;if(null===obj||"object"!=typeof obj&&"function"!=typeof obj)return{default:obj};var cache=_getRequireWildcardCache(nodeInterop);if(cache&&cache.has(obj))return cache.get(obj);var newObj={},hasPropertyDescriptor=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var key in obj)if("default"!==key&&Object.prototype.hasOwnProperty.call(obj,key)){var desc=hasPropertyDescriptor?Object.getOwnPropertyDescriptor(obj,key):null;desc&&(desc.get||desc.set)?Object.defineProperty(newObj,key,desc):newObj[key]=obj[key]}newObj.default=obj,cache&&cache.set(obj,newObj);return newObj}(Selectors),_pending=(obj=_pending)&&obj.__esModule?obj:{default:obj};let watching=!1;return _exports.default=class{constructor(){_defineProperty(this,"clickHandlers",[]),this.addClickHandler(this.handleStateToggle),this.registerEventListeners()}static init(){watching||(watching=!0,new this)}addClickHandler(handler){this.clickHandlers.push(handler.bind(this))}registerEventListeners(){document.addEventListener("click",function(e){const tableRoot=this.getTableRoot(e);tableRoot&&this.clickHandlers.forEach((handler=>handler(tableRoot,e)))}.bind(this))}getTableRoot(e){const tableRoot=e.target.closest(Selectors.main.region);return tableRoot||!1}setPluginState(methodname,plugin,state){return(0,_ajax.call)([{methodname:methodname,args:{plugin:plugin,state:state}}])[0]}async handleStateToggle(tableRoot,e){const stateToggle=e.target.closest('[data-action="togglestate"][data-toggle-method]');if(stateToggle){e.preventDefault();const pendingPromise=new _pending.default("core_table/dynamic:togglestate");await this.setPluginState(stateToggle.dataset.toggleMethod,stateToggle.dataset.plugin,"1"===stateToggle.dataset.state?0:1);const[updatedRoot]=await Promise.all([(0,_dynamic.refreshTableContent)(tableRoot),(0,_notification.fetchNotifications)()]);updatedRoot.querySelector('[data-action="togglestate"][data-plugin="'.concat(stateToggle.dataset.plugin,'"]')).focus(),pendingPromise.resolve()}}},_exports.default}));
+
+//# sourceMappingURL=plugin_management_table.min.js.map

admin/amd/src/plugin_management_table.js

@@ -0,0 +1,133 @@
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+import {refreshTableContent} from 'core_table/dynamic';
+import * as Selectors from 'core_table/local/dynamic/selectors';
+import {call as fetchMany} from 'core/ajax';
+import Pending from 'core/pending';
+import {fetchNotifications} from 'core/notification';
+
+let watching = false;
+
+export default class {
+    /**
+     * @property {function[]} clickHandlers a list of handlers to call on click.
+     */
+    clickHandlers = [];
+
+    constructor() {
+        this.addClickHandler(this.handleStateToggle);
+        this.registerEventListeners();
+    }
+
+    /**
+     * Initialise an instance of the class.
+     *
+     * This is just a way of making it easier to initialise an instance of the class from PHP.
+     */
+    static init() {
+        if (watching) {
+            return;
+        }
+        watching = true;
+        new this();
+    }
+
+    /**
+     * Add a click handler to the list of handlers.
+     *
+     * @param {Function} handler A handler to call on a click event
+     */
+    addClickHandler(handler) {
+        this.clickHandlers.push(handler.bind(this));
+    }
+
+    /**
+     * Register the event listeners for this instance.
+     */
+    registerEventListeners() {
+        document.addEventListener('click', function(e) {
+            const tableRoot = this.getTableRoot(e);
+
+            if (!tableRoot) {
+                return;
+            }
+
+            this.clickHandlers.forEach((handler) => handler(tableRoot, e));
+        }.bind(this));
+    }
+
+    /**
+     * Get the table root from an event.
+     *
+     * @param {Event} e
+     * @returns {HTMLElement|bool}
+     */
+    getTableRoot(e) {
+        const tableRoot = e.target.closest(Selectors.main.region);
+        if (!tableRoot) {
+            return false;
+        }
+
+        return tableRoot;
+    }
+
+    /**
+     * Set the plugin state (enabled or disabled)
+     *
+     * @param {string} methodname The web service to call
+     * @param {string} plugin The name of the plugin to set the state for
+     * @param {number} state The state to set
+     * @returns {Promise}
+     */
+    setPluginState(methodname, plugin, state) {
+        return fetchMany([{
+            methodname,
+            args: {
+                plugin,
+                state,
+            },
+        }])[0];
+    }
+
+    /**
+     * Handle state toggling.
+     *
+     * @param {HTMLElement} tableRoot
+     * @param {Event} e
+     */
+    async handleStateToggle(tableRoot, e) {
+        const stateToggle = e.target.closest('[data-action="togglestate"][data-toggle-method]');
+        if (stateToggle) {
+            e.preventDefault();
+            const pendingPromise = new Pending('core_table/dynamic:togglestate');
+
+            await this.setPluginState(
+                stateToggle.dataset.toggleMethod,
+                stateToggle.dataset.plugin,
+                stateToggle.dataset.state === '1' ? 0 : 1
+            );
+
+            const [updatedRoot] = await Promise.all([
+                refreshTableContent(tableRoot),
+                fetchNotifications(),
+            ]);
+
+            // Refocus on the link that as pressed in the first place.
+            updatedRoot.querySelector(`[data-action="togglestate"][data-plugin="${stateToggle.dataset.plugin}"]`).focus();
+            pendingPromise.resolve();
+        }
+    }
+}

admin/classes/admin/admin_setting_plugin_manager.php

@@ -0,0 +1,127 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace core_admin\admin;
+
+use admin_setting;
+use core_plugin_manager;
+use core_text;
+
+/**
+ * Admin setting plugin manager.
+ *
+ * @package    core_admin
+ * @subpackage admin
+ * @copyright  2023 Andrew Lyons <[email protected]>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class admin_setting_plugin_manager extends admin_setting {
+    /** @var core_plugin_manager The plugin manager instance */
+    protected core_plugin_manager $pluginmanager;
+
+    /** @var string The plugintype that this manager covers */
+    protected string $plugintype;
+
+    /** @var string The class of the management table to use */
+    protected string $tableclass;
+
+    public function __construct(
+        string $plugintype,
+        string $tableclass,
+        string $name,
+        string $visiblename,
+        string $description = '',
+        string $defaultsetting = '',
+    ) {
+        $this->nosave = true;
+        $this->pluginmanager = core_plugin_manager::instance();
+        $this->plugintype = $plugintype;
+        $this->tableclass = $tableclass;
+
+        parent::__construct($name, $visiblename, $description, $defaultsetting);
+    }
+
+    /**
+     * Always returns true, does nothing
+     *
+     * @return true
+     */
+    public function get_setting(): bool {
+        return true;
+    }
+
+    /**
+     * Always returns true, does nothing
+     *
+     * @return true
+     */
+    public function get_defaultsetting(): bool {
+        return true;
+    }
+
+    /**
+     * Always returns '', does not write anything
+     *
+     * @return string Always returns ''
+     */
+    // phpcs:disable VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
+    public function write_setting($data): string {
+        // Do not write any setting.
+        return '';
+    }
+
+    /**
+     * Checks if $query is one of the available editors
+     *
+     * @param string $query The string to search for
+     * @return bool Returns true if found, false if not
+     */
+    public function is_related($query) {
+        if (parent::is_related($query)) {
+            return true;
+        }
+
+        $plugins = $this->pluginmanager->get_installed_plugins($this->plugintype);
+        foreach (array_keys($plugins) as $plugin) {
+            $plugin = "{$this->plugintype}_{$plugin}";
+            if (str_contains($plugin, $query)) {
+                return true;
+            }
+
+            $pluginname = get_string('pluginname', $plugin);
+            if (strpos(core_text::strtolower($pluginname), $query) !== false) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Builds the XHTML to display the control
+     *
+     * @param string $data Unused
+     * @param string $query
+     * @return string
+     */
+    public function output_html($data, $query = ''): string {
+        $table = new $this->tableclass();
+        if (!($table instanceof \core_admin\table\plugin_management_table)) {
+            throw new \coding_exception("{$this->tableclass} must be an instance of \\core_admin\\table\\plugin_management_table");
+        }
+        return highlight($query, $table->get_content());
+    }
+}

admin/classes/external/set_plugin_state.php

@@ -0,0 +1,98 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace core_admin\external;
+
+use core_external\external_api;
+use core_external\external_function_parameters;
+use core_external\external_single_structure;
+use core_external\external_value;
+
+/**
+ * Web Service to control the state of a plugin.
+ *
+ * @package   core_admin
+ * @category  external
+ * @copyright 2023 Andrew Lyons <[email protected]>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class set_plugin_state extends external_api {
+    /**
+     * Returns description of method parameters
+     *
+     * @return external_function_parameters
+     */
+    public static function execute_parameters(): external_function_parameters {
+        return new external_function_parameters([
+            'plugin' => new external_value(PARAM_PLUGIN, 'The name of the plugin', VALUE_REQUIRED),
+            'state' => new external_value(PARAM_INT, 'The target state', VALUE_REQUIRED),
+        ]);
+    }
+
+    /**
+     * Set the plugin state.
+     *
+     * @param string $plugin The name of the plugin
+     * @param int $state The target state
+     * @return null
+     */
+    public static function execute(
+        string $plugin,
+        int $state,
+    ): array {
+        [
+            'plugin' => $plugin,
+            'state' => $state,
+        ] = self::validate_parameters(self::execute_parameters(), [
+            'plugin' => $plugin,
+            'state' => $state,
+        ]);
+
+        $context = \context_system::instance();
+        self::validate_context($context);
+        require_capability('moodle/site:config', $context);
+
+        [$plugintype, $pluginname] = explode('_', \core_component::normalize_componentname($plugin), 2);
+
+        $manager = \core_plugin_manager::resolve_plugininfo_class($plugintype);
+        $displayname = get_string('pluginname', $plugin);
+
+        if ($manager::enable_plugin($pluginname, $state)) {
+            if (!empty($state)) {
+                \core\notification::add(
+                    get_string('plugin_enabled', 'core_admin', $displayname),
+                    \core\notification::SUCCESS
+                );
+            } else {
+                \core\notification::add(
+                    get_string('plugin_disabled', 'core_admin', $displayname),
+                    \core\notification::SUCCESS
+                );
+            }
+        }
+
+        return [];
+    }
+
+    /**
+     * Describe the return structure of the external service.
+     *
+     * @return external_single_structure
+     */
+    public static function execute_returns(): external_single_structure {
+        return new external_single_structure([]);
+    }
+}

admin/classes/table/plugin_management_table.php

@@ -0,0 +1,398 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace core_admin\table;
+
+use context_system;
+use core_plugin_manager;
+use core_table\dynamic as dynamic_table;
+use flexible_table;
+use html_writer;
+use moodle_url;
+use stdClass;
+
+defined('MOODLE_INTERNAL') || die();
+require_once("{$CFG->libdir}/tablelib.php");
+
+/**
+ * Plugin Management table.
+ *
+ * @package    core_admin
+ * @copyright  2023 Andrew Lyons <[email protected]>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+abstract class plugin_management_table extends flexible_table implements dynamic_table {
+
+    /** @var \core\plugininfo\base[] The plugin list */
+    protected array $plugins = [];
+
+    /** @var int The number of enabled plugins of this type */
+    protected int $enabledplugincount = 0;
+
+    /** @var core_plugin_manager */
+    protected core_plugin_manager $pluginmanager;
+
+    /** @var string The plugininfo class for this plugintype */
+    protected string $plugininfoclass;
+
+    public function __construct() {
+        global $CFG;
+
+        parent::__construct($this->get_table_id());
+        require_once($CFG->libdir . '/adminlib.php');
+
+        // Fetch the plugininfo class.
+        $this->pluginmanager = core_plugin_manager::instance();
+        $this->plugininfoclass = $this->pluginmanager::resolve_plugininfo_class($this->get_plugintype());
+
+        $this->guess_base_url();
+
+        $this->plugins = $this->get_sorted_plugins();
+        $this->enabledplugincount = count(array_filter($this->plugins, function ($plugin) {
+            return $plugin->is_enabled();
+        }));
+
+        $this->setup_column_configuration();
+        $this->set_filterset(new plugin_management_table_filterset());
+        $this->setup();
+    }
+
+    /**
+     * Get the list of sorted plugins.
+     *
+     * @return \core\plugininfo\base[]
+     */
+    protected function get_sorted_plugins(): array {
+        $plugins = $this->pluginmanager->get_plugins_of_type($this->get_plugintype());
+        return self::sort_plugins($plugins);
+    }
+
+    /**
+     * Sort the plugins list.
+     *
+     * Note: This only applies to plugins which do not support ordering.
+     *
+     * @param \core\plugininfo\base[] $plugins
+     * @return \core\plugininfo\base[]
+     */
+    protected function sort_plugins(array $plugins): array {
+        // The asort functions work by reference.
+        \core_collator::asort_objects_by_property($plugins, 'displayname');
+
+        return $plugins;
+    }
+
+    /**
+     * Set up the column configuration for this table.
+     */
+    protected function setup_column_configuration(): void {
+        $columnlist = $this->get_column_list();
+        $this->define_columns(array_keys($columnlist));
+        $this->define_headers(array_values($columnlist));
+
+        $columnswithhelp = $this->get_columns_with_help();
+        $columnhelp = array_map(function (string $column) use ($columnswithhelp): ?\renderable {
+            if (array_key_exists($column, $columnswithhelp)) {
+                return $columnswithhelp[$column];
+            }
+
+            return null;
+        }, array_keys($columnlist));
+        $this->define_help_for_headers($columnhelp);
+    }
+
+    /**
+     * Set the standard order of the plugins.
+     *
+     * @param array $plugins
+     * @return array
+     */
+    protected function order_plugins(array $plugins): array {
+        uasort($plugins, function ($a, $b) {
+            if ($a->is_enabled() && !$b->is_enabled()) {
+                return -1;
+            } else if (!$a->is_enabled() && $b->is_enabled()) {
+                return 1;
+            }
+            return strnatcasecmp($a->displayname, $b->displayname);
+        });
+
+        return $plugins;
+    }
+
+    /**
+     * Get the plugintype for this table.
+     *
+     * @return string
+     */
+    abstract protected function get_plugintype(): string;
+
+    /**
+     * Get the action URL for this table.
+     *
+     * The action URL is used to perform all actions when JS is not available.
+     *
+     * @param array $params
+     * @return moodle_url
+     */
+    abstract protected function get_action_url(array $params = []): moodle_url;
+
+    /**
+     * Provide a default implementation for guessing the base URL from the action URL.
+     */
+    public function guess_base_url(): void {
+        $this->define_baseurl($this->get_action_url());
+    }
+
+    /**
+     * Get the web service method used to toggle state.
+     *
+     * @return null|string
+     */
+    protected function get_toggle_service(): ?string {
+        return 'core_admin_set_plugin_state';
+    }
+
+    /**
+     * Get the ID of the table.
+     *
+     * @return string
+     */
+    protected function get_table_id(): string {
+        return 'plugin_management_table-' . $this->get_plugintype();
+    }
+
+    /**
+     * Get a list of the column titles
+     * @return string[]
+     */
+    protected function get_column_list(): array {
+        $columns = [
+            'name' => get_string('name', 'core'),
+            'version' => get_string('version', 'core'),
+        ];
+
+        if ($this->supports_disabling()) {
+            $columns['enabled'] = get_string('pluginenabled', 'core_plugin');
+        }
+
+        $columns['settings'] = get_string('settings', 'core');
+        $columns['uninstall'] = get_string('uninstallplugin', 'core_admin');
+
+        return $columns;
+    }
+
+    protected function get_columns_with_help(): array {
+        return [];
+    }
+
+    /**
+     * Get the context for this table.
+     *
+     * @return context_system
+     */
+    public function get_context(): context_system {
+        return context_system::instance();
+    }
+
+    /**
+     * Get the table content.
+     */
+    public function get_content(): string {
+        ob_start();
+        $this->out();
+        $content = ob_get_contents();
+        ob_end_clean();
+        return $content;
+    }
+
+    /**
+     * Print the table.
+     */
+    public function out(): void {
+        $plugintype = $this->get_plugintype();
+        foreach ($this->plugins as $plugininfo) {
+            $plugin = "{$plugintype}_{$plugininfo->name}";
+            $rowdata = (object) [
+                'plugin' => $plugin,
+                'plugininfo' => $plugininfo,
+                'name' => $plugininfo->displayname,
+                'version' => $plugininfo->versiondb,
+            ];
+            $this->add_data_keyed(
+                $this->format_row($rowdata),
+                $this->get_row_class($rowdata)
+            );
+        }
+
+        $this->finish_output(false);
+    }
+
+    /**
+     * This table is not downloadable.
+     * @param bool $downloadable
+     * @return bool
+     */
+    // phpcs:disable VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
+    public function is_downloadable($downloadable = null): bool {
+        return false;
+    }
+
+    /**
+     * Show the name column content.
+     *
+     * @param stdClass $row
+     * @return string
+     */
+    protected function col_name(stdClass $row): string {
+        if ($row->plugininfo->is_installed_and_upgraded()) {
+            return $row->plugininfo->displayname;
+        }
+
+        return html_writer::span(
+            $row->plugininfo->displayname,
+            'notifyproblem'
+        );
+    }
+
+    /**
+     * Show the enable/disable column content.
+     *
+     * @param stdClass $row
+     * @return string
+     */
+    protected function col_enabled(stdClass $row): string {
+        global $OUTPUT;
+
+        $enabled = $row->plugininfo->is_enabled();
+        $params = [
+            'sesskey' => sesskey(),
+            'plugin' => $row->plugininfo->name,
+            'action' => $enabled ? 'disable' : 'enable',
+        ];
+
+        if ($enabled) {
+            $icon = $OUTPUT->pix_icon('t/hide', get_string('disableplugin', 'core_admin', $row->plugininfo->displayname));
+        } else {
+            $icon = $OUTPUT->pix_icon('t/show', get_string('enableplugin', 'core_admin', $row->plugininfo->displayname));
+        }
+
+        return html_writer::link(
+            $this->get_action_url($params),
+            $icon,
+            [
+                'data-toggle-method' => $this->get_toggle_service(),
+                'data-action' => 'togglestate',
+                'data-plugin' => $row->plugin,
+                'data-state' => $enabled ? 1 : 0,
+            ],
+        );
+    }
+
+    /**
+     * Show the settings column content.
+     *
+     * @param stdClass $row
+     * @return string
+     */
+    protected function col_settings(stdClass $row): string {
+        if ($settingsurl = $row->plugininfo->get_settings_url()) {
+            return html_writer::link($settingsurl, get_string('settings'));
+        }
+
+        return '';
+    }
+
+    /**
+     * Show the Uninstall column content.
+     *
+     * @param stdClass $row
+     * @return string
+     */
+    protected function col_uninstall(stdClass $row): string {
+        $status = $row->plugininfo->get_status();
+
+        if ($status === core_plugin_manager::PLUGIN_STATUS_NEW) {
+            return get_string('status_new', 'core_plugin');
+        }
+
+        if ($status === core_plugin_manager::PLUGIN_STATUS_MISSING) {
+            $uninstall = get_string('status_missing', 'core_plugin') . '<br/>';
+        } else {
+            $uninstall = '';
+        }
+
+        if ($uninstallurl = $this->pluginmanager->get_uninstall_url($row->plugin)) {
+            $uninstall .= html_writer::link($uninstallurl, get_string('uninstallplugin', 'core_admin'));
+        }
+
+        return $uninstall;
+    }
+
+    /**
+     * Get the JS module used to manage this table.
+     *
+     * This should be a class which extends 'core_admin/plugin_management_table'.
+     *
+     * @return string
+     */
+    protected function get_table_js_module(): string {
+        return 'core_admin/plugin_management_table';
+    }
+
+    /**
+     * Add JS specific to this implementation.
+     *
+     * @return string
+     */
+    protected function get_dynamic_table_html_end(): string {
+        global $PAGE;
+
+        $PAGE->requires->js_call_amd($this->get_table_js_module(), 'init');
+        return parent::get_dynamic_table_html_end();
+    }
+
+    /**
+     * Get any class to add to the row.
+     *
+     * @param mixed $row
+     * @return string
+     */
+    protected function get_row_class($row): string {
+        $plugininfo = $row->plugininfo;
+        if ($plugininfo->get_status() === core_plugin_manager::PLUGIN_STATUS_MISSING) {
+            return '';
+        }
+
+        if (!$plugininfo->is_enabled()) {
+            return 'dimmed_text';
+        }
+        return '';
+    }
+
+    public static function get_filterset_class(): string {
+        return self::class . '_filterset';
+    }
+
+    /**
+     * Whether this plugin type supports the disabling of plugins.
+     *
+     * @return bool
+     */
+    protected function supports_disabling(): bool {
+        return $this->plugininfoclass::plugintype_supports_disabling();
+    }
+}

admin/classes/table/plugin_management_table_filterset.php

@@ -0,0 +1,27 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace core_admin\table;
+
+/**
+ * This file contains the dynamic interface.
+ *
+ * @package core_admin
+ * @copyright 2023 Andrew Lyons <[email protected]>
+ * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class plugin_management_table_filterset extends \core_table\local\filter\filterset {
+}

admin/tests/external/set_plugin_state_test.php

@@ -0,0 +1,131 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+declare(strict_types=1);
+
+namespace core_admin\external;
+
+defined('MOODLE_INTERNAL') || die();
+
+global $CFG;
+require_once($CFG->dirroot . '/webservice/tests/helpers.php');
+
+/**
+ * Unit tests to configure the enabled/disabled state of a plugin.
+ *
+ * @package     core
+ * @covers      \core_admin\external\set_plugin_state
+ * @copyright   2023 Andrew Lyons <[email protected]>
+ * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class set_plugin_state_test extends \externallib_advanced_testcase {
+    /**
+     * Text execute method.
+     *
+     * @dataProvider execute_standard_provider
+     * @param string $plugin The name of the plugin
+     * @param int|null $initialstate The initial state of the plugin
+     * @param int $newstate The target state
+     * @param int $notificationcount The number of notifications expected
+     */
+    public function test_execute(
+        string $plugin,
+        ?int $initialstate,
+        int $newstate,
+        int $notificationcount,
+    ): void {
+        $this->resetAfterTest();
+        $this->setAdminUser();
+
+        if ($initialstate !== null) {
+            [$plugintype, $pluginname] = \core_component::normalize_component($plugin);
+            $manager = \core_plugin_manager::resolve_plugininfo_class($plugintype);
+            $manager::enable_plugin($pluginname, $initialstate);
+            \core\notification::fetch();
+        }
+
+        set_plugin_state::execute($plugin, $newstate);
+        $this->assertCount($notificationcount, \core\notification::fetch());
+    }
+
+    /**
+     * Data provider for base tests of the execute method.
+     *
+     * @return array
+     */
+    public function execute_standard_provider(): array {
+        $generatetestsfor = function (string $plugin): array {
+            return [
+                [
+                    'plugin' => $plugin,
+                    'initialstate' => null,
+                    'newstate' => 0,
+                    'notificationcount' => 1,
+                ],
+                [
+                    'plugin' => $plugin,
+                    'initialstate' => 1,
+                    'newstate' => 0,
+                    'notificationcount' => 1,
+                ],
+                [
+                    'plugin' => $plugin,
+                    'initialstate' => 1,
+                    'newstate' => 1,
+                    'notificationcount' => 0,
+                ],
+                [
+                    'plugin' => $plugin,
+                    'initialstate' => 0,
+                    'newstate' => 0,
+                    'notificationcount' => 0,
+                ],
+                [
+                    'plugin' => $plugin,
+                    'initialstate' => 0,
+                    'newstate' => 1,
+                    'notificationcount' => 1,
+                ],
+            ];
+        };
+
+        return array_merge(
+            $generatetestsfor('mod_assign'),
+            $generatetestsfor('editor_tiny'),
+            $generatetestsfor('tiny_h5p'),
+            $generatetestsfor('block_badges'),
+        );
+    }
+
+    /**
+     * Test execute method with no login.
+     */
+    public function test_execute_no_login(): void {
+        $this->expectException(\require_login_exception::class);
+        set_plugin_state::execute('mod_assign', 1);
+    }
+
+    /**
+     * Test execute method with no login.
+     */
+    public function test_execute_no_capability(): void {
+        $this->resetAfterTest();
+        $user = $this->getDataGenerator()->create_user();
+        $this->setUser($user);
+        $this->expectException(\required_capability_exception::class);
+        set_plugin_state::execute('mod_assign', 1);
+    }
+}

lang/en/admin.php

@@ -508,6 +508,7 @@ $string['devicedetectregexexpression'] = 'Regular expression';
 $string['devicedetectregexvalue'] = 'Return value';
 $string['devicetype'] = 'Device type';
 $string['disabled'] = 'Disabled';
+$string['disableplugin'] = 'Disable the {$a} plugin';
 $string['disableuserimages'] = 'Disable user profile images';
 $string['displayerrorswarning'] = 'Enabling the PHP setting <em>display_errors</em> is not recommended on production sites because some error messages may reveal sensitive information about your server.';
 $string['displayloginfailures'] = 'Display login failures';
@@ -582,6 +583,7 @@ $string['enablegravatar_help'] = 'When enabled Moodle will attempt to fetch a us
 $string['enablemobilewebservice'] = 'Enable web services for mobile devices';
 $string['enablepdfexportfont'] = 'Enable PDF fonts';
 $string['enablepdfexportfont_desc'] = 'If your site has courses in different languages which need other fonts in generated PDF files, you can provide the option to set the font in the course settings. You need to specify available fonts in $CFG->pdfexportfont in config.php.';
+$string['enableplugin'] = 'Enable the {$a} plugin';
 $string['enablerecordcache'] = 'Enable record cache';
 $string['enablerssfeeds'] = 'Enable RSS feeds';
 $string['enablesearchareas'] = 'Enable search areas';

lib/db/services.php

@@ -2953,6 +2953,12 @@ $functions = array(
         'type'        => 'write',
         'ajax'        => true,
     ],
+    'core_admin_set_plugin_state' => [
+        'classname' => 'core_admin\external\set_plugin_state',
+        'description' => 'Set the state of a plugin',
+        'type' => 'write',
+        'ajax' => true,
+    ],
 );
 
 $services = array(

version.php

@@ -29,7 +29,7 @@
 
 defined('MOODLE_INTERNAL') || die();
 
-$version  = 2023031000.00;              // YYYYMMDD      = weekly release date of this DEV branch.
+$version  = 2023031000.01;              // YYYYMMDD      = weekly release date of this DEV branch.
                                         //         RR    = release increments - 00 in DEV branches.
                                         //           .XX = incremental changes.
 $release  = '4.2dev (Build: 20230310)'; // Human-friendly version name