Access Keys:
Skip to content (Access Key - 0)

Moodle Manual

The most recent documentation for Moodle/Joule 2 has moved.

Please go to http://kb.moodlerooms.com to view the New Knowledge Base.

Table of Contents

1. Activity Completion

1.1. Overview

Activity completion allows the teacher to configure activities to be marked for completion, either manually by the student or automatically based on a student meeting one or more conditions. This allows a student to see visibly what items have been completed in the course and can limit or direct what activities a student is able to access in the course. Activity completion can be used in combination with course completion to meet a teacher's completion needs.

1.1.1. Related Features

1.2. Usage Scenarios

1.2.1. Student Manual Completion Tracking

In this scenario, each activity is set to Students can manually mark the activity as completed. The student marks each activity as complete when they determine the activity is complete. In this scenario, the student uses activity completion to track their progress in the course more for personal use.

1.2.2. Activity and Course Completion Tracking

In this scenario, activity completion is linked to course completion through the completion settings for the course. Each activity selected in the course completion settings counts towards the completion of the course. Within this scenario, the teacher can set activities to be manually or conditionally completed. For more automated completion, it is recommended that conditions be set for each activity.

1.3. User Documentation

Activity completion is set by the teacher for each activity they determine to be completable. There are two types of activity completion that an activity can have:

  1. Manual - The student marks an activity as complete
  2. Conditional - The student must meet specific conditions for the activity to be marked as complete

When activity completion is enabled for a course and an activity, a new column appears to the far right of the activity called Your progress. Within this column, each completable activity will have an icon based on the theme being used. Moodlerooms' default theme uses a blank square to denote an activity that hasn't been completed for manual and conditional activity completion.

student view of completion activities

A black check mark icon denotes a completed activity.

student view of completion activities

1.3.1. Manually Marking an Activity as Complete

To manually mark an activity as complete, click on the incomplete icon (the blank square in the Your progress column). This will change the icon to a black check mark. If the cursor doesn't change when placed over the incomplete icon, then the activity is set to conditional completion. In this case, the student will need to meet the conditions to complete the activity.

1.4. Teacher Documentation

1.4.1. Activity Completion

Activity completion works with course completion and enables a teacher to allow students to set their progress in a course or automatically update progress in a course based on conditions for activities. The settings available vary based on the chosen activity.

Requires Completion Tracking to be Enabled
Activity completion requires that a course have completion tracking enabled before these settings will appear for an activity.

The Activity completion settings are dynamic for each course activity, therefore different settings will be available based on the selected activity.

The following is an example of some of the activity completion settings:

  • Completion tracking: If enabled, activity completion is tracked, either manually or automatically, based on certain conditions. Multiple conditions may be set if desired. If so, the activity will only be considered complete when ALL conditions are met. A tick next to the activity name on the course page indicates when the activity is complete.
    • Do not indicate activity completion - Activity completion is disabled for this activity and will not report on the activity completion report.
    • Students can manually mark the activity as completed - The student informs the teacher when the activity is completed.
    • Show activity as complete when conditions are met - Setting this enables the optional settings below and completion of the activity will be marked when the student meets all of the enabled conditions.
  • Require view: If enabled, the activity is considered complete when a student receives a grade. Pass and fail icons may be displayed if a pass grade for the activity has been set.
  • Require grade: If enabled, the student must receive a grade (any grade) to complete this activity. This is only displayed in the activity settings for activities that can be graded. If a passing grade is set in the grade book for the activity, then the activity will be marked as passed or failed.
  • Expect completed on: This setting specifies the date when the activity is expected to be completed. The date is not shown to students and is only displayed in the activity completion report.

1.4.2. Activity Completion in a Course

When a teacher views assignments in a course with editing turned on, activities that have activity completion enabled will have an icon to the right of them that displays the type of completion the activity has set (manual or conditional completion).

The icons displayed can vary by theme. For the Express theme provided by Moodlerooms, the gray check mark denotes a manually completed activity and the light blue check mark icon denotes an activity that has conditions that must be met in order to be completed.

2. Backup and Restore

2.1. Overview

A course can be saved with some or all of its parts by performing a course backup. A teacher with editing privileges can create a backup or download an existing backup for safe keeping, or for use on another Moodle site. A backup can also be made that is IMS Common Cartridge compliant and allows the user to migrate courses, without user data, between LMS's.

Note: All Joule activities are not supported by IMS Common Cartridge.

2.2. Benefits

The benefits of backup/restore and support for IMS Common Cartridge:

  • Ability to backup/restore course data to save time and add security
  • Import files organized in the IMS Common Cartridge format (like publisher content or other LMS content)
  • Restore import as a course with equivalent Moodle learning objects and activities
  • Export a Moodle course into an IMS Common Cartridge format, capable of being restored by other LMS systems

2.3. Teacher Documentation

2.3.1. Backing up a course

There are many reasons to back up course data. For example, you may want to save your course elsewhere, that way in the event of a technological failure all is not lost. The back up process can be used to create multiple sections of a single course, to backup certain resources and activities and re-use them elsewhere, or to backup a course without user data to re-use it again.

To back up a course log in as Teacher with editing permissions.

Note: The course Administrator may need to grant permissions to a Teacher in a course.

Navigate to Settings->Course Administration and click Backup.

?settings menu with backup listed

2.3.2. Initial settings

Initial settings allow you to select what information you want to back up from your course. You can choose what information you want backed up as well as choose to save the backup as an IMS Common Cartridge file. For more information on IMS Common Cartridge click here.

To begin the backup process, check the boxes for the information you would like to include in the backup under Initial settings

