From: jamiesensei <jamiesensei>
Date: Mon, 3 Sep 2007 05:30:38 +0000 (+0000)
Subject: MDL-10952 update help files for new question code
X-Git-Url: http://git.mjollnir.org/gw?a=commitdiff_plain;h=35241c761a698bbb5eedbc6ff2d8796aefb19bd8;p=moodle.git
MDL-10952 update help files for new question code
---
diff --git a/lang/en_utf8/help/question/categories.html b/lang/en_utf8/help/question/categories.html
new file mode 100644
index 0000000000..e745275266
--- /dev/null
+++ b/lang/en_utf8/help/question/categories.html
@@ -0,0 +1,35 @@
+<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 :
+<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>
+
+<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>
+
+
+<p>See also :</p>
+<ul>
+ <li><a href="help.php?module=question&file=categorycontexts.html">Category contexts</a></li>
+ <li><a href="help.php?module=question&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
diff --git a/lang/en_utf8/help/question/categorycontexts.html b/lang/en_utf8/help/question/categorycontexts.html
new file mode 100644
index 0000000000..2dd258935a
--- /dev/null
+++ b/lang/en_utf8/help/question/categorycontexts.html
@@ -0,0 +1,19 @@
+<h2>Question Category Contexts</h2>
+<p>Question categories are seperated into different contexts from Moodle 1.9.
+Each different context has a seperate question category heirarchy.
+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&file=categories.html">Question categories</a></li>
+ <li><a href="help.php?module=question&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
diff --git a/lang/en_utf8/help/question/categoryparent.html b/lang/en_utf8/help/question/categoryparent.html
new file mode 100644
index 0000000000..9373145e9a
--- /dev/null
+++ b/lang/en_utf8/help/question/categoryparent.html
@@ -0,0 +1,18 @@
+<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&file=categories.html">Question categories</a></li>
+ <li><a href="help.php?module=question&file=categorycontexts.html">Category contexts</a></li>
+ <li><a href="help.php?module=question&file=permissions.html">Question permissions</a></li>
+</ul>
\ No newline at end of file
diff --git a/lang/en_utf8/help/question/permissions.html b/lang/en_utf8/help/question/permissions.html
new file mode 100644
index 0000000000..3a4af40387
--- /dev/null
+++ b/lang/en_utf8/help/question/permissions.html
@@ -0,0 +1,18 @@
+<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. There is more information
+<a title="Moodle docs page" alt="Moodle docs page" href="http://docs.moodle.org/en/Question_Engine_Changes_in_Moodle_1.9#Access_to_question_categories_shared_outside_a_course">
+here</a> about this issue.</p>
+
+<p>There is more info here.</p>
+
+<p>See also :</p>
+<ul>
+ <li><a href="help.php?module=question&file=categories.html">Question categories</a></li>
+ <li><a href="help.php?module=question&file=categorycontexts.html">Category contexts</a></li>
+ <li><a href="http://docs.moodle.org/en/Question_permissions">Question permissions on Moodle Docs</a></li>
+</ul>
\ No newline at end of file
diff --git a/lang/en_utf8/help/quiz/categories.html b/lang/en_utf8/help/quiz/categories.html
index 8e60536689..53e6cd8d29 100644
--- a/lang/en_utf8/help/quiz/categories.html
+++ b/lang/en_utf8/help/quiz/categories.html
@@ -3,21 +3,27 @@
<p>Rather than keeping all your questions in one big list,
you can create categories to keep them in.</p>
-<p>Each category consists of a name and a short description.</p>
-
-<p>Each category can also be "published", which means
- that the category (and all questions in it) will be
- available to all courses on this server, so that
- other courses can use your questions in their quizzes.</p>
-
-<p>Categories can also be created or deleted at will.
- However, if you try to delete a category containing
+<p>Categories can be created or deleted at will. But :
+<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.</p>
+ category to move them to.</li></ul></p>
+
+<p>You can arrange your categories in a hierarchy so
+ that they are easier to manage.<ul><li> The up and down arrow keys change the order in
+ which categories which are peers of each other are listed.</li>
+ <li>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>
+ <li>A possibly quicker way to move categories is to click on the edit
+ icon and then use the category select box to select a new parent
+ category.</li></ul></p>
-<p>You can also arrange the categories in a hierarchy so
- that they are easier to manage. The 'Move category to'
- field lets you move a category to another category.</p>
-<p>By clicking on the arrows in the 'Order' field, you
- can change the order in which the categories are listed.</p>
\ No newline at end of file
+<p>See also :</p>
+<ul>
+ <li><a href="help.php?module=question&file=categorycontexts.html">Category contexts</a></li>
+ <li><a href="help.php?module=question&file=permissions.html">Question permissions</a></li>
+</ul>
\ No newline at end of file
diff --git a/question/category_class.php b/question/category_class.php
index a0b41e0b3c..b0e10bd67e 100644
--- a/question/category_class.php
+++ b/question/category_class.php
@@ -230,7 +230,7 @@ class question_category_object {
*
*/
function output_edit_lists() {
- print_heading_with_help(get_string('editcategories', 'quiz'), 'categories', 'quiz');
+ print_heading_with_help(get_string('editcategories', 'quiz'), 'categories', 'question');
foreach ($this->editlists as $context => $list){
$listhtml = $list->to_html(0, array('str'=>$this->str));
if ($listhtml){
diff --git a/question/category_form.php b/question/category_form.php
index 84a0d28e18..bb772bc40d 100644
--- a/question/category_form.php
+++ b/question/category_form.php
@@ -12,7 +12,6 @@ class question_category_edit_form extends moodleform {
$currentcat = $this->_customdata['currentcat'];
//--------------------------------------------------------------------------------
$mform->addElement('header', 'categoryheader', get_string('addcategory', 'quiz'));
- $mform->setHelpButton('categoryheader', array('categories_edit', get_string('addcategory', 'quiz'), 'quiz'));
$questioncategoryel = $mform->addElement('questioncategory', 'parent', get_string('parent', 'quiz'),
array('contexts'=>$contexts, 'top'=>true, 'currentcat'=>$currentcat, 'nochildrenof'=>$currentcat));
@@ -20,6 +19,7 @@ class question_category_edit_form extends moodleform {
if (1 == count_records_sql("SELECT count(*) FROM {$CFG->prefix}question_categories c1, {$CFG->prefix}question_categories c2 WHERE c2.id = $currentcat AND c1.contextid = c2.contextid")){
$mform->hardFreeze('parent');
}
+ $mform->setHelpButton('parent', array('categoryparent', get_string('parent', 'quiz'), 'question'));
$mform->addElement('text','name', get_string('name'),'maxlength="254" size="50"');
$mform->setDefault('name', '');