From 09442e50676d6eb33b72fcf0d6d3b15d081f0ca4 Mon Sep 17 00:00:00 2001
From: martin <martin>
Date: Sun, 8 Sep 2002 05:15:52 +0000
Subject: [PATCH] Added documentation to the teachers page.

---
 course/teachers.php        | 17 ++++++++++++-----
 lang/en/help/teachers.html | 22 ++++++++++++++++++++++
 2 files changed, 34 insertions(+), 5 deletions(-)
 create mode 100644 lang/en/help/teachers.html

diff --git a/course/teachers.php b/course/teachers.php
index 8b812ad913..94a3e81a75 100644
--- a/course/teachers.php
+++ b/course/teachers.php
@@ -47,7 +47,7 @@
 
 /// Otherwise fill and print the form.
 
-	print_header($streditcoursesettings, "$course->fullname", 
+	print_header("$course->shortname: $course->teachers", "$course->fullname", 
                  "<A HREF=\"$CFG->wwwroot/course/view.php?id=$course->id\">$course->shortname</A> 
                   -> $course->teachers");
 
@@ -59,18 +59,25 @@
 
     echo "<FORM ACTION=teachers.php METHOD=post>";
     foreach ($teachers as $teacher) {
-        $table->head  = array (get_string("name"), get_string("order"), get_string("role"));
-        $table->align = array ("LEFT", "CENTER", "CENTER");
+        $table->head  = array ("", get_string("name"), get_string("order"), get_string("role"));
+        $table->align = array ("RIGHT", "LEFT", "CENTER", "CENTER");
+        $table->size  = array ("35", "", "", "");
 
         $picture = print_user_picture($teacher->id, $course->id, $teacher->picture, false, true);
 
-        $table->data[] = array ("$picture $teacher->firstname $teacher->lastname",
+        if (!$teacher->role) {
+            $teacher->role = $course->teacher;
+        }
+
+        $table->data[] = array ($picture, "$teacher->firstname $teacher->lastname",
                                 "<INPUT TYPE=text NAME=\"a$teacher->id\" VALUE=\"$teacher->authority\" SIZE=2>",
                                 "<INPUT TYPE=text NAME=\"r$teacher->id\" VALUE=\"$teacher->role\" SIZE=30>");
     }
     print_table($table);
     echo "<INPUT TYPE=hidden NAME=id VALUE=\"$course->id\">";
-    echo "<CENTER><BR><INPUT TYPE=submit VALUE=\"".get_string("savechanges")."\"></CENTER>";
+    echo "<CENTER><BR><INPUT TYPE=submit VALUE=\"".get_string("savechanges")."\"> ";
+    helpbutton("teachers", $course->teachers);
+    echo "</CENTER>";
     echo "</FORM>";
 
     print_footer($course);
diff --git a/lang/en/help/teachers.html b/lang/en/help/teachers.html
new file mode 100644
index 0000000000..0d0767e65f
--- /dev/null
+++ b/lang/en/help/teachers.html
@@ -0,0 +1,22 @@
+<P ALIGN=CENTER><B>Teachers</B></P>
+
+<P>This page shows the list of people who are assigned to be 
+   "teachers" in this course (by the system administrator).
+
+<P>You can use this form to assign a role (title) to each person 
+   such as "Professor", "Tutor", "Assistant" and so on.  These 
+   will appear on the site's course listing and also on the 
+   list of participants for your course.   If you leave the 
+   role empty then the default word for teacher will be used
+   (the one you set in the Course Settings page).
+
+<P>You can also order this list (to put the main teacher at the 
+   top, for example).  Simply put a numbers in each box such 
+   as 1, 2, 3 etc.   After pressing "Save changes" you will 
+   see the new order.
+
+<P><B>NOTE:</B> A special case occurs if you use the number 
+   0 (zero) for a teacher.  In this case, the teacher will 
+   NOT BE SHOWN on the course listings or the list of 
+   participants.  They will be "invisible" to students
+   (unless they post messages to the forums etc)
-- 
2.39.5