Backup settings:

  • IMS Common Cartridge 1.1: when checked, will backup the course as an IMS Common Cartridge compliant ".imscc" file. See more below.
  • Include enrolled users: when checked, will include user data for enrolled users in the backup.
  • Anonymize user information: when checked, will make user information anonymous in the backup.
  • Include user role assignments: when checked, will include a users' role assignments in the backup.
  • Include user files: when checked, will include all user's files in the backup.
  • Include activities: when checked, will include activities in the backup.
  • Include blocks: when checked, will include the blocks in the backup.
  • Include rubrics: when checked, will include course rubrics in the backup.
  • Include filters: when checked, will include course filters in the backup.
  • Include comments: when checked, will include comments in the backup.
  • Include user completion details: when checked, will include details about what users have completed in the backup.
  • Include course logs: when checked, will include course logs in the backup.
  • Include grade history: when checked, will include the grade history for a course in the backup.
  • Include PLD data: when checked, will include Personalized Learning Designer (PLD) rules in the backup.
  • Include PLD log data: when checked, will include PLD log data in the backup. This should not be backed up if there will be no user data in the backup.
Note:If you are using Personalized Learning Designer select whether or not to include PLD data/log data. IMS Common Cartridge does not support PLD.

2.3.3. Backing up using IMS Common Cartridge

Common cartridge is a specification standard that IMS has set to standardize course content and allow it to be used across LMS platforms. For more information on IMS Common Cartridge click here.

To backup the course as an IMS Common Cartridge check IMS Common Cartridge 1.1 and click Next.

check box for IMS Common Cartridge selection

Note: IMS Common Cartridge does not support SCORM content, your backup will be saved without any SCORM content. Not all settings can be backed up using IMS Common Cartridge format because they are not supported on other Learning Management Systems.

2.3.4. Schema settings

Schema settings allow you to customize your backup and include/exclude specific data from a course and decide if you want user data to be included or not. For example, if you are creating a new course but want to use a few resources or activities from a course you could backup only the particular activities and resources you want to re-use and restore them into the new course. You can select to include/exclude user data if you checked Include enrolled users in the Initial settings. User data can make the backup take longer depending on how many users are enrolled in a course.

Review and select the information to be included in the backup under Schema settings and click Next.

schema settings are specifically what is to be include in the backup

2.3.5. Confirmation and review

Enter the Filename if you do not wish to use the default and confirm and review the information that will be included in the backup. Green checks mean the item will be included, and red X's mean the item will not be included. Make any necessary changes to the Initial or Schema settings and confirm and review your backup.

Note: You do not have to change the file extension, it will be changed automatically. If you do not select IMS Common Cartridge the course will be backed up in Moodle's Open Source backup format with the file extension .mbz. IMS Common Cartridge backups will have the file extension .imscc

review backup page with all information that is about to be backed up

2.3.6. Perform backup

Make sure everything you wish to include has been included and everything you do not wish to include has been excluded before backing up your data.

After you have reviewed the information and are ready to begin, click Perform backup.

perform backup button

Once the backup is complete, click Continue. Your backup will begin, depending on the size this may take a few minutes.  When the backup is complete, you will be directed to the Restore page where you can review your backup files and/or restore a course.

2.4. Teacher Documentation

2.4.1. Restoring a course

If you would like to restore a course backup file, you will need to log in to the course as Teacher with editing permissions.

Note: The course Administrator may need to grant these permissions to a Teacher in a course.

Navigate to Settings->Course Administration and click Restore.

settings menu with restore highlighted

2.4.2. Import a backup file

To import a backup file for restoration from an external location, click Choose a file... under Import a backup file

places to select a backup image for restoring

Browse to and select the backup file you wish to restore and click the Restore button.

2.4.2.1. Course backup area

If you backed up a course using the default settings, the file(s) will be located under the Course backup area. If you backed up a course with "Anonymize user information" checked, backup files will be located under the User private backup area.

user private area with files saved there at bottom of screen

There is a link to Download a file and save for restoring later or to restore on another computer. There is also a link to Restore the file to the current course.

Note: The file extension for Core Moodle backup files will be ".mbz" and for IMS Common Cartridge backups the extension will be ".imscc".

To add, download all backup files, rename, move, and delete the backup files listed here, click on Manage backup files and click Save changes when finished.

Once you have located the file you want to restore, click Restore to restore your course.

Note: If you are using an IMS Common Cartridge backup file (.imscc) you will see the message below.

This is not a Moodle backup warning

If you are restoring a Moodle backup file (.mbz) you will be directed to the Confirm screen.

After reviewing the Backup details for Common Cartridge, click Continue when you are ready to proceed.

2.4.3. Confirm

Review information like the course format, Moodle version and more in the Backup details.

backup details displays all available info from the backup file to be restored

2.4.3.1. Backup settings

Backup settings displays what information was selected under Initial settings in the backup process. Review what information is included, such as included enrolled users, activities, blocks and more.

review of information to be restored

Note: Green checks mean that the item will be included in the restore, and red X's mean that an item will not be restored.
2.4.3.2. Course settings

Review the course title, original ID, sections and more under Course settings to see specifically what is going to be restored.

and more equals all specific components of a course that are available for restore

Scroll to the bottom and click Continue when you are ready to proceed.

2.4.4. Destination

The Destination is where your course will be restored to. You can choose to restore your course to several different places.

2.4.4.1. Restore as a new course
  • Restore as a new course: will restore the backup as a new course. You must select a category to add the course to and click Continue to proceed.

place to choose how you would like to restore as new course

2.4.4.2. Restore into this course
  • Restore into this course: will restore the backup course into the current course. Select one of the following options and click Continue to proceed.
    • Select Merge the backup course into this course to restore the backup course into this course in addition to the existing content.
    • Select Delete the contents of this course and then restore to delete all existing content and replace it with the backup course.

