Commit 5fcefc97 authored by David Mudrak's avatar David Mudrak
Browse files

MDL-21695 question: replaced help files with new help strings

AMOS BEGIN
 HLP question/categoryparent.html,[parentcategory_help,core_question]
 HLP question/categories.html,[editcategories_help,core_question]
 HLP quiz/export.html,[exportquestions_help,core_question]
 HLP quiz/exportcategory.html,[exportcategory_help,core_question]
 HLP quiz/exportcategory.html,[exportcategory_help,core_question]
 HLP quiz/importcategory.html,[importcategory_help,core_question]
 HLP quiz/matchgrades.html,[matchgrades_help,core_question]
 HLP quiz/quiz/stoponerror.html,[stoponerror_help,core_question]
 HLP qtype_multichoice/multichoiceshuffle.html,[shuffleanswers_help,qtype_multichoice]
 HLP quiz/matchshuffle.html,[shuffle_help,qtype_match]
 HLP quiz/generalfeedback.html,[generalfeedback_help,mod_quiz]
AMOS END
parent 59c9d381
<h1>Calculated questions</h1>
<p>Calculated questions offers a way to create individual numerical question by the use of wildcards that are substituted with individual values when the quiz is taken.
<br />Below is a shrunken view of the main editing page with some example inputs:
</p>
<table><tbody>
<tr valign="top">
<th scope="col" align="right">Question:</th>
<td>
<textarea id="questiontext" name="questiontext" rows="5" cols="40">How much is {a} + {b} ?</textarea>
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Image to display:</th>
<td>
<select name="image"><option value="" selected="selected">None</option><option value="grevture.gif">grevture.gif</option></select>
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Correct Answer Formula:</th>
<td>
<input align="left" type="text" id="formula0" name="answer[]" size="20" value="{a} + {b}" />&nbsp;&nbsp;
<input type="hidden" name="fraction[]" value="1.0" />
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Tolerance:</th>
<td>
<input align="left" type="text" id="tolerance0&quot;" name="tolerance[]" size="15" value="0.01" />±
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Tolerance Type:</th>
<td>
<select name="tolerancetype[]"><option value="1" selected="selected">Relative</option><option value="2">Nominal</option><option value="3">Geometric</option></select>
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Significant Figures:</th>
<td>
<select name="correctanswerlength[]"><option value="1">1</option><option value="2" selected="selected">2</option><option value="3">3</option><option value="4">4</option><option value="5">5</option><option value="6">6</option><option value="7">7</option><option value="8">8</option><option value="9">9</option><option value="10">10</option></select>
</td>
</tr>
</tbody></table>
<p>
In the question text input and "Correct Answer Formula" {a} and {b} can be seen. These and any other {name} can be used as a wildcard that is substituted by some value when the quiz is taken. Also, the correct answer is calculated when the quiz is submitted using the expression in "Correct Answer Formula", which is calculated as a numerical expression after the substitution of the wildcards. The possible wildcard values are set or generated on a later page in "editing wizard" for calculated questions...
</p> <p>
The example formula uses the operator +. Other accepted operators are -*/ and % where % is the modulo operator. It is also possible to use some PHP-style mathematical function. Among these there are 24 single-argument function:<br /><b>
abs, acos, acosh, asin, asinh, atan, atanh, ceil, cos, cosh, deg2rad, exp, expm1, floor, log, log10, log1p, rad2deg, round, sin, sinh, sqrt, tan, tanh
</b><br />and two two-argument functions<br /><b>
atan2, pow
</b><br />and the functions <b>min</b> and <b>max</b> that can take two or more arguments. It is also possible to use the function <b>pi</b> that takes no arguments but do not forget the use the parentheses - the correct usage is <b>pi()</b>. Similarly the other function must have their argument(s) within parentheses. Possible usage is for example <b>sin({a}) + cos({b}) * 2</b>. It should not be any problem to wrap functions within each other like <b>cos(deg2rad({a} + 90))</b> etc.
<br />More details on how to use these PHP-style functions can be found in the <a target="phpmathdoc" href="http://www.php.net/manual/en/ref.math.php">documentation at the PHP web site</a>
</p> <p>
As for numerical questions it is possible to allow a margin within which all responses are accepted as correct. The "Tolerance" field is used for this. However, there are three different types of tolerances. These are <b>Relative, Nominal and Geometric</b>. If we say that the correct answer at quiz time is calculated to 200 and the tolerance is set to 0.5 then the different tolerance types work like this:
</p> <p><b>Relative:</b> A tolerance interval is calculated by multiplying the correct answer with 0.5, ie in this case we get 100 so for this tolerance the correct response must be between 100 and 300. (200 ± 100)<br />
This is useful if the magnitude of the correct answer can differ greatly between different wildcard values.
</p> <p><b>Nominal:</b> This is the simplest tolerance type but not very powerful. The correct response must be between 199.5 and 200.5 (200 ± 0.5)<br />
This tolerance type can be useful if the differences between different correct answers are small.
</p> <p><b>Geometric:</b> The upper limit of the tolerance interval is calculated as 200 + 0.5*200 and is the same as for the relative case. The lower limit is calculated as 200/(1 + 0.5). The correct response must then be between 133.33 and 300.<br />
This is useful for complex calculation that must have great tolerances where relative tolerances of 1 or more would be used for the upper limit but clearly not acceptable for the lower limit as it would make zero a correct answer for all cases.
</p> <p>
The field <b>Significant Figures</b> does only relate to how the correct answer should be presented in the review or the reports. Examples: If it is set to 3 then the correct answer 13.333 would be presented as 13.3; 1236 would be presented as 1240; 23 would be presented as 23.0 etc.
</p> <p>
The feedback field and the optional unit fields work just like they do for numerical questions.
</p>
\ No newline at end of file
<h1>Simple Calculated questions</h1>
<p>Simple Calculated questions which are a simplified version of calculated questions, offers a way to create individual numerical question by the use of wildcards that are substituted with individual values when the quiz is taken.
<br />Below is a shrunken view of the main editing page with some example inputs:
</p>
<table><tbody>
<tr valign="top">
<th scope="col" align="right">Question:</th>
<td>
<textarea id="questiontext" name="questiontext" rows="5" cols="40">How much is {a} + {b} ?</textarea>
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Image to display:</th>
<td>
<select name="image"><option value="" selected="selected">None</option><option value="grevture.gif">grevture.gif</option></select>
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Correct Answer Formula:</th>
<td>
<input align="left" type="text" id="formula0" name="answer[]" size="20" value="{a} + {b}" />&nbsp;&nbsp;
<input type="hidden" name="fraction[]" value="1.0" />
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Tolerance:</th>
<td>
<input align="left" type="text" id="tolerance0&quot;" name="tolerance[]" size="15" value="0.01" />±
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Tolerance Type:</th>
<td>
<select name="tolerancetype[]"><option value="1" selected="selected">Relative</option><option value="2">Nominal</option></select>
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Significant Figures:</th>
<td>
<select name="correctanswerlength[]"><option value="1">1</option><option value="2" selected="selected">2</option><option value="3">3</option><option value="4">4</option><option value="5">5</option><option value="6">6</option><option value="7">7</option><option value="8">8</option><option value="9">9</option><option value="10">10</option></select>
</td>
</tr>
</tbody></table>
<p>
In the question text input and "Correct Answer Formula" {a} and {b} can be seen. Only those in "Correct Answer Formula" can be used as a wildcard that is substituted by some value when the quiz is taken. Also, the correct answer is calculated when the quiz is submitted using the expression in "Correct Answer Formula", which is calculated as a numerical expression after the substitution of the wildcards.
The example formula uses the operator +. Other accepted operators are -*/ and % where % is the modulo operator. It is also possible to use some PHP-style mathematical function. Among these there are 24 single-argument function:<br /><b>
abs, acos, acosh, asin, asinh, atan, atanh, ceil, cos, cosh, deg2rad, exp, expm1, floor, log, log10, log1p, rad2deg, round, sin, sinh, sqrt, tan, tanh
</b><br />and two two-argument functions<br /><b>
atan2, pow
</b><br />and the functions <b>min</b> and <b>max</b> that can take two or more arguments. It is also possible to use the function <b>pi</b> that takes no arguments but do not forget the use the parentheses - the correct usage is <b>pi()</b>. Similarly the other function must have their argument(s) within parentheses. Possible usage is for example <b>sin({a}) + cos({b}) * 2</b>. It should not be any problem to wrap functions within each other like <b>cos(deg2rad({a} + 90))</b> etc.
<br />More details on how to use these PHP-style functions can be found in the <a target="phpmathdoc" href="http://www.php.net/manual/en/ref.math.php">documentation at the PHP web site</a>
</p> <p>
As for numerical questions it is possible to allow a margin within which all responses are accepted as correct. The "Tolerance" field is used for this. However, there are three different types of tolerances. These are <b>Relative, Nominal and Geometric</b>. If we say that the correct answer at quiz time is calculated to 200 and the tolerance is set to 0.5 then the different tolerance types work like this:
</p> <p><b>Relative:</b> A tolerance interval is calculated by multiplying the correct answer with 0.5, ie in this case we get 100 so for this tolerance the correct response must be between 100 and 300. (200 ± 100)<br />
This is useful if the magnitude of the correct answer can differ greatly between different wildcard values.
</p> <p><b>Nominal:</b> This is the simplest tolerance type but not very powerful. The correct response must be between 199.5 and 200.5 (200 ± 0.5)<br />
This tolerance type can be useful if the differences between different correct answers are small.
</p> <p>
The field <b>Significant Figures</b> does only relate to how the correct answer should be presented in the review or the reports. Examples: If it is set to 3 then the correct answer 13.333 would be presented as 13.3; 1236 would be presented as 1240; 23 would be presented as 23.0 etc.
</p> <p>
The feedback field and the optional unit fields work just like they do for numerical questions.
</p>
\ No newline at end of file
<h1>Description</h1>
<p>This type of question is not really a question. </p>
<p>All it does is print some text without requiring any answers.</p>
<p>It can be used to print a descriptive text to be used by a following group of questions.</p>
<p>The General feedback can be used if you have some text that you want to appear on the review
page only. The 'Question text' appears both during the attempt and on the review page.</p>
\ No newline at end of file
<h1>Essay questions</h1>
<p>In response to a question (that may include an image) the respondent writes
an answer in essay format. Three fields may be edited when creating the essay question:
the question title, the body of the question, and feedback that can be displayed at a time
chosen by the facilitator.</p>
<p>The essay question will not be assigned a grade until it has been reviewed by a teacher
question, the grader will be able to enter a custom comment in response the respondent's
essay and be able to assign a score for the essay.</p>
<p>Normally, the student can type their answer using the rich-text editor. However,
if there is more than one essay question on a page, the rich-text editor is
only used for the first essay question.</p>
\ No newline at end of file
<h1>Matching questions</h1>
<p>After an optional introduction, the respondent is presented with
several sub-questions and several jumbled answers. There is one
correct answer for each question.</p>
<p>The respondent must select an answer to match each sub-question.</p>
<p>Each sub-question is equally weighted to contribute towards the
grade for the total question.</p>
<h1>Embedded answers (Cloze)</h1>
<p>This very flexible question type is similar to a
popular format known as the Cloze format.</p>
<p>Questions consist of a passage of text (in Moodle format) that has various sub-questions
embedded within it, including</p>
<ul>
<li>short answers&nbsp;(SHORTANSWER or SA or MW), case is unimportant,</li>
<li>short answers&nbsp;(SHORTANSWER_C or SAC or MWC), case must match,</li>
<li>numerical answers (NUMERICAL or NM),</li>
<li>multiple choice (MULTICHOICE or MC), represented as a dropdown menu in-line in the text</li>
<li>multiple choice (MULTICHOICE_V or MCV), represented a vertical column of radio buttons, or</li>
<li>multiple choice (MULTICHOICE_H or MCH), represented as a horizontal row of radio-buttons.</li>
</ul>
<p>There is currently no graphical interface to create these
questions - you need to specify the question format using the text box or by
importing them from external files.</p>
<p>Here is an example of the input text used to specify such a question:</p>
<p>Note that for multiple choice vertical or horizontal rendering there is no automatic numbering. It can added at each answer as shown here.</p>
<p><textarea rows="25" cols="60">This question consists of some text with an answer embedded right here {1:MULTICHOICE:Wrong answer#Feedback for this wrong answer~Another wrong answer#Feedback for the other wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer} and right after that you will have to deal with this short answer {1:SHORTANSWER:Wrong answer#Feedback for this wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer} and finally we have a floating point number {2:NUMERICAL:=23.8:0.1#Feedback for correct answer 23.8~%50%23.8:2#Feedback for half credit answer in the nearby region of the correct answer}.
The multichoice question can also be shown in the vertical display of the standard moodle multiple choice.
{2:MCV:1. Wrong answer#Feedback for this wrong answer~2. Another wrong answer#Feedback for the other wrong answer~=3. Correct answer#Feedback for correct answer~%50%4. Answer that gives half the credit#Feedback for half credit answer}
Or in an horizontal display that is included here in a table
{2:MCH:a. Wrong answer#Feedback for this wrong answer~b. Another wrong answer#Feedback for the other wrong answer~=c. Correct answer#Feedback for correct answer~%50%d. Answer that gives half the credit#Feedback for half credit answer}
A shortanswer question where case must match. Write moodle in upper case letters {1:SHORTANSWER_C:moodle#Feedback for moodle in lower case ~=MOODLE#Feedback for MOODLE in upper case ~%50%Moodle#Feedback for only first letter in upper case}
Note that addresses like www.moodle.org and smileys :-) all work as normal:
a) How good is this? {:MULTICHOICE:=Yes#Correct~No#We have a different opinion}
b) What grade would you give it? {3:NUMERICAL:=3:2}
Good luck!
</textarea></p>
<p>This example will appear to students as follows:</p>
<div id="middle-column"><div><span id="maincontent"></span><div id="q6" class="que multianswer clearfix">
<div class="info">
<span class="accesshide">Question </span>1
<div class="grade">
Marks: --/13.00</div>
</div>
<div class="content">
<div class="ablock clearfix"><label>This question consists of some text with an answer embedded right here <span><select name="resp3796_1"><option
selected="selected"></option><option value="8919">Wrong answer</option><option value="8920">Another wrong answer</option><option value="8921">Correct answer</option><option value="8922">Answer that gives half the credit</option></select></span></label><label>and right after that you will have to deal with this short answer <input name="resp3796_2" size="33" /> </label><label> and finally we have a floating point number <input name="resp3796_3" size="4" /> </label>.<br />
<br />
The multichoice question can also be shown in the vertical display of the standard moodle multiple choice<br />
<br />
<table width="50%"><tbody><tr><td>
<table class="answer">
<tr class="r0">
<td class="c0 control">
<input id="resp3796_8960" name="resp3796_4" type="radio" value="8960" />
</td>
<td class="c1 text ">
<label for="resp3796_8960">
1. Wrong answer
</label>
</td>
<td class="c0 feedback">
</td>
</tr>
<tr class="r1">
<td class="c0 control">
<input id="resp3796_8961" name="resp3796_4" type="radio" value="8961" />
</td>
<td class="c1 text ">
<label for="resp3796_8961">
2. Another wrong answer
</label>
</td>
<td class="c0 feedback">
</td>
</tr>
<tr class="r0">
<td class="c0 control">
<input id="resp3796_8962" name="resp3796_4" type="radio" value="8962" />
</td>
<td class="c1 text ">
<label for="resp3796_8962">
3. Correct answer
</label>
</td>
<td class="c0 feedback">
</td>
</tr>
<tr class="r1">
<td class="c0 control">
<input id="resp3796_8963" name="resp3796_4" type="radio" value="8963" />
</td>
<td class="c1 text ">
<label for="resp3796_8963">
4. Answer that gives half the credit
</label>
</td>
<td class="c0 feedback">
</td>
</tr>
</table>
</td></tr></tbody></table>
<br />Or in an horizontal display that is included here in a table<br /><br />
<table class="answer">
<tr class="r0">
<td class="c0 control">
<input id="resp3796_8964" name="resp3796_5" type="radio" value="8964" />
</td>
<td class="c1 text ">
<label for="resp3796_8964">
a. Wrong answer
</label>
</td>
<td class="c0 feedback">
</td>
<td class="c0 control">
<input id="resp3796_8965" name="resp3796_5" type="radio" value="8965" />
</td>
<td class="c1 text ">
<label for="resp3796_8965">
b. Another wrong answer
</label>
</td>
<td class="c0 feedback">
</td>
<td class="c0 control">
<input id="resp3796_8966" name="resp3796_5" type="radio" value="8966" />
</td>
<td class="c1 text ">
<label for="resp3796_8966">
c. Correct answer
</label>
</td>
<td class="c0 feedback">
</td>
<td class="c0 control">
<input id="resp3796_8967" name="resp3796_5" type="radio" value="8967" />
</td>
<td class="c1 text ">
<label for="resp3796_8967">
d. Answer that gives half the credit
</label>
</td>
<td class="c0 feedback">
</td>
</tr>
</table>
<br />
A shortanswer question where case must match. Write moodle in upper case letters <input name="resp3435_6" type="text" value="" size="6" /> <br />
<br />Note that addresses like <a href="http://www.moodle.org" target="_blank">www.moodle.org</a> and smileys <img alt="smile" width="15" height="15" src="http://132.208.141.198/moodle_head/pix/s/smiley.gif" /> all work as normal:<br />
a) How good is this? <span><select name="resp3796_6"><option selected="selected"></option><option value="8968">Yes</option><option value="8969">No</option></select></span><label><br />
b) What grade would you give it? <input name="resp3796_7" size="1" /> </label><br /><br />Good luck!
</div>
<div class="grading">
</div>
</div>
</div></div></div>
<h1>Multiple Choice questions</h1>
<p>In response to a question (that may include a image) the respondent
chooses from multiple answers. There are two types of multiple choice
questions - single answer and multiple answer.</p>
<p>Single-answer questions allow one and only one answer to be chosen.
Generally all the grades for such a question should be positive.</p>
<p>Multiple-answer questions allow one or more answers to be chosen - each answer may carry a positive or negative grade, so that choosing ALL the options will not necessarily result in good grade. If the total grade is negative then the total grade for this question will be zero. Note that in a multiple-answer question, the grades must add up to 100%.</p>
<p>Finally, each answer (right or wrong) should include feedback - this feedback
will be shown to the respondent next to each of their answers (if the quiz
itself is configured to show feedback).
</p>
<h1>Shuffle answers</h1>
<p>If you set this option to &quot;Yes&quot;, then the order of the answers
is randomly shuffled each time a student starts an attempt at a quiz
containing this question - provided that &quot;Shuffle within questions&quot; in
the Quiz settings is set to &quot;Yes&quot;.</p>
<p>The intention is simply to make it a little harder for students
to copy from each other.</p>
\ No newline at end of file
<h1>Numerical questions</h1>
<p>From the student perspective, a numerical question looks just
like a short-answer question.</p>
<p>The difference is that numerical answers are allowed
to have an accepted error. This allows a continuous range of answers
to be set. For example, if the answer is 30 with an accepted error of 5,
then any number between 25 and 35 will be accepted as correct.</p>
<p>Like with short answer questions, different answers, or the same
answer with different precisions can be given. In this case, the first
matching answer is used to determine the score and the feedback.<p>
<p>To provide feedback for responses that do not match any of the answers
you entered, provide some feedback with a '*' in the answer box.</p>
\ No newline at end of file
<h1>Random Short-Answer Matching questions</h1>
<p>After an optional introduction, the respondent is presented with
several sub-questions and several jumbled answers. There is one
correct answer for each question.</p>
<p>The respondent must select an answer to match each sub-question.</p>
<p>Each sub-question is equally weighted to contribute towards the
grade for the total question.</p>
<p>The questions and answers are randomly drawn from the pool of
"Short Answer" questions in the current category. Each attempt
on a quiz may therefore have different questions and answers.
You must make sure that the category contains enough unused
short-answer questions, otherwise the student will be shown
a friendly error message. The more short-answer questions you
provide the more likely it is that students will see a new
selection on each attempt.</p>
<h1>Short Answer questions</h1>
<p>In response to a question (that may include a image) the respondent
types a word or short phrase.</p>
<p>There may be several possible correct answers, each with a different
grade. If the "Case sensitive" option is selected, then you can
have different scores for "Word" or "word".</p>
<p>You can use the asterisk character (*) as a <b>wildcard</b> to match
any series of characters. For example, use ran*ing to match any word
or phrase starting with "ran" and ending with "ing". If you really
do want to match an asterisk then use a backslash like this: \*</p>
<p>Without wildcards the answers are compared exactly, so be careful with your spelling!</p>
<h1>True/False questions</h1>
<p>In response to a question (that may include a image) the respondent
chooses from True or False.</p>
<p>If feedback is enabled, then the appropriate feedback message is
shown to the respondent after answering the quiz. For example,
if the correct answer is "False", but they answer "True" (getting
it wrong) then the "True" feedback is shown.
</p>
<h1>Question categories</h1>
<p>Rather than keeping all your questions in one big list,
you can create categories to keep them in.</p>
<p>Categories can be created or deleted at will. But:</p>
<ul><li> There must be at least one category in each context. So you
cannot delete the last category in a context.</li>
<li>When you try to delete a category containing
questions, then you will be asked to specify another
category to move them to.</li></ul>
<p>You can arrange your categories in a hierarchy so
that they are easier to manage. Editing categories is done under the 'Categories'
tab in the question bank.</p>
<ul>
<li>On the main page under the 'Categories' tab in the question bank :
<ul>
<li>the up and down arrow keys change the order in which categories which
are peers of each other are listed.</li>
<li>Under the 'Categories' tab in the question bank, you can also move a category
to a new context with the up / down arrows.</li>
<li>The left and right arrows are used to change the parent category of a category.</li>
</ul></li>
<li>A possibly quicker way to move categories is to click on the edit
icon in the 'Categories' tab in the question bank and then use the category
select box to select a new parent category.</li>
</ul>
<p>See also :</p>
<ul>
<li><a href="help.php?module=question&amp;file=categorycontexts.html">Category contexts</a></li>
<li><a href="help.php?module=question&amp;file=permissions.html">Question permissions</a></li>
<li><a href="http://docs.moodle.org/en/Question_categories">Question categories help on Moodle Docs</a></li>
</ul>
\ No newline at end of file
<h2>Question Category Contexts</h2>
<p>Question categories are separated into different contexts from Moodle 1.9.
Each different context has a separate question category hierarchy.
Question category contexts are : </p>
<ul>
<li>Activity context : questions only available to one activity module.</li>
<li>Course context : questions available to all activity modules in a course and
within the course from the 'Questions' link in the course administration block.</li>
<li>Course category contexts : questions available to all activity modules and courses in the course category (remember one course category can contain other course categories, you can share
your questions in any or all of the parent course categories).</li>
<li>Core System context : questions available in all courses and activities on your site.</li>
</ul>
<p>You will not be able to see / use the contexts from categories above course level unless your site admin has given you permission to do so.</p>
<p>See also :</p>
<ul>
<li><a href="help.php?module=question&amp;file=categories.html">Question categories</a></li>
<li><a href="help.php?module=question&amp;file=permissions.html">Question permissions</a></li>
<li><a href="http://docs.moodle.org/en/Question_contexts">Question contexts documentation on Moodle Docs</a></li>
</ul>
\ No newline at end of file
<h2>Parent</h2>
<p>The category in which this one will be placed. 'Top' means that this category
is not contained in any other category.</p>
<p>Normally you will see several category 'contexts' which you will see in bold type, notice
that each context contains it's own category hierarchy. See below for more info on contexts. If you
do not see several contexts then it may be because you do not have permission to access other contexts.</p>
<p>If there is only one category in a context, you will not be able to move the category as there must be
at least one category in each context.</p>
<p>See also :</p>
<ul>
<li><a href="help.php?module=question&amp;file=categories.html">Question categories</a></li>
<li><a href="help.php?module=question&amp;file=categorycontexts.html">Category contexts</a></li>
<li><a href="help.php?module=question&amp;file=permissions.html">Question permissions</a></li>
</ul>
\ No newline at end of file
<h2>Question permissions</h2>
<p>By default a course teacher does not have permission to do anything with
questions shared in areas outside the course in which they are assigned a teacher
role. So if you are a teacher and your site admin has not assigned you permission
to share or use questions shared in levels above the course level you will not
see questions categories above the course level.</p>
<p>See also :</p>
<ul>
<li><a href="help.php?module=question&amp;file=categories.html">Question categories</a></li>
<li><a href="help.php?module=question&amp;file=categorycontexts.html">Category contexts</a></li>
</ul>
\ No newline at end of file
<h1>Creating a new question</h1>
<p>You can create questions of various different types:</p>
<h1>Analysis Download</h1>
<p>You may want to download the data displayed in the on-screen
table for further analysis. You can choose between three file
formats for downloaded data.<br /> In each case data will be
presented as a table with appropriate titles, as on the screen. If
the table is paged, all data for all pages will be downloaded in a
single file. </p>
<h2>Excel Spreadsheet format:</h2> <p>You will get an .xls
spreadsheet document.</p>
<h2>OpenOffice Writer format:</h2> <p>The data will we
presented within a table in an OpenOffice .sxw text document.<br />
This format will be available only if you have installed the
PHPWriter library in the /moodle/lib subdirectory.</p>
<h2>Text format</h2> <p>In this case, data will be stored as a
regular text file. A line for each row in the table with data
separated by tabstops.</p>
<h1>Analysis Options</h1>
<p>You can determine which quiz attempts are included in the
analysis by setting the following parameters: </p>
<h2>Attempt selection:</h2><p> It may be convenient to analyze
just one quiz attempt for each user. This particular attempt may be
the one with the highest overall score, the first attempt or the
last attempt of those performed. Alternatively all attempts data may
be combined for a cumulative analysis.</p>
<h2>Rejection of low scores:</h2> <p>Sometimes users are just
browsing the quiz, exploring it, and not going through it for a
grade. It is common that such 'trial' attempts get very low scores.
These attempts can be excluded from analysis by setting a low limit
for the score of the attempts to analyze. This limit is specified as
a percentage (0-100) of the maximum grade achievable in the
quiz.</p>
<h2>Page size:</h2> <p>You choose how many questions per page
you want to see displayed on screen.</p>
<h1>Calculated questions</h1>
<p>Calculated questions offers a way to create individual numerical question by the use of wildcards that are substituted with individual values when the quiz is taken.
<br />Below is a shrunken view of the main editing page with some example inputs:
</p>
<table><tbody>
<tr valign="top">
<th scope="col" align="right">Question:</th>
<td>
<textarea id="questiontext" name="questiontext" rows="5" cols="40">How much is {a} + {b} ?</textarea>
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Image to display:</th>
<td>
<select name="image"><option value="" selected="selected">None</option><option value="grevture.gif">grevture.gif</option></select>
</td>
</tr>
<tr valign="top">
<th scope="col" align="right">Correct Answer Formula:</th>