From 8fd188af3a3882f38f1e09ffc73a88065f1295a0 Mon Sep 17 00:00:00 2001
From: PMKuipers
Date: Mon, 3 Jul 2023 23:28:46 +0200
Subject: [PATCH] Finished documentation
---
doc/advanced.htm | 2 +-
doc/configuration.htm | 96 ++++++++++++++++++++++++++++++++++++++++++-
settings.php | 10 +----
3 files changed, 97 insertions(+), 11 deletions(-)
diff --git a/doc/advanced.htm b/doc/advanced.htm
index 0ad0888..1ee33c8 100644
--- a/doc/advanced.htm
+++ b/doc/advanced.htm
@@ -47,7 +47,7 @@
Under Course display name you can select if you want to use shortname, ID field or any other previously configured custom course field
- NOTE:
The information in this category is mostly applicable to manual aggregation methods for study plans.
If Moodle course completion is used, it is especially important to always configure grade to pass
diff --git a/doc/configuration.htm b/doc/configuration.htm
index 232e532..90902db 100644
--- a/doc/configuration.htm
+++ b/doc/configuration.htm
@@ -8,8 +8,102 @@
Advanced topics
Configuration
-
About studyplan
+
Overview of configuration parameters
+
Studyplan settings
+
Basic configuration options for the studyplan plug-in
+
+ - Default aggregation style
+ Select which aggregation style is selected by default upon creation of a new study plan. Setting this according to your preferences, will save you a
+ few clicks when creating a lot of new study plans.
+
+ - Course display name
+ Select which course field is used as a short course name in the studyplan overview. You can choose between shortname, ID and
+ any custom course field that you already have configured. It is recommended to create a custom course field specifically for the display name in
+ the studyplan, and put the appropriate text there.
+ Shortname is often not useful in the studyplan (especially on larger sites), since it requires prefixes/suffixes to ensure unique names.
+
+ - Defaults for (Manual) Completed + Required goals
+ Here you can enter the default values that will be used for new studyplans using the Manual: Completed + Required goals aggregation method.
+ These values can be changed upon creation of a new study plan, but it may save you some time when creating new study plans
+ If you only use the Moodle Course completion method, you can safely ignore these parameters.
+
+
+
Manage study plans
+
This option is a direct link to the manage studyplans page. It may be useful for administrators.
+
+
Studyplan cohort sync
+
Here you can configure automatic cohort syncing. This syncronizes the cohorts and students linked with a study plan to enrolment
+ within the courses in the study plan
+
Cohort syncing is done by creating a cohort sync enrolment method in each course, while students are synced by adding a manual enrolment
+
+ - Automatic Cohort sync
+ Enable automatic cohort sync here. If enabled, a background process will automatically perform a synchronization each time a cohort is added or removed,
+ and each time a course is added.
+
+ - Automatic deletion
+ Toggle this to allow or prevent cohort sync enrolments that were created by the studyplan plug-in, when there are no longer any study plans requiring That
+ cohort to be enrolled. Note that individual student enrolments are never automatically deleted.
+
+ - Remember existing cohort syncs
+ Since there can only be one cohort-sync enrolment for each combination of course and cohort, existing cohort-sync enrolments are marked with the studyplans
+ involved when a studyplan wants them as well. By checking this item, such existing cohort syncs are marked as manual, so they will not be automatically removed
+ when no study plans require them anymore
+
+ - Create groups
+ If enabled, a group is made in each course for all new cohort-sync enrolments created by the studyplan plugin. These groups contain all students in this specific
+ cohort.
+
+ - Enrol linked users
+ You can choose to include linked users in the synchronization or not. Default is yes, since it would be unexpected behaviour if cohorts were automatically synced,
+ but users were not.
+
+ - Role
+ Choose the role that will be given in a course to all cohorts and users automatically synced based on their association in a study plan. Usually you want this to be a student role.
+
+
+
+
Configure grade & scale interpretation
+
See the Advanced / Grade & Scale interpretation section for more details on this configuration page
+
+
+
Theming guide
+
A number of colors in the studyplan plugin are based on the colors you define in your theme for
+ primary (brand color),
+ secondary,
+ success,
+ info,
+ warning and
+ danger
+
+
You may be able to define them in your theme's configuration. If not, follow the instructions below for tweaking other colors
+ and use the following code as a starting point. (The values are the default boost theme colors)
+
+:root {
+ --primary: #023C78;
+ --secondary: #6c757d;
+ --success: #28a745;
+ --info: #17a2b8;
+ --warning: #ffc107;
+ --danger: #dc3545;
+ --light: #f8f9fa;
+ --dark: #343a40;
+ }
+
+
Tweaking other colors
+
Other variables that are used are color variables provided in bootstrap. To tweak them, use the Advanced settings -> Raw SCSS configuration
+ option in your theme's configuration.
+
Fore example, in the Boost theme the option is found in Appearance -> (Themes) -> Boost -> Advanced settings -> Raw SCSS
+
There, use code like the following to change the color variables. (Note that those colors will be changed throughout the site.)
+
+:root {
+ --blue: #007bff;
+ --indigo: #6610f2;
+ --purple: #6f42c1;
+ --red: #dc3545;
+ --green: #28a745;
+ --gray: #6c757d;
+ }
\ No newline at end of file
diff --git a/settings.php b/settings.php
index 687a4a6..36adc80 100644
--- a/settings.php
+++ b/settings.php
@@ -57,7 +57,7 @@ if ($hassiteconfig) {
$page->add(new admin_setting_configselect('local_treestudyplan/aggregation_mode',
get_string('setting_aggregation_mode', 'local_treestudyplan'),
get_string('settingdesc_aggregation_mode', 'local_treestudyplan'),
- "bistate",
+ "core",
$aggregators
));
@@ -113,20 +113,12 @@ if ($hassiteconfig) {
PARAM_INT
));
-
$page->add(new admin_setting_configcheckbox('local_treestudyplan/bistate_support_failed',
get_string('setting_bistate_support_failed', 'local_treestudyplan'),
get_string('settingdesc_bistate_support_failed', 'local_treestudyplan'),
True,
));
- $page->add(new admin_setting_configtext('local_treestudyplan/bistate_thresh_progress',
- get_string('setting_bistate_thresh_progress', 'local_treestudyplan'),
- get_string('settingdesc_bistate_thresh_progress', 'local_treestudyplan'),
- "33",
- PARAM_INT
- ));
-
$page->add(new admin_setting_configcheckbox('local_treestudyplan/bistate_accept_pending_submitted',
get_string('setting_bistate_accept_pending_submitted', 'local_treestudyplan'),
get_string('settingdesc_bistate_accept_pending_submitted', 'local_treestudyplan'),