second shot of how you would like to restore the course

2.4.4.3. Restore into an existing course
  • Restore into an existing course: will restore the backup into another existing course. Select one of the following options, choose what course you wish to restore into and click Continue to proceed.
    • Select {{Merge the backup course into the existing course}}to restore the backup course into the selected course in addition to the existing content.
    • Select {{Delete the contents of the existing course and then restore}}to delete all existing content and replace it with the backup course.
Warning
Selecting Delete the contents of the existing course and then restore will remove all user data, as well as, remove all content i.e. Activities, Resources, Users, and Grades from the course.

restore destination interface

2.4.5. Settings

The settings lists what is available to be included in the restore, as well as the PLD settings for the restore. You can customize your restore by selecting/deselecting these settings.

settings interface

Note: When restoring into an existing course shell you will have an additional setting called Overwrite course configuration. This will allow you to choose if you want to overwrite the current course settings with those of the course you are restoring, or keep the course settings of the course you are restoring to.

Review the Restore settings and Personalized Learning Designer Settings and click Next when you are ready to proceed.

2.4.6. Schema settings

Select/deselect specific items and user data, and amend the Course name, Course short name, and Course startdate if necessary on the Schema page then click Next.

schema interface

2.4.7. Review

Review the Restore settings and Course settings to make sure everything is correct. Click Previous to return and make changes if necessary.

2.4.8. Perform restore

After you have reviewed everything and are sure you want to restore a course, click Perform restore.

perform restore button

Upon successful completion you will get the following message:

Click Continue to proceed to the restored course.

3. Banner LMB

3.1. Administrator Documentation

The Banner/LMB enrolment plug-in can process either an XML flat file or live feed from Banner via the Luminis Message Broker. Information such as "people" "courses" and "enrollments" are used to set up users, courses and enroll users in courses in Moodle.

Please view our Administrator Configuration Guide for more information on the Banner/Luminis Message Broker Integration for Joule 2.X.

4. Conditional Release

4.1. Overview

An instructor can create one or more conditions for the availability of course materials. Note that ALL conditional restrictions have to be met in order for the activity to be made available.

Course materials that can be conditionally released:

  • Course activities and resources
  • Course topics/weeks/folders (unique to Joule)

Conditions include:

  • Access dates
  • Score ranges for other course activities
  • Completion of other course activities
  • Release codes (unique to Joule)

4.2. Benefits

Conditional Release allows instructors to hide and release content until individual students are prepared to receive it. Instructors can also create thoughtful learning paths for different instructional content. This provides each student with a different experience within the course based on the adaptive path that is most appropriate for them.

4.3. Related Features

4.4. Usage Scenarios

  • An instructor wishes to hide a quiz automatically until a specific date.
  • An instructor wishes to hide a quiz automatically after a specific date.
  • An instructor wishes to hide a resource until a student receives 85% or greater on a quiz.
  • An instructor wishes to create learning paths so that students receiving 0-60% on a quiz see the activities in Topic A.
  • An instructor wishes to create learning paths so that students receiving 61-80% on a quiz see the activities in Topic B.
  • An instructor wishes to create learning paths so that students receiving 81-100% on a quiz see the activities in Topic C.
  • An instructor wishes to hide a resource until a student's course grade is above 80%.
  • An instructor can hide the activities completely from student view.
  • An instructor can grey out the restricted activities and indicate what conditional requirements are necessary for access.

4.5. Student Interface

Courses that have conditionally released activities manifest the information in one of two ways: either students will see a greyed-out message that describes what conditions will make the activity available; or the students won't see the activity at all until the activity is released.

Greyed-Out Message:

Completely Invisible:

4.6. Teacher Documentation

When creating activities (or editing existing ones), teachers can create the following conditional releases:

4.6.1. Allow Access From or Until

Access from/to dates determine when students are allowed to access this course item on the course page.

The difference between access from/to dates and availability settings for the course item is that outside the set dates, the latter allows students to still view the course item description, whereas access from/to dates prevent access completely.

4.6.2. Release Code

In Joule, Moodlerooms offers an additional "Release Code" condition which works in conjunction with the Personalized Learning Designer (PLD).

First, instructors "hide" one or more activities by associating them with a release code.

Next, instructors create a PLD rule that "releases" the code to an individual student upon a specified event (e.g. he passes a quiz with a score between 0-60%).

This allows instructors to identify certain learning paths with release codes (e.g. release Advanced Placement activities, or remedial activities).

Students will not ever be prompted for a release code; instead, the PLD rules will activate or de-activate them based on certain conditions).

4.6.3. Grade Condition

This setting determines any grade conditions that must be met in order to access this course item.

Multiple grade conditions may be set if desired. If so, this course item will only allow access when ALL grade conditions are met.

Note: Click the drop-down menu to select the course activity that is a prerequisite to the current activity. Choose a grade range (low % to high %) that must be obtained to fulfill the condition.

Also, if you want more grade conditions for the current activity, click the Add two grade conditions to form button.

4.6.4. Completion Condition

This setting determines any activity completion conditions that must be met in order to access this course item. Please note that completion tracking must first be set before an activity completion condition can be set.

Multiple activity completion conditions may be set if desired. If so, access to this course item will only be permitted when ALL activity completion conditions are met.

Note: Click the first drop-down menu to select the activities that you want to assign conditions to. Then click the second drop-down menu to choose the threshold condition (one of the following: must be marked complete; must not be marked complete; must be complete with pass grade; must be complete with fail grade).

Also, if you want more activity completion conditions for the current activity, then click the Add two activity conditions to the form button.

