MDL-10952 update help files for new question code

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&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>

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&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>

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&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>

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&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="http://docs.moodle.org/en/Question_permissions">Question permissions on Moodle Docs</a></li>
+</ul>

lang/en_utf8/help/quiz/categories.html

@@ -3,21 +3,27 @@ <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>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> 
+<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>
+</ul>

question/category_class.php

@@ -230,7 +230,7 @@ function output_new_table() {
      *
      */
     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){

question/category_form.php

@@ -12,14 +12,14 @@ function definition() {
         $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));
         $mform->setType('parent', PARAM_SEQUENCE);
         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', '');