Documentation update

This commit is contained in:
PMKuipers 2023-07-02 16:34:49 +02:00
parent 95a92fc9f1
commit 18d81b8dea
14 changed files with 282 additions and 121 deletions

View file

@ -47,7 +47,7 @@ if($_POST["action"] == "update"){
} }
} }
} }
if(needupdate){ if($needupdate){
$DB->update_record(GRADECFG_TABLE,$scalecfg); $DB->update_record(GRADECFG_TABLE,$scalecfg);
} }
@ -168,7 +168,7 @@ foreach($scales as $scale)
$row = []; $row = [];
$row[] = $scale->name; $row[] = $scale->name;
$row[] = html_writer::tag("select", $options_progress, ['name' => "s_{$scale->id}_min_progress",'autocomplete' => 'off']) ; //$row[] = html_writer::tag("select", $options_progress, ['name' => "s_{$scale->id}_min_progress",'autocomplete' => 'off']) ;
$row[] = html_writer::tag("select", $options_completed, ['name' => "s_{$scale->id}_min_completed",'autocomplete' => 'off']) ; $row[] = html_writer::tag("select", $options_completed, ['name' => "s_{$scale->id}_min_completed",'autocomplete' => 'off']) ;
$data[] = $row; $data[] = $row;
} }
@ -185,7 +185,7 @@ $table->summary = '';//get_string('uploadtimetable_preview', 'local_chronotable'
$table->head = []; $table->head = [];
$table->data = $data; $table->data = $data;
$table->head[] = get_string('scale'); $table->head[] = get_string('scale');
$table->head[] = get_string('min_progress', 'local_treestudyplan'); //$table->head[] = get_string('min_progress', 'local_treestudyplan');
$table->head[] = get_string('min_completed', 'local_treestudyplan'); $table->head[] = get_string('min_completed', 'local_treestudyplan');
print $OUTPUT->heading(get_string('cfg_grades_desc_head', 'local_treestudyplan')); print $OUTPUT->heading(get_string('cfg_grades_desc_head', 'local_treestudyplan'));
@ -197,7 +197,7 @@ $data = [];
foreach($grade_cfgs as $g){ foreach($grade_cfgs as $g){
$row = []; $row = [];
$row[] = $g->grade_points; $row[] = $g->grade_points;
$row[] = html_writer::tag("input", null, ['name' => "g_{$g->grade_points}_min_progress", 'value' => "{$g->min_progress}", 'type' => 'text', "class" => "float", 'autocomplete' => 'off']) ; // $row[] = html_writer::tag("input", null, ['name' => "g_{$g->grade_points}_min_progress", 'value' => "{$g->min_progress}", 'type' => 'text', "class" => "float", 'autocomplete' => 'off']) ;
$row[] = html_writer::tag("input", null, ['name' => "g_{$g->grade_points}_min_completed", 'value' => "{$g->min_completed}", 'type' => 'text', "class" => "float", 'autocomplete' => 'off']) ; $row[] = html_writer::tag("input", null, ['name' => "g_{$g->grade_points}_min_completed", 'value' => "{$g->min_completed}", 'type' => 'text', "class" => "float", 'autocomplete' => 'off']) ;
$row[] = html_writer::tag("input", null, ['name' => "g_{$g->grade_points}_delete", 'type' => 'checkbox', ]) ; $row[] = html_writer::tag("input", null, ['name' => "g_{$g->grade_points}_delete", 'type' => 'checkbox', ]) ;
$data[] = $row; $data[] = $row;
@ -205,7 +205,7 @@ foreach($grade_cfgs as $g){
$row = []; $row = [];
$row[] = html_writer::tag("input", null, ['name' => "g_new_gradepoints", 'value' => '', 'type' => 'number', 'min' => '0', 'pattern' => '/d+', 'step' => '1', 'autocomplete' => 'off']); $row[] = html_writer::tag("input", null, ['name' => "g_new_gradepoints", 'value' => '', 'type' => 'number', 'min' => '0', 'pattern' => '/d+', 'step' => '1', 'autocomplete' => 'off']);
$row[] = html_writer::tag("input", null, ['name' => "g_new_min_progress", 'value' => '', 'type' => 'text', "class" => "float", 'autocomplete' => 'off']) ; //$row[] = html_writer::tag("input", null, ['name' => "g_new_min_progress", 'value' => '', 'type' => 'text', "class" => "float", 'autocomplete' => 'off']) ;
$row[] = html_writer::tag("input", null, ['name' => "g_new_min_completed", 'value' => '', 'type' => 'text',"class" => "float", 'autocomplete' => 'off']) ; $row[] = html_writer::tag("input", null, ['name' => "g_new_min_completed", 'value' => '', 'type' => 'text',"class" => "float", 'autocomplete' => 'off']) ;
$data[] = $row; $data[] = $row;
@ -219,7 +219,7 @@ $table->summary = '';//get_string('uploadtimetable_preview', 'local_chronotable'
$table->head = []; $table->head = [];
$table->data = $data; $table->data = $data;
$table->head[] = get_string('grade_points', 'local_treestudyplan'); $table->head[] = get_string('grade_points', 'local_treestudyplan');
$table->head[] = get_string('min_progress', 'local_treestudyplan'); //$table->head[] = get_string('min_progress', 'local_treestudyplan');
$table->head[] = get_string('min_completed', 'local_treestudyplan'); $table->head[] = get_string('min_completed', 'local_treestudyplan');
$table->head[] = get_string('delete',); $table->head[] = get_string('delete',);

66
doc/advanced.htm Normal file
View file

@ -0,0 +1,66 @@
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
<li class="nav-item"><a class="nav-link " href="index.htm">Main</a></li>
<li class="nav-item"><a class="nav-link " href="create-studyplan.htm">Creating a study plan</a></li>
<li class="nav-item"><a class="nav-link " href="view-studyplan.htm">Viewing a studyplan - for students</a></li>
<li class="nav-item"><a class="nav-link " href="teacherview-studyplan.htm">Viewing a studyplan - for teachers</a></li>
<li class="nav-item"><a class="nav-link active" href="advanced.htm">Advanced topics</a></li>
<li class="nav-item"><a class="nav-link " href="configuration.htm">Configuration</a></li>
</ul>
<h2>Advanced studyplan editing features</h2>
<p>The studyplan editor has a number of advanced features that are available under the
<span class="text-danger" role="button"><i class="fa fa-cog"></i>Advanced</span> link. (Top-right on the screen in the editor view</p>
<p>These features are helpful to the administrator, but can be dangerous if abused.</p>
<h3>Course manipulation</h3>
<p><b>Cascade cohort sync</b> can be used to manually enrol cohorts and users linked to the study plan into the courses that are in the studyplan.
If you do not have automatic cascading enabled, you must use this button to do it manually</p>
<p>It will create a cohort-sync enrolment to all courses in the studyplan for each cohort you have linked here.
It can also automatically remove those enrolments when a cohort is unlinked from a studyplan.</br>
Individually linked students can also be cascaded down to the courses (if the feature is enabled). In those cases a manual enrolment is created for the users
in each of the studyplan's courses. Those enrolments will never be automatically removed, since that might deprive a student of study content.
</p>
<p><b>Force scales</b> Only useful in <i>Manual</i> aggregation mode. In those cases you may want to enforce a specific scale to all selected gradables in
the studyplan. This can save time manually updating all the gradables used in the studyplan to a standerdized grade scale. This tool allows you to do so.</p>
<p></p>
<h3>Backup and restore</h3>
<p>Using the <b>Backup studyplan</b> you can backup an entire studyplan into a .json file.</p>
<p></p>
<p>Use <b>restore studylines from backup</b> to import the content (study lines and courses) from a studyplan into the current study plan</p>
<div class="generalbox alert alert-success"><b>PRO TIP:</b><br>
<p>If you are proficient in editing json like data structures, you can manually edit the .json backups and then restore them as new courses.</p>
<p>This is mostly useful if you need to create multiple study plans with only minor changes, or predictable changes
(like changing some text in course short names to link to new versions of courses)</p>
</div>
<h3>Deleting a studyplan</h3>
<p>Sometimes you want to delete an entire study plan. This can be done using the button found in the <b>delete</b> tab</p>
<h2>Setting a simple name for the courses</h2>
<p>By default, the short name of the course will be displayed in the study plan. However, often this name is quite long and has some
prefixes or suffixes to distinguish it from other courses that were given in earlier academic years. If you want to display a simpler name,
you can op to do so in two ways:</p>
<ol>
<li>Display the courses <b>id</b> number</li>
<li>Display a <b>custom course field</b></li>
</ol>
<p>Go to <b>Site administration</b> -> <b>Courses</b> -> <b>Studyplans</b> -> <b>Studyplan settings</b><br>
Under <b>Course display name</b> you can select if you want to use <i>shortname</i>, <i>ID field</i> or any other previously configured custom field</p>
</p>
<h2>Grade & Scale interpretation</h2>
<div class="generalbox alert alert-info"><b>NOTE:</b><br>
<p>The information in this category is mostly applicable to <i>manual</i> aggregation methods for study plans.
If <i>Moodle course completion</i> is used, it is especially important to always configure <b>grade to pass</b></p>
<p>Note that future versions may use this feature to automatically repair missing <b>grade to pass</b> in gradable activities.</p>
</div>
<p>Best practice is to set a <b>grade to pass</b> in all gradable activities in the studyplan. This way the entire system will know
if a gradable activity wass passed or failed.</p>
<p>But since teachers are all human, this may occasionally (or regularly) be forgotten. In the absence of a configured <b>grade to pass</b>,
the studyplan system will use the values configured here to determine if a grade was a passable grade.</p>
<p>Go to <b>Site administration</b> -> <b>Courses</b> -> <b>Studyplans</b> -> <b>Configure grade &amp; scale interpretation</b> to configure it.</p>
<p>Each scale will need to have a <b>completion threshold</b> set. This is the scale value that starts a passing grade.</p>
<p>You can also configure certain <b>maximum grade points</b> to have a default passing value (<b>completion threshold</b>)</p>
<p>While scales are automatically added and cannot be removed, you can remove previously configured <i>maximum grade points</i>.
To do so, check the <b>delete</b> mark next to it, and press <b>save</b> </p>
</div>

15
doc/configuration.htm Normal file
View file

@ -0,0 +1,15 @@
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
<li class="nav-item"><a class="nav-link " href="index.htm">Main</a></li>
<li class="nav-item"><a class="nav-link " href="create-studyplan.htm">Creating a study plan</a></li>
<li class="nav-item"><a class="nav-link " href="view-studyplan.htm">Viewing a studyplan - for students</a></li>
<li class="nav-item"><a class="nav-link " href="teacherview-studyplan.htm">Viewing a studyplan - for teachers</a></li>
<li class="nav-item"><a class="nav-link " href="advanced.htm">Advanced topics</a></li>
<li class="nav-item"><a class="nav-link active" href="configuration.htm">Configuration</a></li>
</ul>
<h2>About studyplan</h2>
</div>

153
doc/create-studyplan.htm Normal file
View file

@ -0,0 +1,153 @@
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
<li class="nav-item"><a class="nav-link " href="index.htm">Main</a></li>
<li class="nav-item"><a class="nav-link active" href="create-studyplan.htm">Creating a study plan</a></li>
<li class="nav-item"><a class="nav-link " href="view-studyplan.htm">Viewing a studyplan - for students</a></li>
<li class="nav-item"><a class="nav-link " href="teacherview-studyplan.htm">Viewing a studyplan - for teachers</a></li>
<li class="nav-item"><a class="nav-link " href="advanced.htm">Advanced topics</a></li>
<li class="nav-item"><a class="nav-link " href="configuration.htm">Configuration</a></li>
</ul>
<h2>Creating and managing a study plan</h2>
<p>To create a studyplan, go to <b>Site administration</b> -> <b>Courses</b> -> <b>Studyplans</b> -> <b>Manage Studyplans</b></p>
<p>You will now see a screen like the following</p>
<p><img src="img/Createstudyplan.png" class="border border-primary rounded-lg ml-3"></p>
<p>If you do not yet have an exported studyplan to import, pick <b>Add study plan</b> to create a new study plan</p>
<p>You are now asked to provide details for this new studyplan</p>
<p><img src="img/Newstudyplanscreen.png" class="border border-primary rounded-lg ml-3"></p>
<p>The screen allows you to specify the <b>full name</b>, <b>code</b> or short name and <b>description</b> for this specific plan</p>
<p>You can also choose the category <b>context</b> in which to place this study plan. This is useful to manage access rights in a large moodle installation</p>
<p>The next options give more information about the timing of the plan. The <b>number of slots</b> to place courses in the plan can be specified.
This is usually used to show the different periods in the academic year. You can expect this to become more explicit in upcoming versions of the plugin.
The <b>start date</b> and <b>end date</b> of the plan help to show students and teachers which plans are current, and which were finished in the past.
They will default to start on august 1 of this year and continue until august 1 of next year, since that matches most academic years.</p>
<p>Finally we have the <b>aggregation style</b>, which is ised to determine how the courses show grades. There are a number of options available:</p>
<ul>
<li><b>Moodle course completion</b> <i>This is the recommended method to use.</i> All the conditions selected in the moodle course completion will be shown in the progress list.</li>
<li><b>Manual: Completed + required goals</b>Manually select a number of gradable activities from the course, which will be used to determine grade. Extra options for this method</li>
<li><b>Manual: Progress/Completed/Excellent classic</b> <i>Deprecated! Do not use!</i> This is an old and convoluted method that is only in here for compatibility reasons</li>
</ul>
<h3>Details for Manual: Completed + required goals</h3>
<p>
With this aggregation method you manually select which grade items are used in the progress report. The design intent is to prepare a number of gradable items,
and describe the learning objectives for each course and use these to indicate completion. While any grade will be properly shown, it makes most sense to use a scale which indicates
if the student has either met the objective or not. The teacher or studyplan editor can also mark certain gradables/objectives as required or compulsory.
</p>
<p>The final outcome for the courses will then be determined based on the percentage of met objectives, provided that all required/compulsory objectives are met</p>
<p><img src="img/Newstudyplanscreen.png" class="border border-primary rounded-lg ml-3"></p>
<p>The added options allow you to set the <b>threshold</b> percentage of completed objectives in each course to determine the outcome as <i>excellent</i>, <i>good</i>
or <i>completed</i>. If an objective is not met it will be marked as either "progress" (meaning that the student's work needs to be improved) or
"incomplete" (meaning that the student has not started working on this goal yet) </p>
<p>When <i>failed</i> results are enabled, any "progress" will be marked as "failed" when the course end date has passed</p>
<p>Finally, you can opt to have an object ive </p>
<a id="studylines"><h2>Setting up studylines</h2></a>
<p>Before you can add courses to the studyplan, you have to define <i>study lines</i>. You use them to group together courses in logical categories.
Most likely these are categories or themes within your curriculum.</p>
<p>For performance reasons, study lines can only be edited when in <i>study line edit mode</i>. The courses and flow between them will be hidden,
so the lines can be reshuffled and edited. You can toggle studyline edit mode with the toggle switch <i>edit stydy lines</i></p>
<p><img src="img/AddStudylines-overview.png" class="border border-primary rounded-lg ml-3"></p>
<p>Using the <b>Add study line</b> link, you can add a new studyline. You will then get a new window where you can enter details and select a handle color for this line</p>
<p><img src="img/AddStudyline-modal.png" class="border border-primary rounded-lg ml-3"></p>
<p>Here you can enter a <b>full name</b> for the study line that will be shown when you hover over the name, and a <b>code</b> that is a short name which will be shown
in front of the study line. Often this can be a short code. The <b>color</b> you pick will be shown in a little tab in front of the study line.</p>
<p>You can <i>drag</i> study lines to re-order them after you place them using the <i class="fa fa-arrows"></i> crosshair arrows</p>
<p>Using the <i class="fa fa-pencil"></i> and <i class="fa fa-trash"></i> symbols you can edit and delete the studyline (only empty studylines can be deleted)</p>
<p><img src="img/Studylines-view.png" class="border border-primary rounded-lg ml-3"></p>
<div class="generalbox alert alert-success"><b>TIP:</b><br>
If you have many studyplans using the same study line make-up you can export the first studyplan after you set up the study lines, and then import it on the next
study plans.<br>(Use <b>Advanced</b> -> <b>Backup studyplan</b> to find the <i>backup</i> and <i>restore</i> features)</div>
<a id="studycourses"><h2>Adding courses</h2></a>
<p>To add courses, you need to exit <i>study line edit mode</i> and open the toolbox using the <button class="btn btn-primary">Open toolbox</button> button.
The toolbox will now open on the right of the screen. (Using the toggle button on top, you can also switch it to the left of the screen if needed)</p>
<p><img src="img/Toolbox-Courses.png" class="border border-primary rounded-lg ml-3"></p>
<p>The toolbox shows you all the categories you have access to and the courses in them. Simply drag the course you want to include from the toolbox and
drop it in one of the slots in the studyplan that now appear.</p>
<p><img src="img/Toolbox-dragcourse.png" class="border border-primary rounded-lg ml-3"></p>
<p>To re-arrange the courses in the study plan, simply drag and drop them from the places they are now in.</p>
<p><img src="img/Studyitem-dragdelete.png" class="border border-primary rounded-lg ml-3"></p>
<p>To remove a course from the study plan, simply drag it to the red garbage bin that appears on dragging</p>
<a id="studycourses"><h2>Configuring courses</h2></a>
<p>Once a course is added to the studyplan, an icon shows if it needs to be configured (<i class='fa fa-exclamation-circle text-warning'></i>) or
is already configured (<i class='fa fa-check text-success'></i>).</p>
<p>By clicking on the course title (it's shortname, or a configured custom field), you can view the details, and configure it where applicable.
The configuration is dependent on the aggregation method for the study plan:</p>
<h3>Moodle course completion</h3>
<p>When using moodle course completion as a base, all configuration is done in the <i>course's completion settings</i>.
The course details show a <i class='fa fa-gear primary'></i> gear icon in the title, which takes you directly to the course completion configuration.
Once it is configured, the course details will show you exactly how the course completion is configured</p>
<p><img src="img/Course-config-corecompletion.png" class="border border-primary rounded-lg ml-3"></p>
<h3>Manual: Completed + required goals</h3>
<p> In this mode, the course details show you all the gradable activities in the course. You need to select which of them will be used to determine progress
and will be shown to the students and teachers in the studyplan view. You can also mark gradables ad <i>required</i>. Gradable activities marked as
such will all need to be completed for the course to be marked as completed, regardless of the minimum percentage configured</p>
<p><img src="img/Course-config-bistate.png" class="border border-primary rounded-lg ml-3"></p>
<a id="studybadges"><h2>Adding badges</h2></a>
<p>The toolbox also shows you the site-wide badges that are available for students. These can be dragged into the slots around and between the courses.</p>
<p>When you click on the <i class="fa fa-gear"></i> icon in the badge it shows you additional information about the badge</p>
<p><img src="img/Toolbox-badges.png" class="border border-primary rounded-lg ml-3"></p>
<a id="flow"><h2>Drawing the flow</h2></a>
<p>You can draw arrows between the courses and add flow indicators to show students how different courses are related in the studyplan</p>
<div class="generalbox alert alert-success"><b>TIP:</b><br>
While there are many possible relations between courses, it is best to limit the arrows to the most obvious relations. The studyplan can
easily become too crowded to give a good overview. Use <i>junctions</i> to combine multiple arrows into one if you do need to show the relation
from many courses to a few.</div>
<h3>Drawing arrows</h3>
<p> You can draw arrows by dragging them from one course or flow indicator to another. Look for the green square on the right of the item.
Then click and hold to drag the arrow. Once you do, a red square will appear on all the items that the arrow can end on. Drop the end of the arrow
on one of those red squares to complete the arrow.
</p>
<p><img src="img/Arrows-drag.png" class="border border-primary rounded-lg ml-3"></p>
<h3>Removing arrows</h3>
<p> To remove an arrow, click on the green square where the arrow starts. A red <i class='fa fa-trash text-danger'></i> trash can icon will appear for
each line that starts there. Hover over the trash can icons to find the line you want to remove. The arrow for each trash can icon will be highlighted in red
once you hover over it with your cursor. Once you find the arrow you want to remove, click the trash icon.</p>
<p> To close the trash icon menu without removing an arrow, click the green square (now red) again.</p>
<p><img src="img/Arrows-delete.png" class="border border-primary rounded-lg ml-3"></p>
<h3>Adding flow indicators</h3>
<p> You can add the following flow indicators:</p>
<ul>
<li><b>Junction</b> Used to combine the results of multiple arrows. The color and resulting arrow will be based on the combination of the incoming arrows</li>
<li><b>Finish</b> Used to indicate the end of a study line. It's color is based on the combination of the incoming arrows, just like the junction </li>
<li><b>Start/continue</b> These indicators are always green and can be used to indicate the start of a series of courses</li>
</ul>
<p><img src="img/Toolbox-flow.png" class="border border-primary rounded-lg ml-3"></p>
<p> By clicking on the <i class="fa fa-gear"></i> icon in the junction and finish indicators, you can select how the incoming arrows will be combined.
The indicated numer of arrows need to be completed in order to show the indicator as completed</p>
<ul>
<li><b>All entries</b></li>
<li><b>2/3 of entries</b></li>
<li><b>Half of entries</b></li>
<li><b>All entries</b></li>
</ul>
<div class="generalbox alert alert-info"><b>NOTE:</b><br>
Using the <i>Manual</i> aggregation method, these conditions are also used to determine whether a junction or finish will be shown as <i>good</i> or <i>excellent</i>
In those cases, at least the specified number of arrows need to be <i>good</i> or <i>excellent</i> in order to color the indicator as such.</div>
<h2>Associating students with a studyplan</h2>
<p>You can associate users with the studyplan in two ways: <b>Individually</b> or by <b>cohort</b></p>
<p>The recommended way is association by cohort, since that allows to dynamically allocate users to courses and studyplans by allocatong them to cohorts.
Assigning students to a studyplan individually is only useful in some fringe cases.
</p>
<p>To edit associations, click on the <span class="text-primary"><i class="fa fa-users"></i> associations</span> link in the studyplan,
or click on the <i class="fa fa-users text-primary"></i> icon in the studyplan overview.</p>
<p>You will now get the association window</p>
<p><img src="img/Cohort-link.png" class="border border-primary rounded-lg ml-3"></p>
<p>In this window, type the first few letters of the <i>cohort</i>i> you want to link into the search bar. The matching cohorts will now be shown.</p>
<p>Click <button type="button" class="btn btn-success"><i class="fa fa-link"></i>&nbsp;Add</button> to add the cohort to the studyplan</p>
<p>To remove a cohort from the studyplan, select it from the left list, and click <button type="button" class="btn btn-danger"><i class="fa fa-chain-broken"></i>&nbsp;Delete</button>
</p>
<p>In order to link <i>individual students</i>, click <i>students</i> and follow the same procedure as lined out above for cohorts.</p>
<div class="generalbox alert alert-warning"><b>IMPORTANT:</b><br>
<p>If you have cascading cohort sync enabled (see configuration), the system will automatically create a cohort-sync enrolment to all courses in the studyplan
for each cohort you have linked here. It can also automatically remove those enrolments when a cohort is unlinked from a studyplan.
</p>
<p>Individually linked students can also be cascaded down to the courses (if the feature is enabled). In those cases a manual enrolment is created for the users
in each of the studyplan's courses. Those enrolments will never be automatically removed, since that might deprive a student of study content.
</p>
</div>
</div>

BIN
doc/img/Arrows-delete.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

BIN
doc/img/Arrows-drag.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 8 KiB

BIN
doc/img/Cohort-link.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 91 KiB

View file

@ -1,10 +1,12 @@
<div> <div>
<h1> Studyplan user manual</h1> <h1> Studyplan user manual</h1>
<ul class=""> <ul class="nav nav-tabs">
<li><a href="#about">About studyplan</a></li> <li class="nav-item"><a class="nav-link active" href="index.htm">Main</a></li>
<li><a href="#postinstall">Post installation config</a></li> <li class="nav-item"><a class="nav-link " href="create-studyplan.htm">Creating a study plan</a></li>
<li><a href="#setup">Configuration</a></li> <li class="nav-item"><a class="nav-link " href="view-studyplan.htm">Viewing a studyplan - for students</a></li>
<li><a href="#createstudyplan">Creating a study plan></a></li> <li class="nav-item"><a class="nav-link " href="teacherview-studyplan.htm">Viewing a studyplan - for teachers</a></li>
<li class="nav-item"><a class="nav-link " href="advanced.htm">Advanced topics</a></li>
<li class="nav-item"><a class="nav-link " href="configuration.htm">Configuration</a></li>
</ul> </ul>
<a id="#about"><h2>About studyplan</h2></a> <a id="#about"><h2>About studyplan</h2></a>
<p>The studyplan plugin extends Moodle with the ability to show students and teachers an overview of their curriculum and results therein</p> <p>The studyplan plugin extends Moodle with the ability to show students and teachers an overview of their curriculum and results therein</p>
@ -32,111 +34,5 @@ Manage Study plans|/local/treestudyplan/edit-plan.php||en
After installing the plugin you can find the main configuration in <b>Site administration</b> -> <b>Courses</b> -> <b>Studyplans</b> After installing the plugin you can find the main configuration in <b>Site administration</b> -> <b>Courses</b> -> <b>Studyplans</b>
<br> <br>
<img src="img/Siteconfig.png" class="border border-primary rounded-lg ml-3"> <img src="img/Siteconfig.png" class="border border-primary rounded-lg ml-3">
<a id="createstudyplan"><h2>Creating a study plan</h2></a>
<p>To create a studyplan, go to <b>Site administration</b> -> <b>Courses</b> -> <b>Studyplans</b> -> <b>Manage Studyplans</b></p>
<p>You will now see a screen like the following</p>
<p><img src="img/Createstudyplan.png" class="border border-primary rounded-lg ml-3"></p>
<p>If you do not yet have an exported studyplan to import, pick <b>Add study plan</b> to create a new study plan</p>
<p>You are now asked to provide details for this new studyplan</p>
<p><img src="img/Newstudyplanscreen.png" class="border border-primary rounded-lg ml-3"></p>
<p>The screen allows you to specify the <b>full name</b>, <b>code</b> or short name and <b>description</b> for this specific plan</p>
<p>You can also choose the category <b>context</b> in which to place this study plan. This is useful to manage access rights in a large moodle installation</p>
<p>The next options give more information about the timing of the plan. The <b>number of slots</b> to place courses in the plan can be specified.
This is usually used to show the different periods in the academic year. You can expect this to become more explicit in upcoming versions of the plugin.
The <b>start date</b> and <b>end date</b> of the plan help to show students and teachers which plans are current, and which were finished in the past.
They will default to start on august 1 of this year and continue until august 1 of next year, since that matches most academic years.</p>
<p>Finally we have the <b>aggregation style</b>, which is ised to determine how the courses show grades. There are a number of options available:</p>
<ul>
<li><b>Moodle course completion</b> <i>This is the recommended method to use.</i> All the conditions selected in the moodle course completion will be shown in the progress list.</li>
<li><b>Manual: Completed + required goals</b>Manually select a number of gradable activities from the course, which will be used to determine grade. Extra options for this method</li>
<li><b>Manual: Progress/Completed/Excellent classic</b> <i>Deprecated! Do not use!</i> This is an old and convoluted method that is only in here for compatibility reasons</li>
</ul>
<h3>Details for Manual: Completed + required goals</h3>
<p>
With this aggregation method you manually select which grade items are used in the progress report. The design intent is to prepare a number of gradable items,
and describe the learning objectives for each course and use these to indicate completion. While any grade will be properly shown, it makes most sense to use a scale which indicates
if the student has either met the objective or not. The teacher or studyplan editor can also mark certain gradables/objectives as required or compulsory.
</p>
<p>The final outcome for the courses will then be determined based on the percentage of met objectives, provided that all required/compulsory objectives are met</p>
<p><img src="img/Newstudyplanscreen.png" class="border border-primary rounded-lg ml-3"></p>
<p>The added options allow you to set the <b>threshold</b> percentage of completed objectives in each course to determine the outcome as <i>excellent</i>, <i>good</i>
or <i>completed</i>. If an objective is not met it will be marked as either "progress" (meaning that the student's work needs to be improved) or
"incomplete" (meaning that the student has not started working on this goal yet) </p>
<p>When <i>failed</i> results are enabled, any "progress" will be marked as "failed" when the course end date has passed</p>
<p>Finally, you can opt to have an object ive </p>
<a id="studylines"><h2>Setting up studylines</h2></a>
<p>Before you can add courses to the studyplan, you have to define <i>study lines</i>. You use them to group together courses in logical categories.
Most likely these are categories or themes within your curriculum.</p>
<p>For performance reasons, study lines can only be edited when in <i>study line edit mode</i>. The courses and flow between them will be hidden,
so the lines can be reshuffled and edited. You can toggle studyline edit mode with the toggle switch <i>edit stydy lines</i></p>
<p><img src="img/AddStudylines-overview.png" class="border border-primary rounded-lg ml-3"></p>
<p>Using the <b>Add study line</b> link, you can add a new studyline. You will then get a new window where you can enter details and select a handle color for this line</p>
<p><img src="img/AddStudyline-modal.png" class="border border-primary rounded-lg ml-3"></p>
<p>Here you can enter a <b>full name</b> for the study line that will be shown when you hover over the name, and a <b>code</b> that is a short name which will be shown
in front of the study line. Often this can be a short code. The <b>color</b> you pick will be shown in a little tab in front of the study line.</p>
<p>You can <i>drag</i> study lines to re-order them after you place them using the <i class="fa fa-arrows"></i> crosshair arrows</p>
<p>Using the <i class="fa fa-pencil"></i> and <i class="fa fa-trash"></i> symbols you can edit and delete the studyline (only empty studylines can be deleted)</p>
<p><img src="img/Studylines-view.png" class="border border-primary rounded-lg ml-3"></p>
<div class="generalbox alert alert-info"><b>TIP:</b><br>
If you have many studyplans using the same study line make-up you can export the first studyplan after you set up the study lines, and then import it on the next
study plans.<br>(Use <b>Advanced</b> -> <b>Backup studyplan</b> to find the <i>backup</i> and <i>restore</i> features)</div>
<a id="studycourses"><h2>Adding courses</h2></a>
<p>To add courses, you need to exit <i>study line edit mode</i> and open the toolbox using the <button class="btn btn-primary">Open toolbox</button> button.
The toolbox will now open on the right of the screen. (Using the toggle button on top, you can also switch it to the left of the screen if needed)</p>
<p><img src="img/Toolbox-Courses.png" class="border border-primary rounded-lg ml-3"></p>
<p>The toolbox shows you all the categories you have access to and the courses in them. Simply drag the course you want to include from the toolbox and
drop it in one of the slots in the studyplan that now appear.</p>
<p><img src="img/Toolbox-dragcourse.png" class="border border-primary rounded-lg ml-3"></p>
<p>To re-arrange the courses in the study plan, simply drag and drop them from the places they are now in.</p>
<p><img src="img/Studyitem-dragdelete.png" class="border border-primary rounded-lg ml-3"></p>
<p>To remove a course from the study plan, simply drag it to the red garbage bin that appears on dragging</p>
<a id="studycourses"><h2>Configuring courses</h2></a>
<p>Once a course is added to the studyplan, an icon shows if it needs to be configured (<i class='fa fa-exclamation-circle text-warning'></i>) or
is already configured (<i class='fa fa-check text-success'></i>).</p>
<p>By clicking on the course title (it's shortname, or a configured custom field), you can view the details, and configure it where applicable.
The configuration is dependent on the aggregation method for the study plan:</p>
<h3>Moodle course completion</h3>
<p>When using moodle course completion as a base, all configuration is done in the <i>course's completion settings</i>.
The course details show a <i class='fa fa-gear primary'></i> gear icon in the title, which takes you directly to the course completion configuration.
Once it is configured, the course details will show you exactly how the course completion is configured</p>
<p><img src="img/Course-config-corecompletion.png" class="border border-primary rounded-lg ml-3"></p>
<h3>Manual: Completed + required goals</h3>
<p> In this mode, the course details show you all the gradable activities in the course. You need to select which of them will be used to determine progress
and will be shown to the students and teachers in the studyplan view. You can also mark gradables ad <i>required</i>. Gradable activities marked as
such will all need to be completed for the course to be marked as completed, regardless of the minimum percentage configured</p>
<p><img src="img/Course-config-bistate.png" class="border border-primary rounded-lg ml-3"></p>
<a id="studybadges"><h2>Adding badges</h2></a>
<p>The toolbox also shows you the site-wide badges that are available for students. These can be dragged into the slots around and between the courses.</p>
<p>When you click on the <i class="fa fa-gear"></i> icon in the badge it shows you additional information about the badge</p>
<p><img src="img/Toolbox-badges.png" class="border border-primary rounded-lg ml-3"></p>
<a id="flow"><h2>Drawing the flow</h2></a>
<p>You can draw arrows between the courses and add flow indicators to show students how different courses are related in the studyplan</p>
<h3>Drawing arrows</h3>
<p> </p>
<h3>Removing arrows</h3>
<p> </p>
<h3>Adding flow indicators</hr>
<p><img src="img/Toolbox-flow.png" class="border border-primary rounded-lg ml-3"></p>
<p> You can add the following flow indicators:</p>
<ul>
<li><b>Junction</b> Used to combine the results of multiple arrows. The color and resulting arrow will be based on the combination of the incoming arrows</li>
<li><b>Finish</b> Used to indicate the end of a study line. It's color is based on the combination of the incoming arrows, just like the junction </li>
<li><b>Start/continue</b> These indicators are always green and can be used to indicate the start of a series of courses</li>
</ul>
<p> By clicking on the <i class="fa fa-gear"></i> icon in the junction and finish indicators, you can select how the incoming arrows will be combined.
The indicated numer of arrows need to be completed in order to show the indicator as completed</p>
<ul>
<li><b>All entries</b></li>
<li><b>2/3 of entries</b></li>
<li><b>Half of entries</b></li>
<li><b>All entries</b></li>
</ul>
<div class="generalbox alert alert-info"><b>Note:</b><br>
Using the <i>Manual</i> aggregation method, these conditions are also used to determine whether a junction or finish will be shown as <i>good</i> or <i>excellent</i>
In those cases, at least the specified number of arrows need to be <i>good</i> or <i>excellent</i> in order to color the indicator as such.</div>
</div> </div>

View file

@ -0,0 +1,15 @@
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
<li class="nav-item"><a class="nav-link " href="index.htm">Main</a></li>
<li class="nav-item"><a class="nav-link " href="create-studyplan.htm">Creating a study plan</a></li>
<li class="nav-item"><a class="nav-link " href="view-studyplan.htm">Viewing a studyplan - for students</a></li>
<li class="nav-item"><a class="nav-link active" href="teacherview-studyplan.htm">Viewing a studyplan - for teachers</a></li>
<li class="nav-item"><a class="nav-link " href="advanced.htm">Advanced topics</a></li>
<li class="nav-item"><a class="nav-link " href="configuration.htm">Configuration</a></li>
</ul>
<h2>About studyplan</h2>
</div>

16
doc/view-studyplan.htm Normal file
View file

@ -0,0 +1,16 @@
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
<li class="nav-item"><a class="nav-link " href="index.htm">Main</a></li>
<li class="nav-item"><a class="nav-link " href="create-studyplan.htm">Creating a study plan</a></li>
<li class="nav-item"><a class="nav-link active" href="view-studyplan.htm">Viewing a studyplan - for students</a></li>
<li class="nav-item"><a class="nav-link " href="teacherview-studyplan.htm">Viewing a studyplan - for teachers</a></li>
<li class="nav-item"><a class="nav-link " href="advanced.htm">Advanced topics</a></li>
<li class="nav-item"><a class="nav-link " href="configuration.htm">Configuration</a></li>
</ul>
<h2>Using the studyplan - for students</h2>
<p>If you followed the post-install instructions, then every student associated with a studyplan will have the link "</p>
</div>

View file

@ -144,8 +144,8 @@ $string['cfg_plans'] = 'Manage study plans';
$string['cfg_grades_desc_head'] = 'Configure how reuslts for goals are presented.'; $string['cfg_grades_desc_head'] = 'Configure how reuslts for goals are presented.';
$string['cfg_grades_desc'] = 'If failed results are supported, the threshold for progression is relevant. All results below this threshold will be considered failed. Empty results or 0 will always be read as not started. <br> The completion threshold always takes preference if it is equal to or lower than th progression threshold.'; $string['cfg_grades_desc'] = 'If failed results are supported, the threshold for progression is relevant. All results below this threshold will be considered failed. Empty results or 0 will always be read as not started. <br> The completion threshold always takes preference if it is equal to or lower than th progression threshold.';
$string['cfg_grades_grades'] = 'Configure scale grade interpretation'; $string['cfg_grades_grades'] = 'Configure point grade interpretation';
$string['cfg_grades_scales'] = 'Configure point grade interpretation'; $string['cfg_grades_scales'] = 'Configure scale grade interpretation';
$string['min_progress'] = 'Progression threshold'; $string['min_progress'] = 'Progression threshold';
$string['min_completed'] = 'Completion threshold'; $string['min_completed'] = 'Completion threshold';
$string['grade_points'] = 'Maximum grade points'; $string['grade_points'] = 'Maximum grade points';

View file

@ -146,8 +146,8 @@ $string['cfg_plans'] = 'Studieplannen beheren';
$string['cfg_grades_desc_head'] = 'Stel hier in op welke manier resultaten voor doelen worden geinterpreteerd.'; $string['cfg_grades_desc_head'] = 'Stel hier in op welke manier resultaten voor doelen worden geinterpreteerd.';
$string['cfg_grades_desc'] = 'Bij gebruik van onvoldoende beoordelingen is de drempelwaarde voor ontwikkeling relevant. Bij waarden onder deze drempel, wordt het resultaat weergegeven als onvoldoende. Een lege beoordeling wordt altijd gezien als niet gestart. <br> Als de drempel voor voltooing kleiner dan of gelijk is aan die voor ontwikkeling, dan krijgt die voor voltooing voorrang'; $string['cfg_grades_desc'] = 'Bij gebruik van onvoldoende beoordelingen is de drempelwaarde voor ontwikkeling relevant. Bij waarden onder deze drempel, wordt het resultaat weergegeven als onvoldoende. Een lege beoordeling wordt altijd gezien als niet gestart. <br> Als de drempel voor voltooing kleiner dan of gelijk is aan die voor ontwikkeling, dan krijgt die voor voltooing voorrang';
$string['cfg_grades_grades'] = 'Instellen betekenis resultaatschalen'; $string['cfg_grades_grades'] = 'Instellen betekenis puntenbeoordeling';
$string['cfg_grades_scales'] = 'Instellen betekenis puntenbeoordeling'; $string['cfg_grades_scales'] = 'Instellen betekenis resultaatschalen';
$string['min_progress'] = 'Drempelwaarde voor ontwikkeling'; $string['min_progress'] = 'Drempelwaarde voor ontwikkeling';
$string['min_completed'] = 'Drempelwaarde voor voltooid'; $string['min_completed'] = 'Drempelwaarde voor voltooid';
$string['grade_points'] = 'Maximum aantal points'; $string['grade_points'] = 'Maximum aantal points';