4.6.5. View Settings

This setting determines whether students will see conditional activities with greyed-out messages identifying the required access conditions, or whether conditional activities should be completely hidden from student view until fulfillment.

Invisible from the perspective of the instructor:

4.7. Global Settings

Conditional Release requires a site administrator to check the block within Settings block > Site Administration > Advanced Features > Enable Conditional Access.

Note: Once this setting is enabled, in order to use the completion conditions, the site administrator must also check the box within Settings block > Site Administration > Advanced Features > Enable Completion Tracking.

5. Course Completion

5.1. Overview

Course Completion tracking is designed to allow a course to be marked as completed in the system based on one or more criteria. Completion tracking can be based on any of the following:

  1. The completion of other courses
  2. The student setting a course as complete
  3. The teacher setting a course as complete for a student
  4. The student completing one or many activities in a course
  5. A specific date
  6. A certain number of days after the student was enrolled in the course
  7. The student achieving a final grade in the course above a certain percentage
  8. The student being unenrolled from the course

5.1.1. Related Features

5.2. Usage Scenarios

Course Completion has eight methods that can be used separately or together to determine if a student has completed a course. These completion methods are:

  1. Course prerequisites
  2. Manual self-completion
  3. Manual completion by
  4. Activities completed
  5. Date
  6. Duration after enrollment
  7. Grade
  8. Completion on unenrollment

Each method is described individually in the Teacher Documentation section. Below is a description of several common combinations of the eight methods to create a specific completion scenario.

5.2.1. Self Completion After a Date

In this scenario, the student completes the course after a specific date and upon their own admission of completion. This scenario is used with self-paced courses that a student isn't allowed to complete before a specific date in the semester or term. To configure this scenario, the teacher enables Manual self completion and sets the After specified date setting to the earliest date the student can complete the course. The student must then manually mark the course complete after the date has passed for the course to be considered complete.

5.2.2. Completing a Course With a Defined Total Grade, and Completion of Key Activities

In this scenario, the student completes the course once they have met the activity completion criteria for specific activities in the course and have a total grade of greater than the passing grade value. This can be used in the majority of course types to allow a student to view their progress in a course. In order to configure this scenario, the teacher configures the key activity's completion tracking and then sets the Passing grade to the minimum grade the student needs to get to complete the course. The student will automatically have the course marked as complete if they meet both criteria.

5.2.3. Completion of Course With a Passing Grade After a Certain Period in the Course

In this scenario, a student completes a course after a certain number of days of being enrolled in a course based on a final grade. This scenario can be used in an evaluation or prerequisite course that requires a student to receive a passing grade and spend a certain amount of time in a course. To configure this scenario, a teacher enables the Duration after enrolment and Grade course completion methods. The Duration after enrolment is set the minimum amount of time the student must be enrolled in the course and the Passing grade is set to the minimum grade the student needs to complete the course. The student will automatically have the course marked as complete if they meet both criteria.

5.3. Teacher Documentation

5.3.1. Enabling Course Completion

Course Completion is enabled within the course settings (found at Settings block > Course administration > Edit settings) under the Student progress area towards the bottom of the form. To enable Course Completion tracking for the course, select Enabled, control via completion and activity settings from the Completion tracking drop-down menu.

  • Completion tracking: This setting determines if, by default, completion tracking is enabled in a course. Default: Disabled, not shown in activity
    • Disabled, not shown in activity settings
    • Enabled, control via completion and activity settings
  • Completion tracking begins on enrolment: (Not currently implmented) Begin tracking a student's progress in course completion after course enrolment. Default: No
Note
The site administrator must enable completion tracking in order for the Student progress area of the course settings form to appear to a teacher.

5.3.2. Course Completion Course Settings

The course settings for Course Completion tracking can be accessed via the Settings block > Course administration > Completion tracking. To enable course completion, one of the eight completion types must be enabled:

  1. Course prerequisites
  2. Manual self completion
  3. Manual completion by (usually teacher role)
  4. Activities completed
  5. Date
  6. Duration after enrollment
  7. Grade
  8. Completion on unenrollment
5.3.2.1. Overall Criteria Type Aggregation

  • Aggregation method: This setting determines how the enabled criteria combine together to determine if a student has completed the course.
    • Any - The course is marked as complete if any of the enabled criteria have been marked as completed for the student.
    • All - The course is marked as complete if all of the enabled criteria have been marked as completed for the student.
5.3.2.2. Course Prerequisites

Course prerequisites are used to determine if this course can be considered complete based on if the student has completed other courses that are required for the student to begin this one.

If course completion is not enabled for any other courses on the site, then no courses will be displayed here and you will receive the message "Course completion is not enabled for any other courses, so none can be displayed. You can enable course completion in the course settings. Enabling course completion in a course is defined as:

  1. Selecting Enabled, control via completion and activity settings from the Completion tracking drop-down menu in the course settings
  2. Enabling a course completion method by:
    1. Checking the enable checkbox under one of the following criteria:
      1. Manual self completion
      2. Date
      3. Grade
      4. Duration after enrolment
      5. Completion on unenrolment
    2. Selecting a course under Course prerequisites
    3. Selecting an activity under Activities completed
    4. Selecting which roles can assign completion from the Manual completion by area

  • Aggregation method: This setting determines how each of the course's completion statuses combine together to determine if a student has completed the course.
    • Any - The course prerequisite is marked as complete if any of the selected courses have been marked as completed for the student.
    • All - The course prerequisite is marked as complete if all of the selected courses have been marked as completed for the student.
  • Courses available: Select which courses are a prerequisite to this course from the list of courses.
