Improved help buttons for forums

lang/en/help/forum/allowdiscussions.html

@@ -0,0 +1,9 @@
+<P ALIGN=CENTER><B>Allowing new discussions</B></P>
+
+<P>For most forums you will want to allow non-teachers to start new 
+   discussion topics (threads).
+
+<P>Sometimes, however, you will want to disable this ability.  For
+   example, this is useful for the News forum when you only want 
+   teachers to post new items that appear on the course main page.
+   Students will still be able to REPLY to existing posts though.

lang/en/help/forum/forumtype.html

@@ -0,0 +1,16 @@
+<P ALIGN=CENTER><B>Forum Types</B></P>
+
+<P>There are several different types of forum to choose from:
+
+<P><B>A single simple discussion</B> - is just a single topic, all on one page.
+Useful for short, focussed discussions.
+
+<P><B>Standard forum for general use</B> - is an open forum where any one can 
+start a new topic at any time.  This is the best general-purpose forum.
+
+<P><B>Each person posts one discussion</B> - Each person can post exactly one 
+new discussion topic (everyone can reply to them though).  This is useful when 
+you want each student to start a discussion about, say, their reflections on 
+the week's topic, and everyone else responds to these.
+
+<P>(More development to come in future versions of Moodle)

lang/en/help/waysofknowing.html → lang/en/help/forum/ratings.html

@@ -1,9 +1,12 @@
-<P ALIGN=CENTER><B>Separate and Connected Ways of Knowing</B></P>
+<P ALIGN=CENTER><B>Forum Ratings</B></P>
 
-<p>This page explains a theory that may help you to look at human interactions 
+<P>Individual posts can be rated using a scale based on the theory of 
+<strong>separate and connected knowing</strong>.
+
+<p>This theory may help you to look at human interactions 
   in a new way. It describes two different ways that we can evaluate and learn 
-  about the things we see and hear - called separate and connected ways 
-  of knowing.</p>
+  about the things we see and hear.
+
 <p>Although each of us may use these two methods in different amounts at different 
   times, it may be useful to imagine two people as examples, one who is a mostly 
   separate knower (Jim) and the other a mostly connected knower (Mary).</p>

lang/en/help/forum/subscription.html

@@ -0,0 +1,18 @@
+<P ALIGN=CENTER><B>Forum Subscription</B></P>
+
+<P>When a person is subscribed to a forum it means that 
+they will be sent email copies of every post in that forum
+(posts are sent about 30 minutes after the post was first 
+written).
+
+<P>People can usually choose whether or not they want to be 
+subscribed to each forum.
+
+<P>However, if a teacher forces subscription on a particular forum 
+then this choice is taken away and everyone in the class will get 
+email copies.
+
+<P>This is especially useful in the News forum and in forums
+towards the beginning of the course (before everyone has 
+worked out that they can subscribe to these emails themselves).
+

mod/forum/lib.php

@@ -947,7 +947,7 @@ function forum_print_discussion($course, $forum, $discussion, $post, $mode) {
 
     if ($ratingform) {
         echo "<CENTER><P ALIGN=center><INPUT TYPE=submit VALUE=\"".get_string("sendinratings", "forum")."\">";
-        helpbutton("waysofknowing", get_string("separateandconnected"));
+        helpbutton("ratings", get_string("separateandconnected"), "forum");
         echo "</P></CENTER>";
         echo "</FORM>";
     }

mod/forum/mod.html

@@ -15,6 +15,7 @@
        require("$CFG->dirroot/mod/forum/lib.php");
        asort($FORUM_TYPES);
        choose_from_menu($FORUM_TYPES, "type", $form->type);
+       helpbutton("forumtype", get_string("forumtype", "forum"), "forum");
     ?>
 
     </td>
@@ -23,6 +24,7 @@
     <td align=right><P><B><? print_string("forumintro", "forum")?>:</B></P></TD>
     <td>
         <textarea name="intro" rows=4 cols=50 wrap="virtual"><? p($form->intro) ?></textarea>
+        <? helpbutton("text", get_string("helptext")); ?>
     </td>
 </tr>
 
@@ -32,22 +34,23 @@
         <? $stryes = get_string("yes"); $strno = get_string("no"); ?>
         <input type=radio name=open value=1 <? if ($form->open == 1) echo "CHECKED"; ?> ><?=$stryes ?>
         <input type=radio name=open value=0 <? if ($form->open == 0) echo "CHECKED"; ?> ><?=$strno ?>
+        <? helpbutton("allowdiscussions", get_string("allowdiscussions", "forum"), "forum") ?>
     </td>
 </tr>
 <tr>
-    <td align=right><P><B><? print_string("allowratings", "forum") ?>
-        <? helpbutton("waysofknowing", get_string("separateandconnected")) ?>
-    :</B></P></TD>
+    <td align=right><P><B><? print_string("allowratings", "forum") ?>:</B></P></TD>
     <td>
         <input type=radio name=assessed value=1 <? if ($form->assessed == 1) echo "CHECKED"; ?> ><?=$stryes ?>
         <input type=radio name=assessed value=0 <? if ($form->assessed == 0) echo "CHECKED"; ?> ><?=$strno ?>
+        <? helpbutton("ratings", get_string("allowratings", "forum"), "forum") ?>
     </td>
 </tr>
 <tr>
     <td align=right><P><B><? print_string("forcesubscribeq", "forum") ?>:</B></P></TD>
     <td>
         <input type=radio name=forcesubscribe value=1 <? if ($form->forcesubscribe == 1) echo "CHECKED"; ?> ><?=$stryes ?>
         <input type=radio name=forcesubscribe value=0 <? if ($form->forcesubscribe == 0) echo "CHECKED"; ?> ><?=$strno ?>
+        <? helpbutton("subscription", get_string("forcesubscribeq", "forum"), "forum") ?>
     </td>
 </tr>
 </table>