Smart Revision

What is a Smart Revision Course:

A smart revision course is designed to have a learner complete an assessment within a course to test their knowledge on a subject. If the learner passes the assessment the course will mark as complete and will not require the learner to revise any content within the course. However if the learner fails the assessment the course will direct them to the content within the course based on the questions they got incorrect within the course. 

The smart revision courses utilise a number of functions within the adapt builder to achieve this. Below is an a outline of the functions(settings/extensions) that are used to create a smart revision course. 

• Assessment extension
• Assisted Learning extension
• Learning Objectives extension
• Start Controller

The above extensions and setting will work together to automatically direct the user to an assessment within the course, if they fail they will be redirected to content within the course using the assisted learning and learning objectives.

Pre-requisites:

Before setting up the course to take advantage of the smart revision set up, their is a couple of things that you will want to have completed within the course prior to setting up the smart revision within the course. Firstly you will want to ensure that the course content has been fully built out, ie all content that is required to be within the course is added. 

You may also wish to move the assessment page within the course to the start of the course(as shown below) if it is not already set at the beginning. Although this is not necessary as start controller can direct the users to the correct page within the course regardless. 

Adding the extensions:

The next thing you will want to do within the course is to add your extensions, note if you use the assessment quick start option(highly recommended) to set up the assessment you do not need to add the assessment extension to the course as the assessment quick start will add the extension. 

Below will outline how to add the extensions:

• Access the course(either double click on the course or click on the cog wheel>edit).
• Go to extensions from the menu.
• Search for Assisted Learning and Learning Objectives extensions under available extensions section.
• Click the Add button next to the extension(s).

Note: If you wish to set the assessment up manually you will also want to add the assessment extension(and potentially the single submit extension if you wish to use it).

Once the correct extensions have been added to the course, the course is ready to be configured.

Configuring the course:

Configure the course assessment:

You will first want to set up the assessment within the course, if you have not already done so. As suggested above using the assessment quick start option is the recommended method to set the assessment up on the course. Below is an outline on how to use the quick start option.

• Go to the assessment page
• Click on the cog wheel within the article that contains your assessment questions
• Click on - Assessment quick-start

This will bring you to the quick start section where you can select the options for the assessment, below is an outline on each setting:

Tracking Type: Allows you to select the completion tracking for the course:

• Scorm - Primarily used within the LMS to tarck course completion(although can also be used within the LXP).
• xAPI - Used for tracking within the LXP.

Question Behaviour: Sets the pass mark within the course and the attempts allow, as well as question behaviour:

• Set Pass Mark - Enable the ability to set a pass mark(must be enabled to set pass mark).
• Pass Mark - The score which the learner must achieve to pass the assessment.
• Attempts Allowed - The number of attempts the user will have. 
• Question Submission - Sets if the learner will submit answer one at a time(per question) or all answers at the same time(At the end of the assessment - "single submit").
• Reset on revisit - If enabled will reset the questions if the learner returns to the course up to the number of available attempts.
• Randomise questions - Presents the questions within a random order to the learner.

Feedback:

• Show question feedback - Controls if the questions provide feedback to the learner(recommended to disable within smart revision courses).
• Show marking - Displays if the question has been answered correctly and if the selected answer is correct.
• Show model answer - Allows the learner to review the correct answers for the questions they get incorrect(recommended to disable within smart revision courses).
• Display results - Adds the assessment results block to the assessment page, will appear below the assessment (recommended to include if not using single submit).

Configure the Assisted Learning:

The assisted learning extension does not need much in the way of configuration however there is a number of settings that can be configured as to give a more personalised feel to the revision process and to give a better user experience:

Below is an outline of the settings within the extension:

• Enable Assisted Learning - Enables/disables the extension (ensure this is enabled).
• Display 'Code' in results - Will display the learning objective code within the results screen.
• Display message on pass of assessment - Enables/disables a message to confirm the learner has passed the assessment.
• Bypass results on retake - Returns the learner to the assessment when retake assessment is clicked, this will bypass the results page when retrying the assessment if enabled.
• Reset assessment on retake - Resets the assessment questions when the retake assessment is clicked on at the end of the revision.

In addition to the above settings there is a number of options to customise the messages that would be displayed to the learner from the assisted learning extension when they would be interacting with the content/assessment. Below is an outline of those settings:

• Assessment pass title - Title displayed within the assessment pass prompt
• Assessment pass body text - Body text that is displayed within the assessment pass prompt.
• Confirm exit title - Title displayed within the prompt when the revision exit button is clicked on.
• Confirm exit body text - Body text displayed within the prompt when the revision exit button is clicked on.
• Confirm revision title - Title that displays on the prompt that is shown when the "review" button is click next to an item within the revision page.
• Confirm revision body text - Body text that displays on the prompt that is shown when the "review" button is click next to an item within the revision page.
• Title text on the launch prompt - Title within the prompt that appears when the learner has failed the assessment.
• Body text on the launch prompt - Body text that appears within the prompt that appears before the revision when the learner fails the assessment.
• Start revision button text - Revision button that appears in the prompt that appears when the assessment is failed.
• Revision results title - Title for the results that are displayed within the revision page.
• Revision results body - Body text for the learners results that appears within the revision page.

Configure the Learning Objectives:

The learning objectives extension is used to link the questions within the assessment with the content throughout the course. To use the learning objectives these need to be set up within the extension and then applied throughout the course to the content and questions you wish to link together.

You will need to set the Learning Objectives up within the extension prior to setting them against the content, below is an outline on how to set the learning objectives up:

• Go to extensions.
• Click on settings next to the learning objectives extension.
• Ensure the - Enable learning objectives - toggle is enabled.
• Click on the - Add - button to create a learning objectives.

Once you have clicked to add a learning objectives there are some of settings that can be populate within the item. Below is an outline of the settings within the learning objectives item(s):

• Code - The code used throughout the course to associate content together (Required) .
• Title - The title of the learning objectives , best practice is to name it in relation to what it will be used against (Required) .
• Description - Allows to add a description for the learning objective, can be used to provide information as to what it has been used for/against within the course.
• Classes - Allows for optional CSS classes to be associated with the learning objectives.

The learning objectives extension has the ability to present a toast popup to advise the learner that all content associated with the learning objective has been completed. This can be found under the - Popup - section within the extension:

Note: You may not wish to use this option within the course, this is due to the fact that if a learning objectives is attached to multiple pieces of content within the course and has to complete the revision a second or third+ time, the popup will be triggered against each piece of content for that learning object as they go through the revision.

Below is an outline of the settings for the popup within the learning objectives extension:

• Enable achievement popup - Toggle to enable the popup.
• Duration time (in seconds) - The length of time the popup remains on screen.
• Template text - The text that will display within the pop.

Setting Learning Objectives within content:

Once you have added the extensions and configured your extensions and assessment, the learning objectives that had been created within the learning objectives extension need to be set against the content and assessment questions throughout the course.

Below is an outline on how you can apply the learning objectives to the content within the course:

• Go to the component you wish to add the learning objective against.
• Edit the component.
• Go to the extension section within the component.
• Expand the learning objectives extension.
• Add the learning objective "code" within the extension.
• Click on Save.

Note: Each learning objective should be added against a question within the assessment and the content throughout the course that relates to the question. The learning objective can be applied to multiple pieces of content.

 

Configuring the Start controller:

Setting the start controller within the course will allow for the course to open on the assessment page and disable the menu. This is recommended as to provide a seamless experience to the learner when undertaking a smart revision course and have the learner directed to only the relevant content within the course. 

Below is an outline on how you would be able to set up the start controller within the course:

• When viewing the course pages, click on the cog wheel in the top left of the assessment page and click on - copy ID to clipboard.
• Click on course settings.
• Go to - Start settings.
• Enable the start controller toggle.
• Under start list click on the - Add - button.
• Paste the ID copied from step 1 (ctrl+V or right click and paste)
• Click ok.
• Click Save.

Once the above has been completed the course will now be directed to the assessment page on launch. It is recommended to also disable the menu within the course. Under the Start settings there is a toggle for - Disable Menu - enable this toggle to disable the menu within the course.

Additional Notes:

There is some recommendations when setting up a smart revision course that have been highlighted below:

Extensions not to include within the course:

As to provide the best user experience with the content below is a list of extensions that is suggested to exclude from the course as they can break the follow of the course:

• Page incomplete prompt
• Page footer navigation
• Course exit confirmation
• Bookmarking
• Scroll Prompt

It may also be beneficial to disable the - Page level progress - extension at a page level for all pages outside the assessment page. As some learners may believe that they have other content to complete when being directed through the content from the revision. 

Do not use lock types:

It is highly recommended that you do not set a lock type within the course when setting up a smart revision course. If following the set up above, there is no need for a lock on any of the pages, the learner will not be able to navigate through the course outside of using the revision options and the course will always launch to the assessment page.

Content Order/Structure:

It is recommended that the order and structure of the content in the course follows the order in which they would relate to the questions within the assessment. This is to avoid issues where content could potentially be skipped when following the revision options. If content is set to mark on view it can cause issues where when reviewing material relating to another question could potentially mark it complete within the course. 

For example - If content that marks complete on view which relates to question 2 appears on page before content that relates to question 1 on the same page. When you review the content for question 1 through the revision option, the revision will force scroll past the content for question 2 and mark it as complete and when you access the revision for question 2 the content will not be presented as it is registered as completed.