Note
Course prerequisite is just a recommendation and it will not block students from accessing a course because they have yet not completed the prerequisite.
5.3.2.3. Manual Self-Completion

Manual self-completion allows the student to mark a course as complete when they determine they have completed the materials.

  • Enable: Check this checkbox to enable manual self-completion as a way to mark the course as complete for the user.
5.3.2.4. Manual Completion By

The Manual Completion By course completion method requires that users with the assigned role manually mark a student as having completed the course. This is most often used when a teacher or manager of the course must review a student's participation in a course to determine if they have met all criteria.

  • Aggregation method: This setting determines how each of the manual completion markings combine together to determine if a student has completed the course.
    • Any - The course is marked as complete if any of the users with a role have marked the course as completed for the student.
    • All - The course is marked as complete if all of the enabled roles have been marked the student complete.
  • Manager: Click to enable users with the role Manager in the course to mark the user's course completion status.
  • Course creator: Click to enable users with the role Course Creator in the course to mark the user's course completion status.
  • Teacher: Click to enable users with the role Teacher in the course to mark the user's course completion status.
  • Non-editing teacher: Click to enable users with the role Non-Editing Teacher in the course to mark the user's course completion status.
5.3.2.5. Activities Completed

Activities Completed is used to allow course completion to be based on activities the student has completed in the course. This course completion method is usually used if the teacher requires a student to complete specific activities to have completed the course, such as midterm and final quizzes or uploading specific assignments.

All activities with the checkbox next to their name will be included in the Course Completion screen. If a new activity is added to the course, it will need to be manually checked in the Completion Tracking page. This can't be done after a student has already had their Course Completion tracking started.

The following message will display if all activities in the course have their Activity completion setting set to Do not indicate activity completion: "Completion information is not enabled for any activity, so none can be displayed. You can enable completion information by editing the settings for an activity."

  • Aggregation method: This setting determines how completion of each activity combines together to determine if a student has completed the course.
    • Any - The course is marked as complete if any of the required activities have been marked as completed for the student.
    • All - The course is marked as complete if all of the required activities been marked as completed for the student.
  • Activities by name: Each activity in the course that has not had the Activity completion setting set to Do not indicate activity completion is listed with a checkbox next to it. Check the checkbox to associate the activity's completion with the completion of the course.
5.3.2.6. Date

The Date setting allows the teacher to automatically mark a course complete for all students on a specific date. This can be used in conjunction with the other criteria to make sure that a user waits until a specific date before they can complete the course.

  • Enable: Check this checkbox in order to enable completion of this course on a specified date.
  • After specified date: The date that the course will be marked complete.
5.3.2.7. Duration After Enrolment

Duration After Enrollment allows a teacher to mark the course as complete a certain number of days after the student was enrolled in the course. This is usually good for a course that has a minimum time that the student is required to spend in the course before they can complete it. This can be used in conjunction with the other criteria to make sure that a user waits for a certain period of time after starting the course before they can complete the course.

  • Enable: Check this checkbox in order to enable completion of this course a set number of days after the user is enrolled in the course.
  • Days after enrolment: The course will be marked complete this number of days after the student is enrolled in the course.
5.3.2.8. Grade

The Grade method allows a teacher to automatically mark a course complete if a student has received a total course grade above a certain value. This works only with the total course grade. If the course should be marked completed based on specific grades in specific activities, the teacher should use Activity Completion in conjunction with Course Completion.

  • Enable: Check this checkbox in order to enable completion of this course based on a passing grade.
  • Passing grade: The grade that a student must achieve to have the course marked as complete.
5.3.2.9. Unenrolment

The Unenrolment method is used to mark the course complete for a student when they are unenrolled from the course. This is used in conjunction with other criteria to fulfill completion of a course towards the end of the course or a semester.

  • Completion on unenrolment: Clicking this checkbox will mark the course complete when the student is unenrolled from the course.

5.3.3. Editing Course Completion Settings

The Course Completion tracking settings can be edited by the teacher at any time before completion tracking has started for any user in the course. Completion tracking begins when the following criteria are met:

  1. Completion tracking settings have been saved with one criteria group enabled.
  2. A user is enrolled in the course with a role in the progress tracking settings.
  3. The Moodle administrative cron has run.

After these criteria are met, the teacher must unlock the Course Completion tracking Settings page and delete the current completion tracking data for all users enrolled in the course. To unlock completion tracking, perform the following steps:

  1. Click on the Completion tracking link under the Settings block > Course administration
  2. Click on the Unlock completion options and delete user completion data button
Note
It is recommended that the course be completely set up, with all activities created with their activity tracking configured, before a teacher configures Course Completion tracking for the course. Further more students should not be added to the course before Course Completion tracking is completely configured to avoid the need to remove completion data.

5.4. Administrator Documentation

5.4.1. Enable Course Completion

Course Completion must be enabled in order for teachers to be able to use it within a course. Enable Course Completion within the Site Administration > Advanced Features area.

  • Enable completion tracking: When enabled, this lets you turn on completion tracking (progress) at the course level. Default: No

5.4.2. Default Course Settings

Site administrators can enable Course Completion for newly created courses within the default course settings, which is found at: Site Administration > Courses > Default course settings

  • Completion tracking: This setting determines if, by default, completion tracking is enabled in a course. Default: Disabled, not shown in activity settings
    • Disabled, not shown in activity settings
    • Enabled, control via completion and activity settings
  • Completion tracking begins on enrolment: Begin tracking a student's completion progress after course enrollment. Default: No

