• General Settings
• Quiz Setup
• Quiz Questions
• Quiz Settings
• Quiz Actions
• Quiz Shortcodes
• Quiz Results

—

General Settings

There is a General Settings section that covers a few Settings for all Quizzes.

—

Missing Quiz Message: This message will appear on the site if a Quiz gets removed from a page/post and someone comes across that page/post afterwards. It is recommended to remove a page/post that no longer includes a previously included Quiz.

User Not Logged In Message: This message will appear to a User if they are trying to access a Quiz but aren't logged in.

Quiz Taken Message: This message will appear to a User if they have already taken the Quiz.

—

Quiz Setup

The green plus icon on the top of the Quizzes section can be clicked to begin the Quiz building process.

—

The first step is to set a Title for the Quiz and click the green Apply button.

—

Once the Quiz has a Title, the additional sub tabs are available.

• Questions
• Settings
• Actions

—

Quiz Questions

Creating Questions within the Quiz comes next. Each Quiz will contain Questions.

Questions are added by using the blue Add Question button in the Questions sub tab. Enter the Question Title into the field and click the green Save button. You can repeat the process until all Questions are added.

—

The option to Add Answer is shown within each Question. Click the arrow icon to the left of the Question to display the circle plus icon to Add Answer.

—

Click the circle plus icon to add an Answer. Repeat the process until all Lessons are added.

—

You can then select the Correct Answer(s) by clicking the corresponding checkbox in the Correct column. You can also mouse over an Answer and click the edit Icon to edit the Answer.

The Up/Down arrow icon on the far right will also appear on mouse over. The arrows can be used to drag and drop the Answers into the preferred order.

An Answer can also be dragged and dropped into a different Quiz if desired. The Quiz would just need to be in expanded view to accept the Lesson.

Note: More than one Answer can be set as the Correct Answer.

—

You can add all Questions and Answers (and set all Correct Answers).

Quiz Settings

The Settings sub tab is used to configure specific settings for the Quiz.

Questions Per Page: The set number of Questions that will appear on one page of the Quiz. Example: The number is set to 10. If there are more than 10 Questions in the Quiz, the Quiz will be paginated with 10 pages appears on each page. If there are less than 10 Questions, the full Quiz will appear on one page.

Passing Score: The number of correct Answers needed to pass the Quiz. Example: The Passing Score is set to 5. A User must get at least 5 Questions correct in order to pass the Quiz.

Button Text: The Text that will appear on the submit button at the end of the Quiz.

The blue Save or green Save & Close button can be clicked once all Settings are configured.

—

Quiz Actions

A set of Actions can be configured to be executed after a User takes a Quiz.

The green Add Action button at the top of the Actions sub tab can be clicked to begin the process.

—

The Select the Action box will appear and the “When this happens…” “Then do this…” options can be set.

—

A Trigger is set (When a User Passes, When a User Fails) and the desired Action is set to be executed based on that Trigger.

The selected Action will provide additional options based on the type of Action selected.

In the example shown below, a User will get redirected to the selected page after passing a Quiz.

—

The newly created Action will now appear in the Actions list.

—

Quiz Shortcodes

A Quiz can be inserted into any page or post on the site. This is done by using the corresponding Quiz Shortcode.

A Quiz Shortcode can be copied from the Quizzes tab.

—

Once copied, the Quiz Shortcode can be inserted into a page or post.

—

That page or post will now show the Quiz on the live site and Users can take it.

—

Quiz Results

The Quiz Results section displays results from any Users who have taken any of the available Quizzes on the site.

Any selected Results can be deleted or exported to a .CSV file using the Select an Action dropdown.

—

Check out the Duplicate a Quiz Knowedgebase Article for additional information about Quizzes.

—

Back to Top

These are just a couple examples as there are many options available when using Quizzes and Courses.

—

Creating a Course and a Quiz

