| 1 |
<?php
|
| 2 |
// $Id: quiz.help.inc,v 1.3 2009/05/28 16:52:06 mbutcher Exp $
|
| 3 |
/**
|
| 4 |
* Help text.
|
| 5 |
*
|
| 6 |
* @file
|
| 7 |
* quiz help function
|
| 8 |
*/
|
| 9 |
|
| 10 |
/**
|
| 11 |
* Handle help calls.
|
| 12 |
* @see hook_help()
|
| 13 |
*/
|
| 14 |
function _quiz_help($path, $arg) {
|
| 15 |
switch ($path) {
|
| 16 |
case 'admin/help#quiz':
|
| 17 |
return t('
|
| 18 |
<h3>Description</h3>
|
| 19 |
<p>The quiz module allows users to administer a quiz, as a sequence of questions, and track the answers given. It allows for the creation of questions (and their answers), and organizes these questions into a quiz. Finally, it provides a mechanism for ensuring question quality through a combination of community revision and moderation. Its target audience includes educational institutions, online training programs, employers, and people who just want to add a fun activity for their visitors to their Drupal site.</p>
|
| 20 |
<h3>Creating Your First Quiz</h3>
|
| 21 |
<p>Creating an initial quiz requires three steps:</p>
|
| 22 |
<ol>
|
| 23 |
<li>Create at least one taxonomy vocabulary and assign it to the quiz and question type modules</li>
|
| 24 |
<li>Create a series of questions</li>
|
| 25 |
<li>Create a quiz based on the series of questions</li>
|
| 26 |
</ol>
|
| 27 |
<h4>Setting Quiz Permissions</h4>
|
| 28 |
<p>The quiz module and included multichoice module both have a plethora of permission options.<br />Unless you take care setting your permissions, the quiz module might not do everything you want it to do.</p>
|
| 29 |
<h5><strong><a href="@admin-access#module-quiz">Quiz Permissions</a></strong></h5>
|
| 30 |
<dl><dt><strong>access quiz</strong></dt>
|
| 31 |
<dd>allows users to take quizzes</dd>
|
| 32 |
<dt><strong>administer quiz</strong></dt>
|
| 33 |
<dd>allows users to edit quizzes</dd>
|
| 34 |
<dt><strong>administer quiz configuration</strong></dt>
|
| 35 |
<dd>allows users to use global admin settings, as well as override userresults if they don\'t have that permission. Can also delete quizzes</dd>
|
| 36 |
<dt><strong>create quiz</strong></dt>
|
| 37 |
<dd>Can create a new quiz</dd>
|
| 38 |
<dt><strong>user results</strong></dt>
|
| 39 |
<dd>Can view other user\'s results.</dd></dl>
|
| 40 |
<h5><strong><a href="@admin-access#module-multichoice">Multichoice Permissions</a></strong></h5>
|
| 41 |
<dl><dt><strong>allow any number of answers</strong></dt>
|
| 42 |
<dd>can submit questions with more than one correct answer.</dd>
|
| 43 |
<dt><strong>allow feedback</strong></dt>
|
| 44 |
<dd>Can create feedback when creating a new multichoice question.</dd>
|
| 45 |
<dt><strong>allow multiple correct answers</strong></dt>
|
| 46 |
<dd></dd>
|
| 47 |
<dt><strong>allow user titles</strong></dt>
|
| 48 |
<dd>Allows users to pick a name for their questions. Otherwise this is auto generated. The question name is never seen on the @quiz.</dd>
|
| 49 |
<dt><strong>create multichoice</strong></dt>
|
| 50 |
<dd>users can create multichoice questions</dd>
|
| 51 |
<dt><strong>edit own multichoice</strong></dt>
|
| 52 |
<dd>can edit their own multi-choice questions.</dd></dl>
|
| 53 |
<h4>Setting up a vocabulary</h4>
|
| 54 |
<ol>
|
| 55 |
<li>If not already enabled, go to the <a href="@admin-modules">Administer >> Site building >> Modules</a> section of the control panel and check the <strong>enable</strong> checkbox to enable the <strong>taxonomy module</strong>.</li>
|
| 56 |
<li>If you do not already have a taxonomy <strong>vocabulary</strong> suitable for quizzes, go to <a href="@admin-taxonomy">Administer >> Content management >> Categories</a> and create a vocabulary for quizzes (for example, <strong>Quiz Topics</strong>). Ensure that under <strong>Types</strong>, both <strong>quiz</strong> and all question types (for example, <strong>multichoice</strong>) are selected. Depending on your needs, you may wish to create a hierarchical vocabulary, so that topics can be sub-divided into smaller areas, and/or enable multiple select to associate quizzes and questions with more than one category.</li>
|
| 57 |
<li>Add a series of <strong>terms</strong> to the vocabulary to which questions and quizzes can be assigned. For example:
|
| 58 |
<ul>
|
| 59 |
<li>Literature
|
| 60 |
<ul>
|
| 61 |
<li>Children\'s books</li>
|
| 62 |
<li>Poetry</li>
|
| 63 |
<li>Shakespeare</li>
|
| 64 |
</ul>
|
| 65 |
</li>
|
| 66 |
<li>Mathematics
|
| 67 |
<ul>
|
| 68 |
<li>Algebra</li>
|
| 69 |
<li>Trigonometry</li>
|
| 70 |
<li>Calculus</li>
|
| 71 |
</ul>
|
| 72 |
</li>
|
| 73 |
<li>Information Technology
|
| 74 |
<ul>
|
| 75 |
<li>Hardware</li>
|
| 76 |
<li>Programming</li>
|
| 77 |
<li>Databases</li>
|
| 78 |
</ul>
|
| 79 |
</li>
|
| 80 |
</li>
|
| 81 |
</ol>
|
| 82 |
<h4>Creating quiz questions</h4>
|
| 83 |
<ol>
|
| 84 |
<li>Begin by clicking <a href="@create-content">Create content</a>, and then select a question type node (for example, <a href="@multichoice">multichoice</a>)</li>
|
| 85 |
<li>Fill out the question form. The presented interface will vary depending on the question type, but for multiple choice questions:
|
| 86 |
<dl>
|
| 87 |
<dt><strong>Title</strong></dt>
|
| 88 |
<dd>Question title. This will be displayed as the heading of the question.</dd>
|
| 89 |
<dt><strong>Taxonomy selection</strong></dt>
|
| 90 |
<dd>Any taxonomy vocabularies that are assigned to the question type will be displayed.</dd>
|
| 91 |
<dt><strong>Question</strong></dt>
|
| 92 |
<dd>The actual question text (for example, <strong>What is 2+2?</strong>).</dd>
|
| 93 |
<dt><strong>Multiple Answers</strong></dt>
|
| 94 |
<dd>Whether or not the question has multiple correct answers, such as a "Select all that apply" question.</dd>
|
| 95 |
<dt><strong>Correct</strong></dt>
|
| 96 |
<dd>Indicates that given answer is a correct answer.</dd>
|
| 97 |
<dt><strong>Answer</strong></dt>
|
| 98 |
<dd>An answer choice (for example, <strong>4</strong>). If more answers are required, check <strong>I need more answers</strong> and click the <b>Preview</b> button.</dd>
|
| 99 |
<dt><strong>Feedback</strong></dt>
|
| 100 |
<dd>Feedback, if supplied, will be provided to the user at the end of the quiz.</dd>
|
| 101 |
</dl>
|
| 102 |
</li>
|
| 103 |
<li>Repeat for each question you would like included on the quiz.</li>
|
| 104 |
</ol>
|
| 105 |
<h4>Creating the quiz</h4>
|
| 106 |
<ol>
|
| 107 |
<li>Go to <a href="@create-quiz">Create content >> Quiz</a> to access the quiz creation form.</li>
|
| 108 |
<li>Fill out the form to set the @quiz options:
|
| 109 |
<dl>
|
| 110 |
<dt><strong>Title</strong></dt>
|
| 111 |
<dd>Quiz title. This will be displayed as the heading of the quiz.</dd>
|
| 112 |
<dt><strong>Taxonomy selection</strong></dt>
|
| 113 |
<dd>Any taxonomy vocabularies that are assigned to the quiz type will be displayed. Select from the terms displayed in order to assign the quiz to vocabulary terms.</dd>
|
| 114 |
<dt><strong>Shuffle questions</strong></dt>
|
| 115 |
<dd>Whether or not to shuffle (randomize) the questions.</dd>
|
| 116 |
<dt><strong>Number of takes</strong></dt>
|
| 117 |
<dd>Number of takes to allow user. Varies from 1-9 or Unlimited times.</dd>
|
| 118 |
</dl>
|
| 119 |
</li>
|
| 120 |
<li>Once the quiz has been created, click the <b>add questions</b> tab to assign questions to the quiz.</li>
|
| 121 |
<li>Select a radio button next to each question indicating if the question should appear (Randomly, Always, or Never), and click <strong></strong>.</li>
|
| 122 |
<li>Repeat process until satisfied with question selection.</li>
|
| 123 |
</ol>
|
| 124 |
', array('@quiz' => QUIZ_NAME, '@admin-access' => url('admin/user/permissions'), '@admin-modules' => url('admin/build/modules'), '@admin-taxonomy' => url('admin/content/taxonomy'), '@create-content' => url('node/add'), '@multichoice' => url('node/add/multichoice'), '@create-quiz' => url('node/add/quiz')));
|
| 125 |
case 'node/add#quiz':
|
| 126 |
return t('A collection of questions designed to create interactive tests');
|
| 127 |
default:
|
| 128 |
break;
|
| 129 |
}
|
| 130 |
}
|
Parent Directory
| 
Revision Log
| 
Revision Graph