5.5. Permissions

  • View course completion report: This permission allows a user to view the Course Completion report for all users in the course.
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager   X    
      Course Creator X      
      Teacher   X    
      Non-Editing teacher   X    
      Student X      
      Guest X      
      Authenticated User X      
    • Risks
      • Privacy: Users could gain access to private information of other users
  • Mark users as complete in course completion: This setting allows the teacher to mark students in the course as complete if Course Completion tracking is enabled.
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager   X    
      Course Creator X      
      Teacher   X    
      Non-Editing teacher   X    
      Student X      
      Guest X      
      Authenticated User X      

6. Messaging Outputs

6.1. Default Message Outputs

6.1.1. Overview

Messaging behaviour is controlled by the combination of administrator settings, that define which message outputs are enabled and the default for all users, which outputs can, cannot and should be used for which messages, and user settings that defines which messages user will receive (given that the admin permitted user to control them). The system works graciously when things are not fully configured. For example, Joule streams and alerts can only be sent/received if those messaging options have been configured in the Default message outputs. 

The messaging system is enabled by default and controlled via Site administration>Plugins>Message Outputs>Default Message outputs

6.2. User Documentation

6.2.1. Messaging Output Configuration

Users can configure messaging outputs and customize them for their profile (if the site administrator has granted permission to do so).

Navigate to the Settings block and select My profile>Messaging.

settings block image with messaging link

The Configure notification methods for incoming messages page is a grid of message outputs across the top row and message types listed below. The intersection of particular output and type contains default preferences for chosen messaging type and output.

user interface with check boxes for message output settings

6.2.2. Outputs

There are currently 5 types of outputs:

  • Activity stream: is a user's history of events in the system. Messages are displayed via the Activity stream block.
  • Popup notification: messages that grab the user's attention immediately in order for them to take action. Messages pop-up from the bottom of the screen.
  • Email: communicates information to the user when they are offline mostly and a user needs to interact with the communication outside of Moodle (forward, reply, document proof). Messages are sent to the users' e-mail addresses.
  • Alert badge notifications: communicates information that a user should be allowed to determine if they view it now or later, there is no requirement that they read it now. Messages are sent via the alert badge at the top of the page.
  • Jabber(optional): communicates information via instant messaging. If a Jabber server has been configured, Jabber messages can be sent. The Jabber ID can be set at the bottom of the screen.

When to receive messages:

  • When I'm logged in: When checked, will send the message via the selected output type when a user is logged in to the system.
  • When I'm offline: When checked, will send the message if the user is not logged into the system and will be displayed when the user logs back in.
Note: If When I'm offline is not checked, Activity stream messages, Popup and Alert badge notifications, will not be sent when the user in not logged in and will not be displayed when they log back in.

The different outputs are defined below:

  • Assignment notifications: Notification sent to student informing that an assignment has been graded by the Teacher.
  • Backup notifications: Notification sent to the site administrator for site wide backups, upon their completion.
  • Confirmation of your own quiz submissions: Notification sent to student informing that a quiz has been submitted for grading.
  • Course creation request approval notifications: Notification sent to the site administrator and manager that a course creation request has been approved.
  • Course create request notification: Notification sent to the site administrator and manager that a course creation request has been submitted.
  • Course creation request rejection notifications: Notification sent to the site administrator and manager that a course creation request has not been approved.
  • Course grade changed: Notification sent to the manager, instructor and student informing that the course grade has changed for a student.
  • Important errors with the site: Notification sent to site administrators informing of errors that a user receives in the system (Moodle error message boxes).
  • Glossary entry changed: Notification sent to instructors and all students except the one that edited the glossary entry, informing that the glossary entry has changed.
  • Essay graded notifications: Notification sent to students informing that an essay has been graded.
  • Personal messages between users: Notifications sent to and from all roles with personal messages.
  • Feedback reminder: Notifications sent to students who have not responded to a feedback activity.
  • Joule Gradebook messages: Notifications sent to students from an instructor through the Joule Gradebook.
  • Activity updated or added Notifications sent to all roles informing that an activity in the course has been updated or added.
  • Activity completed: Notifications sent to students informing that activities have been completed.
  • Activity graded: Notifications sent to students informing that their instructor has graded an activity.
  • Notices about minor problems: Notifications sent to the site administrator informing them of notices users receive in the system (notice boxes in Moodle).
  • Subscribed forum posts: Notifications sent to all roles if subscribed to a forum that there has been a post or comment.
  • Feedback notifications: Notifications sent to students informing them that there is feedback from their teacher.
  • Notification of quiz submissions: Notifications sent to managers and instructors when quizzes are submitted.

Temporarily disable notifications: Temporarily disables all notifications except those marked as "Forced" by the site administrator.

Click Update profile at the bottom of the page to save your changes.

6.2.3. Jabber Message

boxes for entering jabber message ID

If a Jabber server has been configured, Jabber messages can be sent. Enter the Jabber ID from the server here.

Click Update profile at the bottom of the page to save your changes.

6.2.4. E-mail

To receive messages via e-mail, enter the e-mail address you wish messages to be sent to. The default e-mail being used is displayed.

Click Update profile at the bottom of the page to save your changes.

6.2.5. General Settings

Check to prevent people who are not contacts from messaging you.

Click Update profile at the bottom of the page to save your changes.

6.3. Administrator Documentation

6.3.1. Default Message Outputs

There is a dedicated menu item where administrator may configure default messaging settings. The menu contains the items for managing messaging outputs, defining default outputs and items for configuring particular outputs like activity stream, alert badge notifications, email and/or jabber.

This page summarises which messaging outputs (or processors) you have in the system. You may enable or disable a particular output and proceed to message output system configuration screen. The outputs that are not configured are highlighted and cannot be used in the system (they are not listed in messaging preferences configuration screens). Disabled outputs cannot be used in the system either.

