Course overview: Difference between revisions

Latest revision as of 21:19, 31 July 2024

The course overview block

The course overview block enables students to check their course progress.

What enrolled users see

The course overview is displayed on a student's My courses page and displays three dropdowns:
an option to sort by all, current, future, in progress, starred or hidden courses
an option to display courses by last accessed or by title
an option to display course by cards, summary or list view

Past, In Progress and Future courses

For courses to appear in the 'Past' section, the course end date must be in the past or the course must be completed. If course completion is turned on in the course settings, the course will not appear in the 'Past' section until course completion conditions are met even if the course end date is in the past.

For courses to appear in the 'Future' section, the student must be enrolled in them even though the course start date is in the future.

For courses to appear in the 'In Progress' section, they must be not yet completed and the current date must be after the course start date. The current date must be before the end date, or there is no end date. Courses 'In progress 'displayed in the Course overview block match the courses displayed in the navigation drawer, although a site administration navigation setting can limit this number.

Another way to say think about In Progress is:

1. The course must not yet be complete
AND
2. The current date must be after the course start date
AND 
3. The current date must be EITHER before the course end date OR there is no course end date

Tip: If the course is marked complete for a user and it is still on the In Progress tab and not in the Past tab, then check the course dates to make sure it meets the date criteria.

Starred and hidden courses

To 'star' ('bookmark') a course click the three dots by its name and then click "Star this course".
To hide a course, click the three dots by its name and then click "Remove from view".
Courses may be filtered by starred or hidden courses. Alternatively, for starred courses. the Starred courses block may be added to the dashboard

How to make the percentages display on the Course overview

For the percentages to display, the course must have Completion tracking enabled and using Activity completion.

Note that the percentages relate only to the percentage of activities with activity completion set that have been completed. The percentages do NOT relate to course completion (MDL-67890).

The percentage calculation uses the total number of activities with activity completion set, regardless of whether they are hidden or have an access restriction (MDL-60912). The only way to make the percentage reflect work assigned to date would be to not set activity completion for activities which are hidden or have an access restriction.

How to customise the Course overview layout

Administrators can specify which layouts (card/list/summary) are available to users from Site administration / Plugins / Course overview block.

How to customise the course filter

Administrators can specify which courses may be filtered from Site administration / Plugins / Course overview block.
This now includes the option to filter by Course custom fields, as long as at least one course custom field is in use. Note that the course custom field must have its visibility field set to 'Everyone'.

How to change the colours on the Course overview

Administrators can specify colours of the course cards from Site administration / Appearance / Course pattern colours

Displaying course categories

Course categories may be displayed along with courses from an admin setting in Site admin / Plugins / Blocks / Course overview / Display course categories.

Capabilities

There is just one capability for this block:

Add a new course overview block to Dashboard

@@ Line 1: / Line 1: @@
 {{Blocks}}
 ==The course overview block==
