From: martin <martin>
Date: Sun, 18 Aug 2002 14:40:19 +0000 (+0000)
Subject: Improved help buttons for forums
X-Git-Url: http://git.mjollnir.org/gw?a=commitdiff_plain;h=61ee082fd8e9bf4e4e32ff9188d61e80f11be691;p=moodle.git
Improved help buttons for forums
---
diff --git a/lang/en/help/forum/allowdiscussions.html b/lang/en/help/forum/allowdiscussions.html
new file mode 100644
index 0000000000..204980988a
--- /dev/null
+++ b/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.
diff --git a/lang/en/help/forum/forumtype.html b/lang/en/help/forum/forumtype.html
new file mode 100644
index 0000000000..86eec26df8
--- /dev/null
+++ b/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)
diff --git a/lang/en/help/waysofknowing.html b/lang/en/help/forum/ratings.html
old mode 100755
new mode 100644
similarity index 91%
rename from lang/en/help/waysofknowing.html
rename to lang/en/help/forum/ratings.html
index 79b3083007..397337de84
--- a/lang/en/help/waysofknowing.html
+++ b/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>
diff --git a/lang/en/help/forum/subscription.html b/lang/en/help/forum/subscription.html
new file mode 100644
index 0000000000..ea73ebbf6b
--- /dev/null
+++ b/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).
+
diff --git a/mod/forum/lib.php b/mod/forum/lib.php
index 1539ae95ea..e509680d59 100644
--- a/mod/forum/lib.php
+++ b/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>";
}
diff --git a/mod/forum/mod.html b/mod/forum/mod.html
index 342c7ef9c6..1d5e882635 100644
--- a/mod/forum/mod.html
+++ b/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,15 +34,15 @@
<? $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>
@@ -48,6 +50,7 @@
<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>