You will need to create a Quiz in the Quizzes section (if you haven't already created one). 

Once you have your Quiz created, you just need to add it to the Course of your choice. So a Course will also need to be created if you haven't done that yet.

More info on creating a Course can be found in the Courses Overview.

—

Adding a Quiz to a Course

Once you have at least one course and quiz created, you can add a quiz at any point to a Course. 

Click the Course Title or the pencil icon in the Courses > Course Builder section to edit the Course.

—

Click the arrow icon to the left of the Module to view the Lessons.

—

The Lessons within the Module will now be visible and you can click the “Add Quiz” button.

—

A field will appear that can be used to select the desired Quiz to be added. Any existing Quiz from the Quizzes section can be selected using this field.

—

Select the desired Quiz and click the green “Add Quiz” button. The Quiz will now be added to the last Lesson in the module.

—

The Up/Down arrow icon on the far right can be used to drag and drop the Quiz under the desired Lesson. This allows the Quiz to be added to any Lesson in the Module. The Quiz can also be dragged and dropped into a Lesson in another Module if desired. The Module would just need to be in expanded view to accept the Quiz.

—

The quiz has now been added to the lesson within the course and it can be viewed on the live site.

—

Back to Top

This allows you to make a copy of an existing Quiz and then simply edit/change the copy to create a new Quiz.

This is useful if you are creating similar Quizzes.

Example: You may have an existing Quiz that just needs some information updated to reflect some changes.

In that case, you could create a duplicate and only edit the content/sections that need to be updated.

—

The Duplicate Quiz icon appears when you mouse over the Quiz row in the Quizzes section.

—

Clicking the icon will create a copy of the Quiz and the new Title can be set.

Note: The default title of the new Quiz will be prefixed with “Copy of”. The title can be edited and the green Apply button can be clicked to create the new Quiz.

—

The newly created Quiz can now be edited to fit your needs. Each section can be edited or can remain the same depending on what you want to adjust.

—

All Questions, Answers, Settings, etc. within the Quiz will be duplicated.

—

Check out the Quiz Setup Overview Knowedgebase Article for additional information about Quizzes.

—

Back to Top

We are going to address the following question:

How can I set passing a Quiz be required to access the next Lesson in a Course?

You can protect the Lessons using WishList Member and set the specific Membership Level to access the protected content.

Next, you would set that same Membership Level to be added to the user once they pass the Quiz.

This same method of protection and access could also be applied to a Module.

—

This example will show the protection and access being set up using WishList Member with CourseCure. 

The first step is creating a Quiz and adding it to your Course. More details on adding a Quiz to a Course can be found in the Documentation Here. 

The Course can also be set as a Linear Course which would require the user to mark the current Lesson as complete before they can move onto the next Lesson. More details on this process can be found in the Documentation Here.

—

Setting Course Protection and Access

Once you have your Course created and the Quiz set under the Lesson of your choice, you can set up the protection and access so a user needs to pass that Quiz in order to access the next Lesson.

—

In this example, the Course is named “Learning to Skydive” and the first Module is named “The Basics”

We will be showing how to insert a Quiz after the first Lesson in the first Module of the Course. Passing the Quiz will be required to move onto the next Lesson.

—

The Lesson(s) after the Quiz can be set to protected and the user needing to have access to the set Membership Level(s) in order to access the protected Lesson(s).

Click the Open Lesson icon to edit the Protection and Access settings for that Lesson.

—

The Edit Lesson page will appear and the WishList Member section can be used to set the protection and access for the Lesson.

—

In this example, this now means a user must be logged in with the Gold Membership Level in order to access the “Preparing to Jump” Lesson.

Setting the Action in the Quiz

The next step is setting up an Action in the Quiz that will add the user to the Gold Membership Level when they pass the Quiz.

This can be setup in the Quizzes > *Click on Quiz to Edit* > Actions section of CourseCure.

Click the green Add Action button.

—

The Select the Action box will appear and the “When this happens…” “Then do this…” options can be set.

Select “When a User Passes” and “WishList Member – Add to Level”

You can then select the desired Membership Level(s) to add to the user when they pass the Quiz.

Click the blue Add Action button to create the Action.

—

The newly created Action will now appear in the Actions list.

—

This means a User will need to be logged in to take the Course and must pass the Quiz in order to access the next Lesson after the Quiz.

If the User passes the Quiz, they will be added to the Gold Membership Level based on the Action set for that Quiz and can then access the protected Lesson that requires the Gold Membership Level.

These Shortcodes cover a variety of topics like Quiz Results, Point Totals, Course Details, Badge List and much more.

—

The CourseCure Shortcode Inserter can be accessed using either of the following Gutenberg Blocks:

• Paragraph Block
• Shortcode Block

Paragraph Block

The Paragraph Block can be added to any page or post using the Gutenberg editor.

—

Once the Paragraph Block is inserted, the CourseCure icon can be used to access the library of CourseCure Shortcodes.

—

—

Note: The Shortcodes for each of the Add-ons that have been activated in the CourseCure Setup section will appear. In the screenshot example below, all Add-ons are enabled.

The desired Shortcode(s) can be selected and inserted from the list.

—

Shortcode Block

The Shortcode Block can be added to any page or post using the Gutenberg editor.

—

A Shortcode can be pasted into the field, or the CourseCure icon can be used to view the list of available CourseCure Shortcodes.

—

The CourseCure Shortcodes option will appear.

—

Note: The Shortcodes for each of the Add-ons that have been activated in the CourseCure Setup section will appear. In the screenshot example below, all Add-ons are enabled.

The desired Shortcode(s) can be selected and inserted from the list.

—

More details on each Shortcode can be found in the Summary of CourseCure Shortcodes article.

Back to Top

CourseCure Shortcodes:

Courses
Quizzes
Badges
Points

—

Courses

• Course ArchiveShortcode: Displays the selected Courses on the site. There is a variety of additional settings that can be configured using the available dropdowns within the Shortcode Creator.
  
  • Course Access. Select if All Users can view the Archive or only Users With Access to the Courses can view the Archive.
  • Course Category. Select if Courses within All Categories are displayed or only Courses within the selected Category are displayed.
  • Course Difficulty. Select if Courses within All Difficulties are displayed or only Courses within the selected Difficulty are displayed.
  • Columns. Select the number of Columns to be displayed. If Default is selected, the number of Columns is 3.
  • Display Search Bar. Select if the Search Bar should or should not be displayed on the Archive. If Default is selected, the setting in the Courses > Settings > Layout section will determine if the Search Bar is displayed or not.
  • Preview. The Shortcode is automatically adjusted based on the selected settings.

Shortcode: [wishlist_courses_archive access="all" category="0" difficulty="0" column="default" searchbar="default"]

—

Note: The example screenshot below shows the Course Archive Shortcode configured to display to All Users, Courses in the Overall Category, Courses in All Difficulties using the Default Columns and Default Search Bar settings.

[wishlist_courses_archive access="all" category="65" difficulty="0" column="default" searchbar="default"]

—

Quizzes

• Quiz Codes: Inserts the selected Quiz onto the page or post.
  
  • Select Quiz: Select the desired Quiz to insert. The fully configured Quiz will be inserted and displayed on the live site.

Shortcode: [WLQuiz id="1"]

—

• Quiz Name: Displays the name of the Quiz on the page or post. The Quiz Name will be displayed on the live site.

Shortcode: [WLQuiz_Name]

—

• Quiz Score: Displays the Quiz Score to the User. The specific Quiz Score for the User viewing the page or post will be displayed on the live site.

Shortcode: [WLQuiz_Score]

—

• Passing Score: Displays the Score needed to Pass the Quiz. The set Quiz Score required to Pass the Quiz will be displayed on the live site.

Shortcode: [WLQuiz_Passing_Score]

—

• Perfect Score: Displays the Perfect Score for the Quiz. The set Quiz Perfect Score will be displayed on the live site.

Shortcode: [WLQuiz_Perfect_Score]

—

• Total Questions: Displays the Total Number of Questions for the Quiz. The set Total Number of Questions within the Quiz will be displayed on the live site.

Shortcode: [WLQuiz_Total_Questions]

—

• Total Correct Questions: Displays the Total Number of Correct Answers to the User. The set Total Number of Correct Answers within the Quiz will be displayed on the live site.

Shortcode: [WLQuiz_Total_Correct_Answers]

—

• Total Incorrect Questions: Displays the Total Number of Incorrect Answers to the User. The set Total Number of Incorrect Answers within the Quiz will be displayed on the live site.

Shortcode: [WLQuiz_Total_Incorrect_Answers]

—

Badges

• Badges: Inserts the list of Badges onto the page or post.
  
  • Badge Size: Select the desired size of the Badges
  • Sort Badges by: Select if Badges should be Sorted by Newest or Oldest.
  • Type of Badge: Select if displayed Badges are Earned or Unearned (or Combined)
  • Badges Column #: Set the number of Columns to be displayed.

Shortcode: [wl_badges size="medium" sort="newest" type="showall" col="3"]

—

Points

• Lifetime Points: Displays the total number of all Points ever earned by the User.

Shortcode: [wlpts_lifetime_points]

—

• Remaining Points: Displays the number of available Points the User has Remaining.

Shortcode: [wlpts_remaining_points]

—

• Redeemed Points: Displays the total number of Points ever Redeemed by the User.

Shortcode: [wlpts_redeemed_points]

—

• User Points Logs: Displays a table showing the full Logs of Points Transactions by the User.

Shortcode: [wlpts_user_logs]

—

• Redemption Buttons: Select and insert a Button Users can use to Redeem Points.
  
  • Select Redemption Rule: Select the desired Redemption Rule for the Button.

Shortcode: [points_addon_redeem id="4"]

—

Back to Top

==========

/**
* Fires after the user passes a quiz
*
* @param integer $quiz_id – Quiz Id
* @param integer current_user->ID – User ID
*/
do_action( ‘wl_quiz_passed', $quiz_id, $current_user->ID );

/**
* Fires after the user fails a quiz
*
* @param integer $quiz_id – Quiz Id
* @param integer current_user->ID – User ID
*/
do_action( ‘wl_quiz_failed', $quiz_id, $current_user->ID );

/**
* Fires after the user completes a quiz
*
* @param integer $quiz_id – Quiz Id
* @param integer current_user->ID – User ID
*/
do_action( ‘wl_quiz_wl_quiz_completed', $quiz_id, $current_user->ID );

/**
* Fires when a quiz added to a lesson is marked completed
* @param integer current_user->ID – User ID
* @param integer $course_id – Parent Course ID of the quiz.
*/
do_action( ‘wlcourses_contents_marked_completed', $current_user->ID, $course_id, ‘wlcourses');

/**
* Fires when a quiz added to a lesson is marked completed
* @param integer current_user->ID – User ID
* @param integer $module_id – Parent Module ID of the quiz.
*/
do_action( ‘wlcourses_contents_marked_completed', $current_user->ID, $module_id, ‘wlmodule');

—

More info on Hooks can be found in the following articles:

Hooks – Badges
Hooks – Points
Hooks – Courses

—

Back to Top