{"id":61,"date":"2023-05-22T19:06:26","date_gmt":"2023-05-22T19:06:26","guid":{"rendered":"https:\/\/hdplugins.com\/?post_type=documentation&#038;p=61"},"modified":"2026-02-08T14:20:15","modified_gmt":"2026-02-08T19:20:15","slug":"hd-quiz-documentation","status":"publish","type":"documentation","link":"https:\/\/hdplugins.com\/learn\/documentation\/hd-quiz-documentation\/","title":{"rendered":"HD Quiz Documentation"},"content":{"rendered":"\n<p>HD Quiz is a free quiz builder and one of the top-rated plugins on WordPress.org.<\/p>\n\n\n\n<p>You can request <a href=\"https:\/\/hdplugins.com\/forum\/hd-quiz-support\" data-type=\"URL\" data-id=\"https:\/\/hdplugins.com\/forum\/hd-quiz-support\">free support<\/a>, but please consider looking at the documentation first. Your Answer may lie within.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Common Features<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Free <strong>WordPress quiz plugin with timer<\/strong> functionality<\/li>\n\n\n\n<li>Unlimted number of quizzes, questions, and answers<\/li>\n\n\n\n<li>Multiple question formats (multiple choice, image, text input, select all that apply)<\/li>\n\n\n\n<li>Ability to share quiz results across social media<\/li>\n\n\n\n<li>Featured images, tooltips, reusable questions and so much more!<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Common Questions<\/h2>\n\n\n\n<details class=\"hdaccordion\"><summary class=\"hdaccordion__title\">How can I force users to answer every question?<\/summary><div class=\"hdaccordion__content\">\n<p>Edit your quiz and view quiz settings. Under the <strong>Marking<\/strong> tab, enable <strong>Force users to answer all questions<\/strong><\/p>\n<\/div><\/details>\n\n\n\n<details class=\"hdaccordion\"><summary class=\"hdaccordion__title\">Can I see how many times a quiz has been completed?<\/summary><div class=\"hdaccordion__content\">\n<p>By default, HD Quiz does not save or track <em>any<\/em> information from quiz takers, and thus is fully GDPR-compliant.<\/p>\n\n\n\n<p>HOWEVER, there is a <strong>100% FREE addon<\/strong> called <a href=\"https:\/\/wordpress.org\/plugins\/hd-quiz-save-results-light\/\">Save Results Light<\/a> (can be found under HD Quiz \u21fe Addons) that will save basic quiz data such as the quiz taker\u2019s name (only if they are logged in), quiz name, the score, if the quiz was passed or failed, and the date.<\/p>\n\n\n\n<p>There is also a <strong>paid Pro version of the addon<\/strong> Save Results Pro that allows for far more result tracking such as quiz taker name even if not logged in, result of each individual answer, quiz completion time, email notifications, leader board, and much more!<\/p>\n\n\n\n<figure class=\"wp-block-embed is-type-wp-embed is-provider-hdplugins wp-block-embed-hdplugins\"><div class=\"wp-block-embed__wrapper\">\n<blockquote class=\"wp-embedded-content\" data-secret=\"b61c0JGiql\"><a href=\"https:\/\/hdplugins.com\/product\/save-results-pro\/\">Save Results Pro<\/a><\/blockquote><iframe loading=\"lazy\" class=\"wp-embedded-content\" sandbox=\"allow-scripts\" security=\"restricted\" style=\"position: absolute; visibility: hidden;\" title=\"&#8220;Save Results Pro&#8221; &#8212; HDPlugins\" src=\"https:\/\/hdplugins.com\/product\/save-results-pro\/embed\/#?secret=41NTMi6dXl#?secret=b61c0JGiql\" data-secret=\"b61c0JGiql\" width=\"500\" height=\"282\" frameborder=\"0\" marginwidth=\"0\" marginheight=\"0\" scrolling=\"no\"><\/iframe>\n<\/div><\/figure>\n<\/div><\/details>\n\n\n\n<details class=\"hdaccordion\"><summary class=\"hdaccordion__title\">Can I stop users from retaking quizzes?<\/summary><div class=\"hdaccordion__content\">\n<p>You sure can with the 100% FREE Limit Attempts addon, found under HD Quiz \u21fe Addons.<\/p>\n\n\n\n<p>With this addon you can make it so that quizzes can only be completed by logged-in users, and\/or set a limit on how many times a quiz can be completed.<\/p>\n\n\n\n<figure class=\"wp-block-embed is-type-wp-embed is-provider-plugin-directory wp-block-embed-plugin-directory\"><div class=\"wp-block-embed__wrapper\">\n<blockquote class=\"wp-embedded-content\" data-secret=\"lZqPg9gu1J\"><a href=\"https:\/\/wordpress.org\/plugins\/hd-quiz-limit-attempts\/\">HD Quiz &#8211; Limit Attempts<\/a><\/blockquote><iframe loading=\"lazy\" class=\"wp-embedded-content\" sandbox=\"allow-scripts\" security=\"restricted\" style=\"position: absolute; visibility: hidden;\" title=\"&#8220;HD Quiz &#8211; Limit Attempts&#8221; &#8212; Plugin Directory\" src=\"https:\/\/wordpress.org\/plugins\/hd-quiz-limit-attempts\/embed\/#?secret=Hql1qWPbA1#?secret=lZqPg9gu1J\" data-secret=\"lZqPg9gu1J\" width=\"500\" height=\"282\" frameborder=\"0\" marginwidth=\"0\" marginheight=\"0\" scrolling=\"no\"><\/iframe>\n<\/div><\/figure>\n<\/div><\/details>\n\n\n\n<details class=\"hdaccordion\"><summary class=\"hdaccordion__title\">I have a problem with the CSV importer<\/summary><div class=\"hdaccordion__content\">\n<p>So far, EVERY single time there has been an issue, the cause has been one of the following.<\/p>\n\n\n\n<p><strong>Improperly formatted CSV<\/strong><\/p>\n\n\n\n<p>Make sure that your CSV is properly formatted. This isn\u2019t really something I can help you with, but I can recommend opening the CSV with Excel or Google Sheets to make sure the formatting is correct and then export as a CSV from there.<\/p>\n\n\n\n<p><strong>Import fails even with the provided demo CSV<\/strong><\/p>\n\n\n\n<p>If this happens, then the issue is almost certainly related to your host (or sometimes a security plugin you may have installed).<\/p>\n\n\n\n<p><strong>Make sure that the filename is unique<\/strong>. Sometimes hosts struggle when you upload a raw file with an existing filename. So try renaming your CSV file something A) unique, and B) something that has no spaces or special characters.<\/p>\n\n\n\n<p><strong>PHP Configuration.<\/strong> If you are getting a message like \u201cUploaded file was not a CSV\u201d, then it means that the file was <em>probably<\/em> uploaded OK, but your site was unable to safely determine the file type. We don\u2019t want to upload an executable script thinking it\u2019s a safe CSV file. If this is the case, the cause is that your host is probably missing some required PHP extensions to help determine MIME types. You will need to track down the missing extension yourself, but a common one is <code>fileinfo<\/code>. If using CPANEL, you can log into your account, and look for something similar to \u201c<em>Select PHP Version<\/em>\u201c. From here, look for an extension called \u201cfileinfo\u201d and make sure it is enabled. You may need to contact your host for further support.<\/p>\n\n\n\n<p><strong>Check your <code>tmp<\/code> folder.<\/strong> On shared hosting servers, your site shares the same resources as possibly hundreds of others. Every server has a folder called \u201ctmp\u201d (temporary) where uploaded files go to be secured and validated before being brought over to the place where your site actually lives. On cheaper or misconfigured hosting servers, this tmp folder can become filled, stopping you from consistently uploading files. You may need to contact your host to resolve this.<\/p>\n\n\n\n<p>If the above doesn\u2019t help you resolve the issue, and you are feeling adventurous, then you can take a look at this <a href=\"https:\/\/wordpress.org\/support\/topic\/error-the-uploaded-file-is-not-a-csv\/#post-16356180\">previous support thread<\/a> where I detail a possible workaround.<\/p>\n<\/div><\/details>\n\n\n\n<details class=\"hdaccordion\"><summary class=\"hdaccordion__title\">Can I enable server validation?<\/summary><div class=\"hdaccordion__content\">\n<p>HD Quiz never stores or sends any information to the server by default, unless an addon is installed. HD Quiz is meant for fun quizzes to add interaction and engagement to your sites, and all marking is done client-side, in your browser.<\/p>\n\n\n\n<p>If validating results is a hard requirement for you, then you will need to install some free addons and enable the <a href=\"https:\/\/hdplugins.com\/plugins\/hd-quiz\/hdq-server-validation.zip\">free Sever Validation addon<\/a>, or you can develop your own marking functionality. It is also recommended to use one of the Save Results addons (<a href=\"https:\/\/hdplugins.com\/hdadmin\/plugin-install.php?tab=plugin-information&amp;plugin=hd-quiz-save-results-light\">FR<\/a><a href=\"https:\/\/wordpress.org\/plugins\/hd-quiz-save-results-light\/\">E<\/a><a href=\"https:\/\/hdplugins.com\/hdadmin\/plugin-install.php?tab=plugin-information&amp;plugin=hd-quiz-save-results-light\">E<\/a>, <a href=\"https:\/\/hdplugins.com\/product\/save-results-pro\/\">PRO<\/a>)<\/p>\n<\/div><\/details>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-embed is-type-wp-embed is-provider-plugin-directory wp-block-embed-plugin-directory\"><div class=\"wp-block-embed__wrapper\">\n<blockquote class=\"wp-embedded-content\" data-secret=\"9gCn9CCZwB\"><a href=\"https:\/\/wordpress.org\/plugins\/hd-quiz\/\">HD Quiz<\/a><\/blockquote><iframe loading=\"lazy\" class=\"wp-embedded-content\" sandbox=\"allow-scripts\" security=\"restricted\" style=\"position: absolute; visibility: hidden;\" title=\"&#8220;HD Quiz&#8221; &#8212; Plugin Directory\" src=\"https:\/\/wordpress.org\/plugins\/hd-quiz\/embed\/#?secret=p0AJwYmVMb#?secret=9gCn9CCZwB\" data-secret=\"9gCn9CCZwB\" width=\"500\" height=\"282\" frameborder=\"0\" marginwidth=\"0\" marginheight=\"0\" scrolling=\"no\"><\/iframe>\n<\/div><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Demo \/ Tutorial Video<\/h3>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<div class = \"hdt_yt_embed\"><a href = \"https:\/\/www.youtube.com\/watch?v=YDyNDs3TdTs\" title = \"View video\" class = \"hdt_yt_link\" target = \"_blank\"><\/a><div class = \"hdt_yt_button_wrapper\"><svg class = \"hdt_yt_play_button\" version=\"1.1\" viewBox=\"0 0 68 48\"><path d=\"M66.52,7.74c-0.78-2.93-2.49-5.41-5.42-6.19C55.79,.13,34,0,34,0S12.21,.13,6.9,1.55 C3.97,2.33,2.27,4.81,1.48,7.74C0.06,13.05,0,24,0,24s0.06,10.95,1.48,16.26c0.78,2.93,2.49,5.41,5.42,6.19 C12.21,47.87,34,48,34,48s21.79-0.13,27.1-1.55c2.93-0.78,4.64-3.26,5.42-6.19C67.94,34.95,68,24,68,24S67.94,13.05,66.52,7.74z\" fill=\"#f03\"><\/path><path d=\"M 45,24 27,14 27,34\" fill=\"#fff\"><\/path><\/svg><\/div><div class = \"hdt_yt_thumbnail_wrapper\"><img class = \"hdt_yt_thumbnail\" src = \"https:\/\/img.youtube.com\/vi\/YDyNDs3TdTs\/sddefault.jpg\" alt = \"Youtube thumbnail\"\/><\/div><\/div>\n<\/div><\/figure>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"832\" height=\"448\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/hd-quiz.png\" alt=\"\" class=\"wp-image-62\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz.png 832w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-300x162.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-768x414.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-500x269.png 500w\" sizes=\"auto, (max-width: 832px) 100vw, 832px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">About \/ Options Page<\/h2>\n\n\n\n<p>The About \/ Options page is where you can edit some <strong>General Settings<\/strong> as well as<strong> Translate<\/strong> HD Quiz into your language. This page can be accessed by going to HD Quiz \u21fe About \/ Options.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">General Settings<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/hdplugins.com\/storage\/2023\/06\/hd-quiz-about-options-edited.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"939\" height=\"528\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/hd-quiz-about-options-edited.png\" alt=\"\" class=\"wp-image-1841\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-about-options-edited.png 939w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-about-options-edited-300x169.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-about-options-edited-768x432.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-about-options-edited-500x281.png 500w\" sizes=\"auto, (max-width: 939px) 100vw, 939px\" \/><\/a><figcaption class=\"wp-element-caption\">click to enlarge<\/figcaption><\/figure>\n\n\n\n<p>The general settings contain some global options that affect all quizzes. It is recommended that you pay this page a visit after first installing HD Quiz.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Social Share<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Facebook APP ID<\/strong> \u2013 This feature has now been deprecated because Facebook no longer allows the sharing of custom\/dynamic content.<\/li>\n\n\n\n<li><strong>Twitter Handle <\/strong>\u2013 You can enter your twitter handle so that HD Quiz can automatically reference you as the author when sharing via Twitter.<\/li>\n\n\n\n<li><strong>Share Text <\/strong>\u2013 The share text used by twitter. You can use the variables <code>%score%<\/code> and <code>%name<\/code> to reference the quiz score and the quiz name respectively.<\/li>\n<\/ul>\n\n\n\n<p>As of HD Quiz v<code>1.8.10<\/code>, the share section will also include a button for &#8220;Web Share&#8221;. This button will only appear for compatible browsers. Web Share is a feature used primarily by smartphones to allow you to share text\/links to multiple apps, including Instagram, WhatsApp, Text Message, and Email.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Other Options<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Allow Authors Access To Create Quizzes<\/strong> &#8211; By default, only users with Editor access and above can create quizzes. Enable this to allow authors to create quizzes as well.<\/li>\n\n\n\n<li><strong>Enable Percent Results<\/strong> &#8211; By default results are only shown as a fraction <code>x \/ y<\/code>. Enable this to also show the percent <code>x%<\/code>.<\/li>\n\n\n\n<li><strong>Enable Legacy Scroll \u2013 Does<\/strong> your site use a sticky header that covers your questions? Enable this to use an older, slower scroll function &#8211; but one that allows an offset.<\/li>\n\n\n\n<li><strong>I \u2764\ufe0f HD Quiz <\/strong>\u2013 Love HD Quiz? Enable this feature to add a subtle link to the quiz results pointing towards HD Quiz. This is a great way to help support us!<\/li>\n\n\n\n<li><strong>Replace <code>the_content<\/code> filter for quizzes<\/strong> \u2013 Some plugins need to automatically add content to your site. This is usualy done using WordPress&#8217; <code>the_content<\/code> filter. This means that some plugins will also add their content to quiz results or the extra question text. Enable this to attempt to stop this behaviour.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Translations<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/hdplugins.com\/storage\/2023\/06\/hd-quiz-translations.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"944\" height=\"531\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/hd-quiz-translations-edited.png\" alt=\"\" class=\"wp-image-1843\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-translations-edited.png 944w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-translations-edited-300x169.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-translations-edited-768x432.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/hd-quiz-translations-edited-500x281.png 500w\" sizes=\"auto, (max-width: 944px) 100vw, 944px\" \/><\/a><figcaption class=\"wp-element-caption\">click to enlarge<\/figcaption><\/figure>\n\n\n\n<p>Do you need to rename a button? Do you need to translate HD Quiz into your language? This is the section you need.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Rename &#8220;Finish&#8221;.<\/li>\n\n\n\n<li>Rename &#8220;Next&#8221;.<\/li>\n\n\n\n<li>Rename &#8220;Results&#8221;.<\/li>\n\n\n\n<li>Rename &#8220;Quiz Start&#8221;.<\/li>\n\n\n\n<li>Rename &#8220;enter answer here&#8221;.<\/li>\n\n\n\n<li>Rename &#8220;Select all that apply&#8221;.<\/li>\n<\/ul>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Quiz Settings<\/h2>\n\n\n\n<p>To edit your individual quiz settings, select your desired quiz, then select the QUIZ SETTINGS tab. From here you will be able to customize most aspects of your quiz.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Results<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/hdplugins.com\/storage\/2023\/06\/results.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"1219\" height=\"686\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/results-edited.png\" alt=\"\" class=\"wp-image-1850\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/results-edited.png 1219w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/results-edited-300x169.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/results-edited-1024x576.png 1024w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/results-edited-768x432.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/results-edited-500x281.png 500w\" sizes=\"auto, (max-width: 1219px) 100vw, 1219px\" \/><\/a><figcaption class=\"wp-element-caption\">click to enlarge<\/figcaption><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Quiz Pass Percentage<\/strong> \u2013 Change the minimum percentage of correct answers is required for the user to see the &#8220;Quiz Pass Text&#8221; content.<\/li>\n\n\n\n<li><strong>Hide all questions<\/strong> \u2013 Automatically hide all the questions once a quiz has been completed. This will show the results section only.<\/li>\n\n\n\n<li><strong>Quiz Pass Text<\/strong> \u2013 Custom content to show if a user passes the quiz. You can also place shortcodes, images, videos, buttons etc.<\/li>\n\n\n\n<li><strong>Quiz Fail Text<\/strong> \u2013 Custom content to show if a user fails the quiz. You can also place shortcodes, images, videos, buttons etc.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Marking<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/hdplugins.com\/storage\/2023\/06\/marking.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"571\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/marking-1024x571.png\" alt=\"\" class=\"wp-image-1846\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/marking-1024x571.png 1024w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/marking-300x167.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/marking-768x429.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/marking-500x279.png 500w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/marking.png 1215w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/a><figcaption class=\"wp-element-caption\">click to enlarge<\/figcaption><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Highlight correct \/ incorrect selected answers on completion<\/strong> \u2013 Enabled by default. Shows the user which questions they got correct, and which they got wrong.<\/li>\n\n\n\n<li><strong>Show the correct answers on completion<\/strong> \u2013 If the user got a question wrong, show what the correct answer was.<\/li>\n\n\n\n<li><strong>Immediately mark answer as correct or incorrect <\/strong>\u2013 Mark the question as soon as an answer has been selected.<\/li>\n\n\n\n<li>Stop users from changing their answers \u2013 Once an answer has been selected, it cannot be changed.<\/li>\n\n\n\n<li><strong>Always Show Incorrect Answer Text<\/strong> \u2013 Each question can have some &#8220;Extra&#8221; text that will appear if the user got the question wrong. Enable this so that the &#8220;Extra&#8221; text appears even when the answer was correct.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Timer<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/hdplugins.com\/storage\/2023\/06\/timer.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"396\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/timer-1024x396.png\" alt=\"\" class=\"wp-image-1847\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/timer-1024x396.png 1024w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/timer-300x116.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/timer-768x297.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/timer-500x193.png 500w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/timer.png 1216w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/a><figcaption class=\"wp-element-caption\">click to enlarge<\/figcaption><\/figure>\n\n\n\n<p>If the timer is enabled, quizzes will be hidden behind a &#8220;Start Quiz&#8221; button. This is so that the quiz timer does not countdown before the user is ready to begin the quiz.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Timer \/ Countdown<\/strong> \u2013 the time in seconds for the timer.<\/li>\n\n\n\n<li><strong>Per question<\/strong> \u2013 Enable if you want to timer to be per-question instead of for the whole quiz\n<ul class=\"wp-block-list\">\n<li>BONUS: If you want to <em>force<\/em> your users to answer every question, you can set this to a high value like <code>999<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/hdplugins.com\/storage\/2023\/06\/advanced.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"1231\" height=\"693\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/advanced-edited.png\" alt=\"\" class=\"wp-image-1849\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/advanced-edited.png 1231w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/advanced-edited-300x169.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/advanced-edited-1024x576.png 1024w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/advanced-edited-768x432.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/advanced-edited-500x281.png 500w\" sizes=\"auto, (max-width: 1231px) 100vw, 1231px\" \/><\/a><figcaption class=\"wp-element-caption\">click to enlarge<\/figcaption><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Share Quiz Results<\/strong> \u2013 Don&#8217;t want users to be able to share their results on Facebook or Twitter? Disable this.<\/li>\n\n\n\n<li><strong>Show Results Above or Below Quiz<\/strong> \u2013 By default, the results are located at the <em>top<\/em> of quizzes. This is so that once a quiz has completed, we can animate the page up <em>past the questions<\/em> to the results. This is beneficial because it is an intuitive way to inform your users that not only has a quiz completed, but that they can go and review their answers (assuming you have marking enabled).<\/li>\n\n\n\n<li><strong>Randomize Question Order<\/strong> \u2013 Randomizes the order of questions on every page load. NOTE: You will need to exclude the page from any page caching solution you have so that the questions can still randomize.<\/li>\n\n\n\n<li><strong>Randomize Answer Order<\/strong> \u2013 Randomizes the order of the answers on every page load. Like above, it is best to exclude from page caching if possible.<\/li>\n\n\n\n<li><strong>Use Pool of Questions<\/strong> \u2013 I think this is one of the coolest and most underrated features of HD Quiz. If you have, for example, 100 questions added to a quiz, but set this to 10, then HD Quiz will randomly grab 10 questions from that pool of 100 each time it loads. Combined with &#8220;Randomize Answer Order&#8221; this allows for a near unlimited number of quiz variations!<\/li>\n\n\n\n<li><strong>WP Pagination<\/strong> \u2013 Don&#8217;t use this.\n<ul class=\"wp-block-list\">\n<li>OK, I&#8217;m kidding, it&#8217;s OK to use, but because of the way that WordPress Queries work, this feature will not be compatible with some other quiz settings such as random question order or quiz timers, so use this feature at your own discretion.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Question Settings<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/hdplugins.com\/storage\/2023\/06\/questions.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"1231\" height=\"693\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/questions-edited.png\" alt=\"\" class=\"wp-image-1854\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-edited.png 1231w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-edited-300x169.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-edited-1024x576.png 1024w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-edited-768x432.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-edited-500x281.png 500w\" sizes=\"auto, (max-width: 1231px) 100vw, 1231px\" \/><\/a><figcaption class=\"wp-element-caption\">click to enlarge<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Question Title<\/h3>\n\n\n\n<p>It is recommended to only use plain text for question titles. At the end of the day, it usually results in a better user experience this way. However, for the stubborn tinkerers, you are able to use basic HTML formatting in the title such as <code>&lt;stong&gt;<\/code>, <code>&lt;em&gt;<\/code>,<code>&lt;sup&gt;<\/code>, <code>&lt;sub&gt;<\/code>, and <code>&lt;code&gt;<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Question Types<\/h3>\n\n\n\n<p>HD Quiz has multiple different question types, with more planned on the way!<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Multiple Choice: Text<\/strong> \u2013 Default multiple choice question type.<\/li>\n\n\n\n<li><strong>Multiple Choice: Image<\/strong> \u2013 Multiple choice, but each answer is also an image.<\/li>\n\n\n\n<li><strong>Select All That Apply: Text<\/strong> \u2013 Like multiple choice, but you can set more than one correct answer.\n<ul class=\"wp-block-list\">\n<li>The user will need to select <em>all<\/em> of the correct answers to be awarded the point.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Select All That Apply: Image<\/strong> \u2013 coming soon\u2122<\/li>\n\n\n\n<li><strong>Text Based Answers<\/strong> \u2013 User needs to type in their number.\n<ul class=\"wp-block-list\">\n<li>This is also compatible with <em>stemming<\/em>. For example, <code>dog*<\/code> will accept &#8220;dog, doggy, doge, dogged&#8221; etc as correct answers.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Use Question as Title<\/strong> \u2013 Useful if you want to separate your questions into categories. You can use a question as a heading.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Extra<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/hdplugins.com\/storage\/2023\/06\/questions-extra.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"1231\" height=\"693\" src=\"https:\/\/hdplugins.com\/storage\/2023\/06\/questions-extra-edited.png\" alt=\"\" class=\"wp-image-1855\" srcset=\"https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-extra-edited.png 1231w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-extra-edited-300x169.png 300w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-extra-edited-1024x576.png 1024w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-extra-edited-768x432.png 768w, https:\/\/hdplugins.com\/wp-content\/uploads\/2023\/06\/questions-extra-edited-500x281.png 500w\" sizes=\"auto, (max-width: 1231px) 100vw, 1231px\" \/><\/a><figcaption class=\"wp-element-caption\">click to enlarge<\/figcaption><\/figure>\n\n\n\n<p>First off, I&#8217;m not a fan of the name &#8220;Extra&#8221;. I feel like many of you think that there is nothing important behind here, but there is some cool stuff hidden on this tab! Things such as&#8230;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Paginate<\/strong> \u2013 Start a new page with this question. This question, and all questions below it, will be hidden behind a &#8220;next&#8221; button. Great feature for helping to categorize questions or to break up longer quizzes into shorter bites.<\/li>\n\n\n\n<li><strong>Tooltip text<\/strong> \u2013 You can add a tooltip to question titles to help provide some additional information or context.<\/li>\n\n\n\n<li><strong>Question Featured Image<\/strong> \u2013 Set a featured image for the question. The image will appear inside the question above the question title.<\/li>\n\n\n\n<li><strong>Text that appears if the user got the question wrong<\/strong> \u2013 This is the &#8220;Extra&#8221; text. There is also a quiz setting to force this to also appear even if the user gets the question correct.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Quizzes<\/h3>\n\n\n\n<p>A cool thing about how HD Quiz is built is that it works off of a <em>Post<\/em> \u21fe <em>Category<\/em> relationship. Just like how you can add a post to many categories on your WordPress blog, you can add the same question to multiple quizzes with HD Quiz!<\/p>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Advanced<\/h2>\n\n\n\n<p>You&#8217;ve made it this far? Fantastic! It&#8217;s just you and me now, so we can get into some of the good stuff. The hidden secrets of HD Quiz. Just note that for some of these things, you will need to be able to add code to your site. So as ALWAYS, backup any file you edit first!<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Secret Settings<\/h3>\n\n\n\n<p><strong><code>HDQ_SECURE_ANSWERS<\/code><\/strong> \u2013 This is a definition that will prevent the value from being printed directly on the page. Used if you want to make your own marking functionality. You can set this definition in your <code>functions.php<\/code> file.<\/p>\n\n\n\n<p><code><strong>HDQ_REDIRECT<\/strong><\/code>\u2063 \u2013 This is a <em>definition<\/em> that will automatically redirect HD Quiz to the proper page if a quiz loads in a weird place such as a category page, search page, sidebar, etc. This is done to ensure the best compatibility, since only one quiz can be on a page at a time. If for whatever reason you need to disable this, set <code>define('HDQ_REDIRECT', false);<\/code> in your <code>functions.php<\/code> file.<\/p>\n\n\n\n<p><code><strong>HDQ_PER_PAGE<\/strong><\/code>\u2063 \u2013 This is a <em>definition<\/em> that sets the pagination limit in the admin area of HD Quiz. If you have a lot of questions added to a single quiz, the page can get long. Set <code>define('HDQ_PER_PAGE', 200);<\/code> in your <code>functions.php<\/code> file, replace <code>200<\/code> with whatever number you prefer.<\/p>\n\n\n\n<p><code><strong>HDQ_MAX_ANSWERS<\/strong><\/code>\u2063 \u2013 This is a <em>definition<\/em> that sets the max number of answers per question. By default, this is <code>10<\/code>, but you can set <code>define('HDQ_MAX_ANSWERS', 10);<\/code> to whatever number you want in your theme&#8217;s <code>functions.php<\/code> file.<\/p>\n\n\n\n<p><code><strong>HDQ_EDIT_AUTHORED<\/strong><\/code> \u2013 This is a <em>definition<\/em> that makes it so that the admin quizzes page only lists quizzes authored by the current user. This combines great with the &#8220;Allow Authors Access To Create Quizzes&#8221; feature to stop users from editing each others quizzes. Admins are of course excluded from this and can always see\/edit quizzes. Set <code>define('HDQ_EDIT_AUTHORED', true);<\/code> in your functions.php file. NOTE: This will only work for quizzes created with HD Quiz <code>v1.8.10<\/code>+<\/p>\n\n\n\n<p><code><strong>HDQ_FORCE_ORDER<\/strong><\/code> \u2013 Force query order (order of questions) on quizzes. Useful if you have another plugin or theme function that is setting query orders.<\/p>\n\n\n\n<p><code><strong>HDQ_TWITTER_SHARE_ICON<\/strong><\/code> \u2013 Set to <code>true<\/code> to use the old Twitter share icon instead of the new X icon. Glory to the bird!<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Actions, Hooks, and Filters<\/h2>\n\n\n\n<p><code><strong>hdq_before<\/strong><\/code>\u2063 \u2013 This is an <em><a href=\"https:\/\/developer.wordpress.org\/reference\/functions\/add_action\/\" data-type=\"URL\" data-id=\"https:\/\/developer.wordpress.org\/reference\/functions\/add_action\/\">action<\/a><\/em> that allows you to add custom content before a quiz. It accepts a single argument, <code>$quiz_ID<\/code><\/p>\n\n\n\n<p><code><strong>hdq_after<\/strong><\/code>\u2063 \u2013 This is an <em><a href=\"https:\/\/developer.wordpress.org\/reference\/functions\/add_action\/\" data-type=\"URL\" data-id=\"https:\/\/developer.wordpress.org\/reference\/functions\/add_action\/\">action<\/a><\/em> that allows you to add custom content after a quiz. It accepts a single argument, <code>$quiz_ID<\/code><\/p>\n\n\n\n<p><code><strong>hdq_after_featured_image<\/strong><\/code>\u2063 \u2013 action allows you to add custom content after the featured image and before the question title. Super useful if you want to add some custom media like video. It accepts <code>$question<\/code> as an argument, which is an array with relevant question data such as <code>question_id<\/code>, <code>quiz_id<\/code>, <code>question_type<\/code>, and all other related data such as the question answers, and settings.<\/p>\n\n\n\n<p><code><strong>hdq_set_question_number_symbol<\/strong><\/code> \u2013 This filter allows you to override the Question Number Symbol (defaults to <code>#<\/code>)<\/p>\n\n\n\n<p><code><strong>hdq_build_quiz<\/strong><\/code> \u2013 This filter returns either true or false to represent if the quiz should build or not. It accepts the <code>quiz_id<\/code> as the only parameter.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>HD Quiz is a free quiz builder for WordPress and one of the top-rated plugins on WordPress.org.<\/p>\n","protected":false},"featured_media":62,"comment_status":"closed","ping_status":"closed","template":"","tags":[50,51],"documentation_category":[37,10],"class_list":["post-61","documentation","type-documentation","status-publish","has-post-thumbnail","hentry","tag-documentation","tag-hd-quiz","documentation_category-documentation","documentation_category-hd-quiz"],"_links":{"self":[{"href":"https:\/\/hdplugins.com\/hdapi\/wp\/v2\/documentation\/61","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hdplugins.com\/hdapi\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/hdplugins.com\/hdapi\/wp\/v2\/types\/documentation"}],"replies":[{"embeddable":true,"href":"https:\/\/hdplugins.com\/hdapi\/wp\/v2\/comments?post=61"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/hdplugins.com\/hdapi\/wp\/v2\/media\/62"}],"wp:attachment":[{"href":"https:\/\/hdplugins.com\/hdapi\/wp\/v2\/media?parent=61"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hdplugins.com\/hdapi\/wp\/v2\/tags?post=61"},{"taxonomy":"documentation_category","embeddable":true,"href":"https:\/\/hdplugins.com\/hdapi\/wp\/v2\/documentation_category?post=61"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}