Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Site admin presets: Difference between revisions

From MoodleDocs
(Prototype site)
(→‎Introduction: rewording)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Infobox Project
{{Infobox Project
|state = In progress
|state = Completed
|name = Site admin presets
|name = Site admin presets
|tracker = MDL-72112
|tracker = MDL-72112
|discussion =  
|discussion = [https://moodle.org/mod/forum/discuss.php?d=429512 Site admin presets in Moodle 4.0]
|assignee = Pimenko, Sara Arjona and Amaia Anabitarte
|assignee = Pimenko, Sara Arjona and Amaia Anabitarte
}}
}}
{{Template:Moodle 4.0}}
{{Template:Moodle 4.0}}
==Introduction==
==Introduction==
As an admin
As an admin
Line 13: Line 12:
*So I can easily switch between different site admin configurations
*So I can easily switch between different site admin configurations


This feature is partially implemented by the third-party plugin [https://moodle.org/plugins/block_admin_presets Admin presets], created by David Monllaó and maintained by developers from [https://pimenko.com/ Pimenko]. The current version of the plugin lets admins import/export admin settings but, for the minimalist Moodle project, some extra information, such as the list of enabled/disable plugins, should be added too.
This feature is partially implemented by the third-party plugin [https://moodle.org/plugins/block_admin_presets Admin presets], created by David Monllaó and maintained by developers from [https://pimenko.com/ Pimenko]. The plugin lets admins import/export admin settings. This project adds enabled/disabled plugins data too.


This project is about adapting this third-plugin for getting it integrated into Moodle LMS. 
==Acceptance criteria==
==Acceptance criteria==
* The block should be converted to an admin tool.
* The block should be converted to an admin tool.
Line 25: Line 23:
* Moodle LMS should include, by default, 2 site admin presets, Starter and Full.
* Moodle LMS should include, by default, 2 site admin presets, Starter and Full.
** Starter will disable most of the settings and plugins in order to make it easier for users to find the most common features.
** Starter will disable most of the settings and plugins in order to make it easier for users to find the most common features.
** Full will include settings and plugins configuration as in Moodle 3.11.
** Full will include settings and plugins configuration as in Moodle 4.0
 
== Starter preset setting changes ==
== Starter setting changes ==
 
{| class="wikitable"
{| class="wikitable"
|+
|+
Line 39: Line 35:
|Users / Privacy and policies
|Users / Privacy and policies
|Disable Show data retention summary
|Disable Show data retention summary
|-
|Courses / Activity chooser / Activity chooser settings
|Set Activity chooser tabs to "Starred, All, Recommended"
|-
|-
|Plugins / Activity modules / Manage activities
|Plugins / Activity modules / Manage activities
Line 45: Line 44:
|Plugins / Activity modules / Forum
|Plugins / Activity modules / Forum
|Maximum number of attachments = 3
|Maximum number of attachments = 3
|-
|Plugins / Authentication / Manage authentication
|Hide Guest login button
|-
|-
|Plugins / Availability restrictions / Manage restrictions
|Plugins / Availability restrictions / Manage restrictions
Line 50: Line 52:
|-
|-
|Plugins / Activity modules / Manage blocks
|Plugins / Activity modules / Manage blocks
|Hide Activities, Blog menu, Blog tags, Comments, Course completion status, Course/site summary, Courses, Flickr, Global search, Latest badges, Learning plans, Logged in user, Login, Main menu, Mentees, Network servers, Private files, Recent blog entries, RSS feeds, Search forums, Section links, Self completion, Social activities, Tags, YouTube, Feedback
|Hide Activities, Blog menu, Blog tags, Comments, Course completion status, Courses, Flickr, Global search, Latest badges, Learning plans, Logged in user, Login, Main menu, Mentees, Network servers, Online users, Private files, Recent blog entries, Recently accessed courses, Search forums, Section links, Social activities, Starred courses, Tags, YouTube
 
 
Hidden by default since Moodle 4.0: Course/site summary, RSS feeds, Self completion, Feedback.
|-
|-
|Plugins / Course formats / Manage course formats
|Plugins / Course formats / Manage course formats
Line 59: Line 64:
|-
|-
|Plugins / Enrolments / Manage enrol plugins
|Plugins / Enrolments / Manage enrol plugins
|Disable Cohort sync
|Disable Cohort sync, Guest access
|-
|-
|Plugins / Filters / Manage filters
|Plugins / Filters / Manage filters
Line 68: Line 73:
|-
|-
|Plugins / Question types / Manage question types
|Plugins / Question types / Manage question types
|Disable Calculated, Calculated multichoice, Calculated simple, Description, Drag and drop into text, Drag and drop markers, Drag and drop onto image, Embedded answers (Cloze), Essay, Numerical, Random short-answer matching
|Disable Calculated, Calculated multichoice, Calculated simple, Drag and drop into text, Drag and drop markers, Drag and drop onto image, Embedded answers (Cloze), Numerical, Random short-answer matching
|-
|-
|Plugins / Repositories / Manage repositories
|Plugins / Repositories / Manage repositories
Line 75: Line 80:
|Plugins / Text editors / Manage editors
|Plugins / Text editors / Manage editors
|Disable TinyMCE HTML editor
|Disable TinyMCE HTML editor
|-
|Appearance / Themes / Theme settings
|Remove messages only from User menu items
|}
|}
== Migrating from block_admin_preset to tool_admin_preset ==
== Migrating from block_admin_preset to tool_admin_preset ==
There are no plans to create any migration tool or similar. However, the tool_admin_preset follows the same XML than the block_admin_preset so users can export their presets from the block_admin_preset and import them in the tool_admin_preset.
There are no plans to create any migration tool or similar. However, the tool_admin_preset follows the same XML than the block_admin_preset so users can export their presets from the block_admin_preset and import them in the tool_admin_preset.
==Defining the preset to be installed==
A $CFG setting in the config.php file allows you to specify the preset which will be installed during the install process (MDL-73145):<syntaxhighlight lang="php">
// The site admin presets plugin has been integrated in Moodle LMS. You can use a setting in case you
// want to apply a preset during the installation:
//
//      $CFG->setsitepresetduringinstall = 'starter';


==Prototype site==
</syntaxhighlight>
 
You can try site admin presets on our prototype site https://siteadminpresets.prototype.moodledemo.net/admin/tool/admin_presets/index.php

Latest revision as of 13:03, 26 March 2022

Site admin presets
Project state Completed
Tracker issue MDL-72112
Discussion Site admin presets in Moodle 4.0
Assignee Pimenko, Sara Arjona and Amaia Anabitarte

Moodle 4.0

Introduction

As an admin

  • I want to load administration presets
  • So I can easily switch between different site admin configurations

This feature is partially implemented by the third-party plugin Admin presets, created by David Monllaó and maintained by developers from Pimenko. The plugin lets admins import/export admin settings. This project adds enabled/disabled plugins data too.

Acceptance criteria

  • The block should be converted to an admin tool.
    • A link "Site admin presets" (pointing to 3rd-party plugin main page) should be displayed in the Site administration.
  • The admin tool should follow the Moodle coding style and policy rules.
  • The “Auto exclude sensitive settings” setting should be checked by default.
    • The tool_admin_presets setting should be reviewed to confirm it includes all the sensitive settings that have been added recently.
  • Presets should also include plugins visibility in order to let admins export/preview/load the list of plugins and their visibility (the original third-party plugin only includes settings).
  • Moodle LMS should include, by default, 2 site admin presets, Starter and Full.
    • Starter will disable most of the settings and plugins in order to make it easier for users to find the most common features.
    • Full will include settings and plugins configuration as in Moodle 4.0

Starter preset setting changes

Site administration Action
Advanced features Disable comments, tags, notes, blogs, badges, analytics, competencies
Users / Privacy and policies Disable Show data retention summary
Courses / Activity chooser / Activity chooser settings Set Activity chooser tabs to "Starred, All, Recommended"
Plugins / Activity modules / Manage activities Hide chat, database, external tool, IMS content package, lesson, SCORM, survey, wiki, workshop
Plugins / Activity modules / Forum Maximum number of attachments = 3
Plugins / Authentication / Manage authentication Hide Guest login button
Plugins / Availability restrictions / Manage restrictions Hide Grouping, User profile
Plugins / Activity modules / Manage blocks Hide Activities, Blog menu, Blog tags, Comments, Course completion status, Courses, Flickr, Global search, Latest badges, Learning plans, Logged in user, Login, Main menu, Mentees, Network servers, Online users, Private files, Recent blog entries, Recently accessed courses, Search forums, Section links, Social activities, Starred courses, Tags, YouTube


Hidden by default since Moodle 4.0: Course/site summary, RSS feeds, Self completion, Feedback.

Plugins / Course formats / Manage course formats Disable Social format
Plugins / Data formats / Manage data formats Disable Javascript Object Notation (.json)
Plugins / Enrolments / Manage enrol plugins Disable Cohort sync, Guest access
Plugins / Filters / Manage filters Disable MathJax, Activity names auto-linking
Plugins / Question behaviours / Manage question behaviours Disable Adaptive mode (no penalties), Deferred feedback with CBM, Immediate feedback with CBM
Plugins / Question types / Manage question types Disable Calculated, Calculated multichoice, Calculated simple, Drag and drop into text, Drag and drop markers, Drag and drop onto image, Embedded answers (Cloze), Numerical, Random short-answer matching
Plugins / Repositories / Manage repositories Disable Server files, URL downloader, Wikimedia
Plugins / Text editors / Manage editors Disable TinyMCE HTML editor

Migrating from block_admin_preset to tool_admin_preset

There are no plans to create any migration tool or similar. However, the tool_admin_preset follows the same XML than the block_admin_preset so users can export their presets from the block_admin_preset and import them in the tool_admin_preset.

Defining the preset to be installed

A $CFG setting in the config.php file allows you to specify the preset which will be installed during the install process (MDL-73145):

// The site admin presets plugin has been integrated in Moodle LMS. You can use a setting in case you
// want to apply a preset during the installation:
//
//      $CFG->setsitepresetduringinstall = 'starter';