Navigate to Site Administration>Plugins>Message outputs>Default message outputs

site administration menu with default message outputs link

The default message outputs page is a grid of message outputs (processors) across the top row and message types (providers) across the left column. The intersection cell of particular output and type contains default preferences for chosen messaging type and output.

grid with message out puts across top

Note: These messaging settings are independent from any messages configured and generated in PLD (Personalized Learning Designer). If you have messages configured in both you may received duplicate messages.

6.3.2. Outputs

There are currently 5 types of outputs:

  • Activity stream: is a user's history of events in the system. Messages are displayed via the Activity stream block.
    Note: We recommend enabling Activity stream and adding it to you course pages. Users should be familiar with a "news feed" source for information.
  • Popup notification: messages that grab the user's attention immediately in order for them to take action. Messages pop-up from the bottom of the screen.
  • Email: communicates information to the user when they are offline mostly and a user needs to interact with the communication outside of Moodle (forward, reply, document proof). Messages are sent to the users' e-mail addresses.
  • Alert badge notifications: communicates information that a user should be allowed to determine if they view it now or later, there is no requirement that they read it now. Messages are sent via the alert badge at the top of the page.
    Note: Express theme is needed for Alert badge notifications.
  • Jabber(optional): communicates information via instant messaging. If the Jabber server has been configured, Jabber messages can be sent. The Jabber ID can be set at the bottom of the screen.

When to receive messages:

  • Online: When checked, will send the message via the selected output type when a user is logged in to the system.
  • Not online: When checked, will send the message if the user is not logged into the system and will be displayed when the user logs back in.
Note: If Not online is not checked, Activity stream messages, Popup and Alert badge notifications, will not be sent when the user in not logged in and will not be displayed when they log back in.

The different outputs are defined below:

  • Assignment notifications: Notification sent to student informing that an assignment has been graded by the Teacher.
  • Warning when your quiz attempt becomes overdue: Notification sent to student informing that a quiz attempt became overdue.
  • Available update notifications: Notification sent to site administrators informing about the availability for plugin updates.
  • Backup notifications: Notification sent to the site administrator for site wide backups, upon their completion.
  • Confirmation of your own quiz submissions: Notification sent to student informing that a quiz has been submitted for grading.
  • Course creation request approval notifications: Notification sent to the site administrator and manager that a course creation request has been approved.
  • Course create request notification: Notification sent to the site administrator and manager that a course creation request has been submitted.
  • Course creation request rejection notifications: Notification sent to the site administrator and manager that a course creation request has not been approved.
  • Course grade changed: Notification sent to the manager, instructor and student informing that the course grade has changed for a student.
  • Important errors with the site: Notification sent to site administrators informing of errors that a user receives in the system (Moodle error message boxes).
  • Manual enrollment expiry notifications: Notifications sent to all roles informing that their manual enrollment are expiring.
  • Self enrollment expiry notifications: Notifications sent to all roles informing that their self enrollment are expiring.
  • Glossary entry changed: Notification sent to instructors and all students except the one that edited the glossary entry, informing that the glossary entry has changed.
  • Essay graded notifications: Notification sent to students informing that an essay has been graded.
  • Personal messages between users: Notifications sent to and from all roles with personal messages.
  • Feedback reminder: Notifications sent to students who have not responded to a feedback activity.
  • Joule Gradebook messages: Notifications sent to students from an instructor through the Joule Gradebook.
  • Activity updated or added Notifications sent to all roles informing that an activity in the course has been updated or added.
  • Activity completed: Notifications sent to students informing that activities have been completed.
  • Activity graded: Notifications sent to students informing that their instructor has graded an activity.
  • Notices about minor problems: Notifications sent to the site administrator informing them of notices users receive in the system (notice boxes in Moodle).
  • Subscribed forum posts: Notifications sent to all roles if subscribed to a forum that there has been a post or comment.
  • Subscribed advanced forum posts: Notifications sent to all roles if subscribed to an advanced forum that there has been a post or comment.
  • Feedback notifications: Notifications sent to students informing them that there is feedback from their teacher.
  • Notification of quiz submissions: Notifications sent to managers and instructors when quizzes are submitted.

6.3.3. Settings

The default preferences menu for each item is identical and allow administrator to choose permission and default setting when user is logged-in and offline. The possible preferences are:

Disallow: The message of chosen type will never be delivered through the chosen output, the user is not allowed to change the personal preference for this combination of message type and output.
Permitted: The message of chosen type is allowed to be delivered through the chosen output, default preferences can be set by administrator for delivery when the user is on/offline.
Forced: The message of chosen type will be delivered through the chosen output, user is not allowed to change the personal preference for this combination of message type and output.

6.3.4. Outputs Configuration

As it was mentioned earlier, the Message outputs menu contains the configuration for outputs that have system configuration settings. Unless output is configured, it cannot be used in the system.

Notes: Former settings Admin>Server>Emiail and Admin>Server>Jabber have been moved to Site administration>Plugins>Message outputs. Settings for "supportname", supportemail" and "supportpage" that were on the Email settings page were moved to Site administration>Server>Support contact.
6.3.4.1. Default Message Output Settings

These are the default settings that every Joule site has for messaging. You can configure/re-configure these settings to customize how your site handles messaging. 

All Joule sites have the following default message output settings:

Message Output Activity stream Popup notification Email Alert badge notification
Assignment notification Permitted Permitted Forced Permitted
Defaults Online ticked

none Online ticked

Online ticked

  Not online ticked none Not online ticked Not online ticked
         
Warning when your quiz attempt becomes overdue Permitted Permitted Permitted Permitted
  none none Online ticked none
  none none Not online ticked none
         
