The LearnDash Student Quiz Builder addon empowers users to create quizzes effortlessly. By simply selecting question categories from the site’s front end, users can create quizzes tailored to their preferences and practice questions at their own pace.
Video Tutorial
Watch the tutorial video below for a quick walkthrough of the add-on’s features and setup process.
For detailed instructions, please continue reading the full documentation. If you still have any questions, feel free to submit a support ticket.
Installation
- Install and activate the LearnDash plugin.
- Install and activate the LearnDash Student Quiz Builder.
- Two new submenus will be added to the LearnDash menu: “Student Quiz Builder” and “Quiz Builder Shortcodes”.
Activate Your License
You can activate the add-on’s license key from the “License Option” tab. Enter a valid license key in the corresponding field to receive automatic updates for this add-on.
Settings
Categories
Category
All the categories created using this add-on will be listed under the Categories tab. If you click on any category from this list, you will be redirected to the list of questions belonging to the selected category.
Note: The page opens in a new tab by default. You can enable the “Open category on current tab” option if you want to open the list of questions on the same page.
Select Categories
Here, you can enable the toggle to select specific categories to display in the frontend on the “[ld_quiz_builder]” shortcode. If this toggle is disabled, all categories will show in the shortcode for the users to select on the frontend when creating a quiz. If the toggle is enabled, the administrator must enable it for the categories from which users can create quizzes on the frontend using the “[ld_quiz_builder]” shortcode. Categories whose toggle is disabled will not appear on the frontend for users. Make sure to click the “Save Selection” button to save the toggle statuses of the parent and child categories.
Category Management
Manage Categories
In this sub-tab, the administrator can view, create new categories (using the “Add New Category” button), edit existing ones (using the “Edit” button), or delete (using the “Delete” button) those they no longer need. The administrator can add/edit the following information regarding the question categories in the “Category Information” section:
- Category Name
- Description (optional)
- Parent Category
After creating a new category or after editing any previously added category’s information, make sure to click the “Save” button to update the categories.
Link Questions
In this sub-tab, the administrator can search and filter questions (based on Quiz, LearnDash Category, and Question Title), then assign them to one or more multi-question categories (categories from our addon).
To link individual questions to a multi-question category, the steps are as follows:
- Select a multi-question category in the “Select Multi Category” dropdown.
- Filter the question list based on the 3 filters provided (Quiz, LearnDash Category and Question Title).
- When the “Apply Filters” button is pressed, in the “Assign Questions” section, the left selection box will be filled with questions based on the 3 filters and the right selection box will be filled with questions assigned to the multi-question category selected.
- Move the questions from the left selection box to the right selection box to assign them to the multi-question category selected. Similarly, to remove any question assigned to the multi-question category (selected), move the questions from the right selection box to the left selection box.
- Finally, click the “Save” button to update the question records assigned to the multi-question category.
- Clicking the “Clear” button will reset all the options selected in the dropdowns, along with both the selection boxes.
Map Categories
In this sub-tab, the administrator can create (using the “Add New Mapping” button), edit (using the “Edit” button), and remove (using the “Remove” button) mappings between “Multi Question Categories” and “LearnDash Default Categories”. With the Auto-Sync toggle enabled, questions added to a LearnDash category are automatically synced (added) to the corresponding Multi-Question Category.
The administrator can add/edit the following information regarding the question categories mapping in the “Mapping” section:
- Multi Question Category
- LearnDash Default Category
- Enable Auto-Sync
After creating a new category or after editing any previously added category’s information, make sure to click the “Save Mapping” button to update the category’s mapping information.
Whenever a LearnDash Default Category is assigned to a question, it checks and updates the Multi-Question Categories mapped to it that have the “Auto-Sync” option enabled. However, kindly note that if the LearnDash Default Category is unselected on the question edit page, the question will not be removed from the corresponding mapping Multi-Question Categories.
Note: One Multi-Question Category (From our addon) can be mapped with only one LearnDash Default Category at a time, but a LearnDash Default Category can be mapped with multiple Multi-Question Categories at the same time.
General Settings
Category Scores Student
Enabling this toggle will display category-specific scores on the frontend, once students complete their quiz.
Quiz Type
Here, you can select the type of quizzes that frontend users can create. You can choose from the options (“Test Quiz (deletes after 24 hours)”, “Real Quiz (permanent)” and “Both (user can choose)”).
If you select the options “Test Quiz (deletes after 24 hours)” and “Real Quiz (permanent)”, the UI of the “[ld_quiz_builder]” shortcode will look as follows at the bottom:
In the individual user profile tab, you will find that you will be able to view the statistics of a real quiz, but will not be able to view the statistics of a test quiz of a user. Also, the record of the test quiz of the user will disappear after 24 hours.
Similarly, if you select the option “Both (user can choose)”, the users will be able to select themselves if they want to create a test quiz or a real quiz. The UI of the “[ld_quiz_builder]” shortcode will look as follows:
Quiz Result Type
Here, you can select whether to display test and real quiz results at the end only or to display results after each submitted answer. The real and test quizzes created at runtime using the shortcode “[ld_quiz_builder]” will have their respective “Question Display” option settings set based on what the administrator has selected. The administrator can select from the following 2 options:
- Display results at the end only
- Display results after each submitted answer
Student Quizzes
In this tab, you will be able to view, edit, filter, and delete all the test quizzes and real quizzes of the following 4 statuses (“Published”, “Private”, “Pending”, and “Draft”). created by all the users from the “[ld_quiz_builder]” shortcode.
Shortcode
To create a quiz from the front end, you have to place the shortcode [ld_quiz_builder] on a page, where you want to allow users to create a quiz by drawing questions from the selected categories.
Note: Only the logged-in users will be able to view the content of the shortcode. Logged-out users will not see anything on the page.
Category Selection Mode:
Here, you can choose how users see the categories on the frontend. You can select the “List” option for the standard list view or the “Hierarchical” option for the tree view. In the List View, all categories appear in alphabetical order, regardless of hierarchy, whereas in the Hierarchical View, they appear according to the parent-child relationship.
Quiz Builder Shortcodes
Here in this submenu, you can create student quiz builder shortcodes with filtered categories based on your requirements. Students can only create quizzes using the selected categories in the shortcode on the frontend.
Creating Question Categories
- Navigate to “Questions” from the LearnDash menu and select the “Multiple Question Categories” option from the Action dropdown menu on the top right.
- Enter the category’s name, description and select a parent category, if any.
- Click the “Add new category” button.
You can also create categories by navigating to any question and using the “Multi Question Category” meta-box displayed on the right.
Assigning Question Categories
- Select the question you want to categorize from the LearnDash Question menu.
- Select the desired category for the question from the meta box displayed on the right. You can select more than one category for a single question.
- Click update.
Creating Quiz
- To create a quiz from the front end, navigate to the page where you added the shortcode.
- Next, select the categories whose questions you want to add to the quiz and then click on the forward arrow key.
- After selecting categories, click on the Next button. All of the available questions from the selected categories will be displayed.
- Select the number of questions you want to add from each category and then add a Quiz Name. If the administrator has selected the “Both (user can choose)” option in the backend then the logged-in user (on the frontend) can select whether they want to create a real quiz or a test quiz (This is an optional step).
- By clicking on the Generate Quiz, the Quiz will be generated and will be available for everyone to attempt without logging in to the site.
FAQ’s
Why don’t my questions appear under multiple categories when I assign them using the default “Question Category” meta box?
The “Question Category” meta-box is used with the default Question category functionality of LearnDash. You’ll have to use the “Multi Question Category” meta-box to use the add-on correctly.
No categories are displayed when we navigate to LearnDash LMS > Student Quiz Builder > Categories > Hierarchical Display.
Categories will only appear in the hierarchical display once multi-category support is enabled. To configure them, go to the “Questions” sub-menu in the LearnDash menu, then select “Multiple Question Categories” from the Action dropdown in the top-right. From there, you can create parent and child categories as needed, and they will appear under LearnDash LMS > Student Quiz Builder > Categories > Hierarchical Display.
Can I edit or delete Quizzes from the front end once created?
The quizzes can only be edited or deleted from the backend. You can not edit or delete Quizzes from the front end once created.
Can I control which users will access the Quiz?
The quiz will be public upon its creation, i.e., available for everyone. You cannot control which users will access the quiz.
Can I check the statistics of the Quiz from the front end?
Currently, you cannot see any statistics from the front end.
How does the addon handle the storage of quizzes (Test and Real) created by students in the database?
When a student creates a Test Quiz, a new entry is added to the database, but is automatically deleted after 24 hours to prevent database overload and maintain performance. Administrators also cannot view the statistics of Test Quizzes in the user’s profile. Once deleted, both the quiz and its attempt records are removed from the user’s profile page.
In contrast, Real Quizzes remain permanently stored in the database, and administrators can view their full statistics in the user’s profile page.
Changelogs
1.3.2
- Fix: Improved licensing module.
- Fix: Fixed taxonomy queries to only use the plugin’s own category taxonomy, preventing unintended category mixing.
- Fix: Fixed duplicate HTML attribute quote in binary selector option tag.
- Fix: Added direct access guard to quiz categories template.
- Fix: Made category fields grid responsive with improved input styling and spacing.
1.3.1
- New: Added shortcode feature for specific categories.
- Fix: Fixed RTL compatibility issue in categories UI.
1.3.0
- New: Added a category selection option for shortcode categories on the frontend.
- New: Added a category selection option that controls which categories are displayed on the frontend.
1.2.0
- New: Added “Manage Categories” feature to create and organize hierarchical question categories with parent-child relationships.
- New: Added “Link Questions” feature to assign questions to multiple categories with filtering by quiz, LearnDash category, or title.
- New: Added “Map Categories” feature to create mappings between Multi Question Categories and LearnDash Default Categories with auto-sync support.
1.1.3
- New – Added option to show results after each question or at quiz end, based on admin settings.
1.1.2
- Fix – Fixed all identified security vulnerabilities.
1.1.1
- Fix: Fixed UI for ‘Generate Quiz’ button on the front end.
1.1.0
- New: Added a new feature for users to create a real or test quiz based on admin settings.
- New: Added a “Student Quizzes” tab for admins to view student-created quizzes. Supports Redis for improved performance if available.
- Fix: Fixed the UI for plugin settings.
1.0.4
- Fix: Resolved compatibility issues with the LearnDash Multi Question Categories plugin.
1.0.3
- New: Added compatibility with the LearnDash Multi Question Categories plugin.
- New: Fixed the warning that appeared when searching questions with the category filter.
1.0.2
- New: Added general settings tab for admin.
1.0.1
- Fix: UI issues.
1.0.0
- Initial Release.
