Go to Site administration -> Courses -> Studyplans -> Studyplan settings
- Under Course display name you can select if you want to use shortname, ID field or any other previously configured custom field
While scales are automatically added and cannot be removed, you can remove previously configured maximum grade points. To do so, check the delete mark next to it, and press save
+The studyplan plugin is category context aware - meaning that every studyplan is placed in a context. And users can have rights to view and/or edit + studyplans within a specific context.
+To edit a studyplan in a specific context, you can use one or two ways:
+The list in the top left of the management page, also shows you how many study plans there are in the contexts listed. Since subcategories are also listed, this can be + very useful for management purposes.
+
+
+ Viewing the studyplans of students is also a right that is context-aware. (Right local/treestudyplan:viewuserreports)
+Both methods outlined above also work for viewing student studyplans. The main difference is that the drop-down list on the top-left of the page + only shows the categories that actually have studyplans that are viewable for the current user. (Which means that the user can not only see the study plan + itself, but also the results of specific users). It is recommended to give this right to all teachers in a specific category, unless you have specific reasons + why teachers might not be allowed to see all results of the students. +
+
+
+ Using the block My Studyplan you can show students the studyplans they are enrolled in on the dashboard page. This may be useful for navigation.
+This block shows teachers another view - namely all studyplans they are currently teaching courses in (orderd in tabs). For teachers, this view will often take a + few seconds to load, especialy if they teach in multiple study plans, since the result statistics for each course are collected each time
+In spite of the loading time, this view can be beneficial to teachers, since it can easily show them the statistics for the courses they are teaching
+ +For the studyplan the following permissions are defined:
+| Right | +Explanation | +Default applied to | +Context applicabble | +
|---|---|---|---|
| local/treestudyplan:editstudyplan | ++ | manager | +System and/or category | +
| local/treestudyplan:forcescales | +Allow studyplan managers with this right to push scales for grading to all selected grable activities (see above) + (Effective only when Manual aggregation method is selected in the study plan) |
+ manager | +System and/or category | +
| local/treestudyplan:selectowngradables | +Teachers with this right in a course context, can select their own gradable activities in the plan + (Effective only when Manual aggregation method is selected in the study plan) |
+ teacher | +Course | +
| local/treestudyplan:configure | +Users with this right can configure global interpretation of scales and point grades | +manager | +System | +
| local/treestudyplan:viewuserreports | ++ | manager | +System and/or category | +
While the studyplan management rights are added by default to the manager role, the right to just view the studyplans for teachers and students is not + added to any default role. You should make a separate role for faculty that is allowed to view the study plans (or integrate it in an existing role), + grant the roght local/treestudyplan:viewuserreports to that role, and assign the role to all users that should have this right in a given context.
+ + + + \ No newline at end of file diff --git a/doc/img/Contexts-Manage.png b/doc/img/Contexts-Manage.png new file mode 100644 index 0000000..457f329 Binary files /dev/null and b/doc/img/Contexts-Manage.png differ diff --git a/doc/img/Contexts-View.png b/doc/img/Contexts-View.png new file mode 100644 index 0000000..cc2252d Binary files /dev/null and b/doc/img/Contexts-View.png differ diff --git a/doc/img/Share-studyplan-add.png b/doc/img/Share-studyplan-add.png new file mode 100644 index 0000000..587ece9 Binary files /dev/null and b/doc/img/Share-studyplan-add.png differ diff --git a/doc/img/Share-studyplan-manage.png b/doc/img/Share-studyplan-manage.png new file mode 100644 index 0000000..dc52334 Binary files /dev/null and b/doc/img/Share-studyplan-manage.png differ diff --git a/doc/img/Student-coursedetails-corecompletion.png b/doc/img/Student-coursedetails-corecompletion.png new file mode 100644 index 0000000..91acca4 Binary files /dev/null and b/doc/img/Student-coursedetails-corecompletion.png differ diff --git a/doc/img/Student-coursedetails-manual.png b/doc/img/Student-coursedetails-manual.png new file mode 100644 index 0000000..2aa8f3b Binary files /dev/null and b/doc/img/Student-coursedetails-manual.png differ diff --git a/doc/index.htm b/doc/index.htm index d409dbb..5a8f7c5 100644 --- a/doc/index.htm +++ b/doc/index.htm @@ -30,9 +30,15 @@ Study plans|/local/treestudyplan/view-plan.php||en Manage Study plans|/local/treestudyplan/edit-plan.php||enThe studyplan plugin wil automatically hide the primary navigation items that are not applicable for the current user.
-
+ While the studyplan management rights are added by default to the manager role, the right to just view the studyplans for teachers and students is not + added to any default role. You should make a separate role for faculty that is allowed to view the study plans (or integrate it in an existing role), + grant the roght local/treestudyplan:viewuserreports to that role, and assign the role to all users that should have this right in a given context.
+See Advanced -> Roles and permissions for more details
+ +After installing the plugin you can find the main configuration in Site administration -> Courses -> Studyplans
+
The page Configuration gives more details about the configuration options
\ No newline at end of file diff --git a/doc/view-studyplan.htm b/doc/view-studyplan.htm index 4372450..7b2cddd 100644 --- a/doc/view-studyplan.htm +++ b/doc/view-studyplan.htm @@ -9,8 +9,107 @@If you followed the post-install instructions, then every student associated with a studyplan will have the link "
+If you followed the post-install instructions, then every student associated with a studyplan will have the link My studyplan + in the top menu.
+
Clicking on this link shows the student all studyplans they are enrolled in as tabs.
+
Each course has it's current outcome displayed with an icon and a color. The arrows protruding from the courses also show the color of it's icon
+| Meaning | +Icon | +Color | +Remarks | +
|---|---|---|---|
| Completed (generic) | ++ | Bootstrap color variable --blue | + td class="pl-3">(Used only in the Moodle course completion studyplan aggregation methods) +|
| Completed Passed | ++ | Bootstrap color variable --success | +|
| Good | ++ | Bootstrap color variable --info | +(Used only in the Manual studyplan aggregation methods) | +
| Excellent | ++ | Bootstrap color variable --blue | +(Used only in the Manual studyplan aggregation methods) | +
| Progress/Not yet completed | ++ | Bootstrap color variable --warning | +|
| Failed | ++ | Bootstrap color variable --danger | +|
| Not started | ++ | Bootstrap color variable --gray | +
As you can see, the used colors depend on your theme. The configured colors for success, warning, danger and info are all + used. If you wish to further configure the colors, you can choose to redefine the other variables (e.g. --blue and --gray) your theme's + SCSS additions. +
+By coloring the arrows in the color of the progress, both students and teachers can quickly see a student's progress in a course
+Study plans that use the Moodle course completion aggregation method show a small circle that shows the progress percentage of all requirements, + instead of an icon
+By clicking on the course title, or any of the activities the student is directly sent to the course or activity page, in a new tab.
+
Per completion requirement, it is shown whether or not the student has completed, passed or failed the requirement.
+The completion categories have a circle showing the progress in this category, while the status indicator to the top right shows the total status
+Until the course end date has passed, the end status is marked as progress as long as one or more requirements are met or graded. + After the course end date has passed, ther course is indicated as failed if the completion requirements are not met
+By clicking on the icon, the student can see the specific requirements for each + condition or activity.
+If a teacher left feedback for an activity, the link View feedback is shownand shows the specific feedback upon clicking it.
+
Per selected activity, it is indicated if the student has completed this activity or not
+Until the course end date has passed, the end status is marked as progress as long as one or more requirements are met or graded. + After the course end date has passed, ther course is indicated as failed if the completion requirements are not met + and the failed option is enabled in the studplan configuration
+If a teacher left feedback for an activity, the link View feedback is shownand shows the specific feedback upon clicking it.
+(This is due to the specific grading requirements of the first school to request the study plan plugin)
+ +All students have the Share studyplan access button
+Using this button, the student can share access to their studyplan with anyone they choose. (Generally it is recommended that students share therein + study plan with their parents) +
+The student first enters the Invite management page where they can add, remove, edit or re-send invitations
+
By clicking the icon, the student can verify how their invitees see the studyplan
+the other icons are respecively + re-send mail, + edit and + delete
+ +When starting a new invite, the student is asked to provide the name and email of the person to send the invitation to
+
After completing the invitation, the system sends an email to the invitee with a unique link specific to the invitee. By clicking the link, + the invitee can see the student's study plan, grades and provided feedback. +
+Upon deleting the invitation, the unique link is immediately deactivated and all access the invitee had to view the student's studyplan is revoked.
\ No newline at end of file