Available update notifications Permitted Permitted Permitted Permitted
  none none Online ticked none
  none none Not online ticked none
         
Backup notifications Permitted Permitted Permitted Permitted
Defaults none none Online ticked none
  none none
Not online ticked
none
         
Confirmation of your own quiz submissions Permitted Permitted Permitted Permitted
Defaults none none none none
         
Course creation request approval notification Permitted Permitted Permitted Permitted
Defaults Online ticked none Online ticked Online ticked
  Not online ticked   Not online ticked Not online ticked
         
Course creation request notification Permitted Permitted Permitted Permitted
Defaults Online ticked none Online ticked Online ticked
  Not online ticked 
  Not online ticked 
Not online ticked 
         
Course creation request rejection notification Permitted Permitted Permitted Permitted
Defaults Online ticked none Online ticked Online ticked
  Not online ticked  
  Not online ticked 
Not online ticked 
         
Course grade changed* Permitted Permitted Permitted Permitted
Defaults none none none none
         
Important errors with the site Permitted Permitted Permitted Permitted
Defaults none none Online ticked none
      Not online ticked
 
         
Manual enrollment expiry notifications Permitted Permitted Permitted Permitted
  none none Online ticked none
  none none Not online ticked none
         
Self enrollment expiry notifications Permitted Permitted Permitted Permitted
  none none Online ticked none
  none none Not online ticked none
         
Glossary entry changed Permitted Permitted Permitted Permitted
Defaults none none none none
         
Essay graded notification Permitted Permitted Permitted Permitted
Defaults Online ticked none none Online ticked
  Not online ticked     Not online ticked
         
Personal messages between users Permitted Permitted Permitted Permitted
Defaults Online ticked Online ticked Online ticked Online ticked
  Not online ticked none Not online ticked none
         
Feedback reminder Permitted Permitted Permitted Permitted
Defaults none none Online ticked Online ticked
      Not online ticked
Not online ticked
         
Joule Gradebook messages Permitted Permitted Permitted Permitted
Defaults Online ticked none Online ticked Online ticked
  Not online ticked   Not online ticked Not online ticked
         
Activity updated or added Permitted Permitted Permitted Permitted
Defaults none none none none
         
Activity completed Permitted Permitted Permitted Permitted
Defaults none none none none
         
Activity graded Permitted Permitted Permitted Permitted
Defaults Online ticked none none Online ticked
  Not online ticked     Not online ticked
         
Notices about minor problems Permitted Permitted Permitted Permitted
Defaults none none none none
         
Subscribed forum posts Permitted Permitted Forced Permitted
Defaults none none Online ticked none
      Not online ticked
 
         
Subscribed advanced forum posts Permitted Permitted Forced Permitted
Defaults none none Online ticked none
      Not online ticked
 
         
Feedback notifications Permitted Permitted Permitted Permitted
Defaults none none Online ticked none
      Not online ticked
 
         
Notification of quiz submissions. Permitted Permitted Permitted Permitted
Defaults none none none none
         
Note: These are the default settings. You can customize your messages to fit your needs by configuring these settings.

6.3.5. Best Practices

The following are some best practices for configuring message outputs in Joule:

  • Check online/not online for "Subscribed forum posts" under "Activity stream" to ensure that forum post information is visible in the Activity stream block.
  • If you are using Personalized Learning Designer, the "Course grade changed" setting should be "Forced" and disabled (both on/not online un-checked).
  • If you are using SCORM content that is worth more than one point and are using "Joule Gradebook notifications" the manager, instructor, and student roles may receive emails for every point entered in the Joule Gradebook from the SCORM.
  • If you are using "Sum of Grades" aggregation, students may e-mail you in the beginning of the course asking why they are receiving "F" alerts. They have only earned a small percentage of the total sum of grades. As they earn more their grade will go up.
  • For Higher Education and Corporate clients, you may want to configure all default message outputs to be "Permitted" and none "Forced" giving your users the choice to enable/disable them themselves.
  • For K-12 clients, you may want to set "Personal messages between users" to "Forced" under e-mail so their messages can be seen offline and they are less likely to miss them. You may want to set any other Default message outputs to "Forced" that you do not wish users to change.

6.4. Manage Message Outputs

This page summarises which messaging outputs (or processors) you have in the system. You may enable or disable a particular output and proceed to message output system configuration screen. The outputs that are not configured are highlighted and cannot be used in the system (they are not listed in messaging preferences configuration screens). Disabled outputs cannot be used in the system either.

6.4.1. Outputs

There are currently 5 types of outputs:

  • Activity stream: is a user's history of events in the system. Messages are displayed via the Activity stream block.
  • Popup notification: messages that grab the user's attention immediately in order for them to take action. Messages pop-up from the bottom of the screen.
  • Email: communicates information to the user when they are offline mostly and a user needs to interact with the communication outside of Moodle (forward, reply, document proof). Messages are sent to the users' e-mail addresses.
  • Alert badge notifications: communicates information that a user should be allowed to determine if they view it now or later, there is no requirement that they read it now. Messages are sent via the alert badge at the top of the page.
  • Jabber(optional): communicates information via instant messaging. If a Jabber server has been configured, Jabber messages can be sent. The Jabber ID can be set at the bottom of the screen.
Note: Activity stream and Alert badge notifications are Joule features and not part of core Moodle.

manage message outputs user interface

The outputs are listed in the chart along with the ability to enable/disable them as well as settings if the output is configurable.

Click on the eye icons to open/enable the message output or close/disable the message output.

Click on the Settings links to go to the settings for the output if it is configurable.

Your Rating: Results: PatheticBadOKGoodOutstanding! 5 rates
Adaptavist Theme Builder Powered by Atlassian Confluence