• 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.

CourseCure includes a number of helpful shortcodes that can be used to display various pieces of information to users. These shortcodes cover a variety of topics ranging from Quiz Results and Point Totals to Course Details, Badge Lists and much more. You can easily insert a shortcode onto any page of your site and the corresponding information will be automatically displayed to your members.

—

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

• Paragraph Block
• Shortcode Block

You can also create and access any WishList Member or CourseCure shortcodes using the Shortcode Creator.

CourseCure Shortcode Inserter – Gutenberg 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.

—

The CourseCure Shortcodes selector appears and you can choose any available shortcode to insert into the page.

—

The shortcodes for each of the Add-ons that have been activated on the site will appear in the categorized list. The screenshot example below shows the Courses, Points, Badges and Quizzes Add-ons are activated.

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

—

The example below shows the Lifetime Points shortcode has been selected. The shortcode is displayed in the Preview section and the blue Insert button can be clicked to insert the shortcode into the page.

—

The Lifetime Points shortcode has now been inserted into the page. Once the page has been saved, the corresponding information for that shortcode will appear on the live site.

—

CourseCure Shortcode Inserter – Gutenberg Shortcode Block

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

—

A shortcode can be manually pasted into the field. You can also use the CourseCure icon to view the list of available CourseCure shortcodes and select one from the list.

—

The CourseCure shortcodes option will appear.

—

The shortcodes for each of the Add-ons that have been activated on the site will appear. In the screenshot example below, the Courses, Points, Badges and Quizzes Add-ons are activated.

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

—

The example below shows the Quiz Score shortcode has been selected. The shortcode is displayed in the Preview section and the blue Insert button can be clicked to insert the shortcode into the page.

—

The Quiz Score shortcode has now been inserted into the page. Once the page has been saved, the corresponding information for that shortcode will appear on the live site.

—

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

Back to Top

Each CourseCure Add-on has it's own set of shortcodes and corresponding functionality. These shortcodes convert simple text codes into dynamic content and you don't need to be a coder to use them. This article will run through a brief summary of available shortcodes to help show what can be done when using CourseCure on your site. These shortcodes provide you with an easy and effective way to customize your site for your members to experience.

Additional details on how to insert a shortcode using the CourseCure Shortcode Inserter can be found in the Shortcode Inserter article.

—

There are 4 Add-ons that will be the focus of this article and you can jump to more info on any of the following at any time.

• The Courses Add-on
• The Quizzes Add-on
• The Badges Add-on
• The Points Add-on

—

All the available shortcodes can be accessed by clicking the CourseCure icon in the Gutenberg editor. The CourseCure Shortcodes dropdown appears and you can select any one to get started.

—

Courses Shortcodes

• Course Library Shortcode. Displays the library of courses on the site. There is also a variety of additional settings that can be configured using the available dropdowns within the Shortcode Creator once Course Library has been selected. Those settings include the following:
  
  
  • Course Access. Select if All users can view the course library or only users with Access to the courses can view the course library.
  • 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. This will control the appearance of the list of courses displayed on the page. 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 library. 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 and a preview is displayed in real time based on the selected settings.

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

—

The example screenshot below shows the Course Library shortcode configured to display to all users. It will only display the courses within the Overall category and with the Beginner difficulty. 5 columns and the search bar will also be displayed.

Shortcode: [wishlist_courses_archive access="all" category="65" difficulty="68" column="5" searchbar="yes"]

—

Quizzes Shortcodes

• Quiz Codes. Displays the selected quiz on 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 name you gave the quiz 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 specific user viewing the page or post will be displayed on the live site. This can be helpful as the user can easily view their score for the quiz they completed.

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. This can be helpful to display before users take the quiz so they can see what score they need to achieve in order to pass the quiz.

Shortcode: [WLQuiz_Passing_Score]

—

• Perfect Score. Displays the perfect score for the quiz. The perfect score that has been set for the quiz will be displayed on the live site. This can be helpful if you want to show what score is needed to achieve a perfect score for the quiz.

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. This can be helpful if you want users to know how many questions they can expect within the quiz. The users would be able to estimate the time they will need to complete the quiz if they have an idea of the amount of questions they will be answering.

Shortcode: [WLQuiz_Total_Questions]

—

• Total Correct Answers. Displays the total number of correct answers to the user. The set total number of correct answers from the quiz will be displayed on the live site. This can be helpful as it can encourage and motivate users based on the number of questions they got correct.

Shortcode: [WLQuiz_Total_Correct_Answers]

—

• Total Incorrect Answers. Displays the total number of incorrect answers to the user. The set total number of incorrect answers from the quiz will be displayed on the live site. Similar to displaying the total correct answers, displaying the total incorrect answers can also be helpful as it can encourage and motivate users based on the number of questions they got wrong.

Shortcode: [WLQuiz_Total_Incorrect_Answers]

—

Badges Shortcodes

• Badges. Displays the list of badges on 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 earned
  • Type of Badge: Select if displayed badges are Earned or Unearned (or Combined)
  • Badges Column #: Set the number of Columns to be displayed.
  • Preview. The shortcode is automatically adjusted and a preview is displayed in real time based on the selected settings.

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

—

The example screenshot below shows the Badges shortcode configured to display a list of badges sorted by the Oldest and showing badges using the Small size format. It will only display the badges that have been Earned by the user and the badges will be displayed in 4 columns.

Shortcode: [wl_badges size="small" sort="oldest" type="earned" col="4"]

—

Points Shortcodes

• Lifetime Points. Displays the total number of all points ever earned by the user. This includes any points that have been redeemed.

Shortcode: [wlpts_lifetime_points]

—

• Remaining Points. Displays the number of available points the user has remaining. As an example, if the user had 10 points and redeemed 3 points, they would have 7 remaining points.

Shortcode: [wlpts_remaining_points]

—

• Redeemed Points. Displays the total number of points ever redeemed by the user. As an example, if the user has redeemed 5 points today and had redeemed 10 points the week before and redeemed 15 points a month ago, the redeemed points would be 30.

Shortcode: [wlpts_redeemed_points]

—

• User Points Logs. Displays a table showing the full logs of points transactions by the user. This includes points earned and points redeemed.

Shortcode: [wlpts_user_logs]

—

• Redemption Buttons. Create and insert a button that can be used to redeem points.
  
  • Select Redemption Rule. Select the desired redemption rule for the button. The dropdown is populated by redemption rules that have been created in the Points Add-on.
  • Preview. The shortcode is automatically adjusted and a preview is displayed in real time based on the selected settings.

Shortcode: [points_addon_redeem id="4"]

—

The example screenshot below shows the Redemption Button shortcode configured to display a button to redeem the Bonus Post for a cost of 5 points.

The cost of the Bonus Post is set in the Points Rule.

Shortcode: [points_addon_redeem id="3"]

—

You can use any of the available shortcodes to easily display specific info to your members. This can include everything from their individual quiz results to their collected badges or points totals. This type of information can be used to help encourage member interaction within your membership. You can start using CourseCure shortcodes to keep members engaged and up to date within your site.

==========

/**
* 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