+The  course overview block enables students to check their course progress.
-The  course overview block enables students to check their course progress and view upcoming deadlines. It allows teachers to easily see activities needing grading. To get started, watch the [https://youtu.be/KKhw9zSpFNg Course overview screencast].
+==What enrolled users see==
-Note for sites upgrading from earlier versions: The course overview block in previous versions of Moodle has been removed and replaced with a new course overview, which provides details of course progress and upcoming deadlines. The [[Course overview (legacy)|legacy course overview block]] may be downloaded from the Plugins directory: [https://moodle.org/plugins/block_course_overview Blocks: Course overview (legacy)].
+*The course overview is displayed on a student's My courses page and displays three dropdowns:
+*an option to sort by all, current, future, in progress, starred or hidden courses
+*an option to display courses by last accessed or by title
+*an option to display course by cards, summary or list view
-==What a student sees==
+===Past, In Progress and Future courses===
+For courses to appear in the 'Past' section, the course end date must be in the past or the course must be completed. If course completion is turned on in the course settings, the course will not appear in the 'Past' section until course completion conditions are met even if the course end date is in the past.
+For courses to appear in the 'Future' section, the student must be enrolled in them even though the course start date is in the future.
-*The course overview is displayed on a student's dashboard and displays two tabs: Timeline and Courses.
+For courses to appear in the 'In Progress' section, they must be not yet completed and the current date must be after the course start date. The current date must be before the end date, or there is no end date. Courses 'In progress 'displayed in the Course overview block match the courses displayed in the navigation drawer, although a site administration navigation setting can limit this number.
-*The Timeline tab can be sorted by dates or by courses.
-*When sorted by dates, sections for Recently overdue (if applicable), Today, Next 7 days, and Next 30 days display. Students can click to go directly to a required item - for example, 'Add submission' to submit an assignment.
-*When an activity such as an assignment is submitted, it is no longer displayed.
-*For items not yet open, greyed out links are shown.
-*Switching to the Courses view, the student then sees activities filtered by course, with a percentage completion icon. This percentage shows how many of the activities with activity completion settings have been completed so far.
-{|
-|-
-| [[File:33COTimelineDates.png|thumb|Timeline sort by dates]]
-| [[File:33COTimelineCourses1.png|thumb|Timeline sort by courses]]
-|}
-*If the student clicks the Courses tab instead of the Timeline tab, she can then view current, future or past courses. The screenshot below shows current (in progress) courses.
-{{New features}}* In Moodle 3.5 onwards, if the teacher has added course images in the course settings, they will display here. If no images have been added, coloured patterns appear.
+Another way to say think about In Progress is:
-{|
+<pre>
-|-
+. The course must not yet be complete
-| [[File:DocsDashboard1.png|thumb|Courses with images]]
+AND
-|}
+. The current date must be after the course start date
+AND
+. The current date must be EITHER before the course end date OR there is no course end date
+</pre>
+Tip: If the course is marked complete for a user and it is still on the In Progress tab and not in the Past tab, then check the course dates to make sure it meets the date criteria.
-===Past, In Progress and Future courses===
+===Starred and hidden courses===
-*For courses to appear in the 'Past' section, the course end date must be in the past or the course must be completed.
-*For courses to appear in the 'In Progress' section, they must be not yet completed and the current date must be after the course start date. The current date must be before the end date, or there is no end date. (Note: since 3.3.1 the courses 'In progress 'displayed in the Course overview block match the courses displayed in the navigation drawer, although a site administration navigation setting can limit this number.)
+[[File:docsStarHide.png|300px]]
-*For courses to appear in the 'Future' section, the student must be enrolled in them even though the course start date is in the future.
+*To 'star' ('bookmark') a course click the three dots by its name and then click "Star this course".
+*To hide a course, click the three dots by its name and then click "Remove from view".
+*Courses may be filtered by starred or hidden courses. Alternatively, for starred courses. the [[Starred courses block]] may be added to the dashboard
+==How to make the percentages display on the Course overview==
+For the percentages to display, the course must have Completion tracking enabled and using [[Activity completion]].
+[[File:completionpercentage.png]]
+Note that the percentages relate only to the percentage of activities with activity completion set that have been completed. The percentages do NOT relate to course completion (MDL-67890).
+The percentage calculation uses the total number of activities with activity completion set, regardless of whether they are hidden or have an access restriction (MDL-60912). The only way to make the percentage reflect work assigned to date would be to not set activity completion for activities which are hidden or have an access restriction.
-==What a teacher sees==
+==How to customise the Course overview layout==
-A course teacher has a similar view to that of a student. Additionally, however, they are alerted when assignments need grading. The number needed grading displays for the teacher and they click the 'Grade' link to go directly to the grading screen:
-[[File:33COTeacherView.png]]
+Administrators can specify which layouts (card/list/summary) are available to users from ''Site administration / Plugins / Course overview block.''
+==How to customise the course filter==
-==How to make activities and resources display on the Course overview==
+*Administrators can specify which courses may be filtered from ''Site administration / Plugins / Course overview block.''
+*This now includes the option to filter by Course custom fields, as long as at least one course custom field is in use. Note that the course custom field must have its visibility field set to 'Everyone'.
-For activities
+==How to change the colours on the Course overview==
-* Either set a deadline or
+Administrators can specify colours of the course cards from Site administration / Appearance / Course pattern colours
-* Set an 'Expect completed on' date in the activity completion settings
-* For teachers to see assignments which need grading, a 'Remind me to grade by' date must be entered in the assignment set up screen.
-For resources
+==Displaying course categories==
-* Set an 'Expect completed on' date in the activity completion settings
-==How to make the percentages display on the Course overview==
+Course categories may be displayed along with courses from an admin setting in Site admin / Plugins / Blocks / Course overview / Display course categories.
-*For the percentages to display, the course must have activity completion enabled.
-*If activity completion is not enabled, the icon looks like this:
-[[File:33NoCompletion.png]]
+==Capabilities==
-==Timeline and courses tabs==
+There is just one capability for this block:
-* A setting 'Default tab' (defaulttab) enables an administrator to specify the tab that will be displayed when a student first views their course overview. When returning to their course overview, the student's active tab is remembered.
+* [[Capabilities/block/myoverview:myaddinstance|Add a new course overview block to Dashboard]]
-* If required, the timeline and courses tab URLs may be copied and pasted and bookmarked. The URL of the timeline tab is mysite.org/my/?myoverviewtab=timeline and the courses tab is mysite.org/my/?myoverviewtab=courses.
 ==See also==
-* [[Activity completion]]
 * For the documentation related to the previous version of the block, please refer to [[Course overview (legacy)]]
-* MDL-58384 - Collection of issues left from myoverview improvements epic
+* MDL-60912 - Percentage complete in course overview on Dashboard should consider hidden or blocked activities
 [[es:Vista general del curso]]
 [[de:Kursübersicht-Block]]

Documentation