OK, this is better (sigh)
[moodle.git] / course / lib.php
1 <? // $Id$
3 $MAXNEWSDISPLAY = 4;
5 $FORMATS = array (
6              "1" => "Weekly layout",
7              "2" => "Social layout"
8            );
11 function print_log_selector_form($course, $selecteduser=0, $selecteddate="today") {
13     global $USER, $CFG;
15     // Get all the possible users
16     $users = array();
17     if ($students = get_records_sql("SELECT u.* FROM user u, user_students s 
18                                      WHERE s.course = '$course->id' AND s.user = u.id
19                                      ORDER BY u.lastaccess DESC")) {
20         foreach ($students as $student) {
21             $users["$student->id"] = "$student->firstname $student->lastname";
22         }
23     }
24     if ($teachers = get_records_sql("SELECT u.* FROM user u, user_teachers t 
25                                      WHERE t.course = '$course->id' AND t.user = u.id
26                                      ORDER BY u.lastaccess DESC")) {
27         foreach ($teachers as $teacher) {
28             $users["$teacher->id"] = "$teacher->firstname $teacher->lastname";
29         }
30     }
32     asort($users);
34     // Get all the possible dates
35     // Note that we are keeping track of real (GMT) time and user time
36     // User time is only used in displays - all calcs and passing is GMT
38     $timenow = time(); // GMT
40     // What day is it now for the user, and when is midnight that day (in GMT).
41     $timemidnight = $today = usergetmidnight($timenow);
43     // Put today up the top of the list
44     $dates = array("$timemidnight" => "Today, ".userdate($timenow, "j F Y") );
46     if (! $course->startdate) {
47         $course->startdate = $course->timecreated;
48     }
50     $numdates = 1;
51     while ($timemidnight > $course->startdate and $numdates < 365) {
52         $timemidnight = $timemidnight - 86400;
53         $timenow = $timenow - 86400;
54         $dates["$timemidnight"] = userdate($timenow, "l, j F Y");
55         $numdates++;
56     }
58     if ($selecteddate == "today") {
59         $selecteddate = $today;
60     }
62     echo "<CENTER>";
63     echo "<FORM ACTION=log.php METHOD=get>";
64     echo "<INPUT TYPE=hidden NAME=id VALUE=\"$course->id\">";
65     choose_from_menu ($users, "user", $selecteduser, "All participants");
66     choose_from_menu ($dates, "date", $selecteddate, "Any day");
67     echo "<INPUT TYPE=submit VALUE=\"Show these logs\">";
68     echo "</FORM>";
69     echo "</CENTER>";
70 }
72 function make_log_url($module, $url) {
73     switch ($module) {
74         case "course":
75         case "user":
76         case "file":
77         case "login":
78         case "lib":
79         case "admin":
80             return "/$module/$url";
81             break;
82         default:
83             return "/mod/$module/$url";
84             break;
85     }
86 }
89 function print_log($course, $user=0, $date=0, $order="ORDER BY l.time ASC") {
90 // It is assumed that $date is the GMT time of midnight for that day, 
91 // and so the next 86400 seconds worth of logs are printed.
93     $selector = "WHERE l.course='$course->id' AND l.user = u.id";
95     if ($user) {
96         $selector .= " AND l.user = '$user'";
97     }
99     if ($date) {
100         $enddate = $date + 86400;
101         $selector .= " AND l.time > '$date' AND l.time < '$enddate'";
102     }
104     if (!$logs = get_records_sql("SELECT l.*, u.firstname, u.lastname, u.picture 
105                                   FROM log l, user u $selector $order")){
106         notify("No logs found!");
107         print_footer($course);
108         exit;
109     }
111     $count=0;
112     $tt = getdate(time());
113     $today = mktime (0, 0, 0, $tt["mon"], $tt["mday"], $tt["year"]);
114     echo "<P ALIGN=CENTER>Displaying ".count($logs)." records</P>";
115     echo "<TABLE BORDER=0 ALIGN=center CELLPADDING=3 CELLSPACING=3>";
116     foreach ($logs as $log) {
118         if ($ld = get_record_sql("SELECT * FROM log_display WHERE module='$log->module' AND action='$log->action'")) {
119             $log->info = get_field($ld->table, $ld->field, "id", $log->info);
120         }
122         echo "<TR>";
123         echo "<TD ALIGN=right><FONT SIZE=2>".userdate($log->time, "l")."</TD>";
124         echo "<TD><FONT SIZE=2>".userdate($log->time, "j M Y, h:i A")."</TD>";
125         echo "<TD><FONT SIZE=2><A TITLE=\"$log->ip\" HREF=\"../user/view.php?id=$log->user&course=$log->course\"><B>$log->firstname $log->lastname</B></TD>";
126         echo "<TD><FONT SIZE=2>";
127         link_to_popup_window( make_log_url($log->module,$log->url), "fromloglive","$log->module $log->action", 400, 600);
128         echo "</TD>";
129         echo "<TD><FONT SIZE=2>$log->info</TD>";
130         echo "</TR>";
131     }
132     echo "</TABLE>";
136 function print_all_courses($cat=1) {
138     if ($courses = get_records("course", "category", $cat, "fullname ASC")) {
139         foreach ($courses as $course) {
140             print_course($course);
141             echo "<BR>\n";
142         }
144     } else {
145         echo "<H3>No courses have been defined yet</H3>";
146     }
150 function print_course($course) {
152     global $CFG;
154     if (! $site = get_record("course", "category", "0") ) {
155         error("Could not find a site!");
156     }
158     print_simple_box_start("CENTER", "100%");
160     echo "<TABLE WIDTH=100%>";
161     echo "<TR VALIGN=top>";
162     echo "<TD VALIGN=top WIDTH=50%>";
163     echo "<P><FONT SIZE=3><B><A TITLE=\"Click to enter this course\" 
164               HREF=\"$CFG->wwwroot/course/view.php?id=$course->id\">$course->fullname</A></B></FONT></P>";
165     if ($teachers = get_records_sql("SELECT u.* FROM user u, user_teachers t 
166                                      WHERE u.id = t.user AND t.course = '$course->id' 
167                                      ORDER BY t.authority ASC")) {
169         echo "<P><FONT SIZE=1>\n";
170         foreach ($teachers as $teacher) {
171             echo "$course->teacher: <A HREF=\"$CFG->wwwroot/user/view.php?id=$teacher->id&course=$site->id\">$teacher->firstname $teacher->lastname</A><BR>";
172         }
173         echo "</FONT></P>";
174     }
175     if ($course->guest or ($course->password == "")) {
176         echo "<A TITLE=\"This course allows guest users\" HREF=\"$CFG->wwwroot/course/view.php?id=$course->id\">";
177         echo "<IMG VSPACE=4 ALT=\"\" HEIGHT=16 WIDTH=16 BORDER=0 SRC=\"$CFG->wwwroot/user/user.gif\"></A>&nbsp;&nbsp;";
178     }
179     if ($course->password) {
180         echo "<A TITLE=\"This course requires an enrolment key\" HREF=\"$CFG->wwwroot/course/view.php?id=$course->id\">";
181         echo "<IMG VSPACE=4 ALT=\"\" HEIGHT=16 WIDTH=16 BORDER=0 SRC=\"$CFG->wwwroot/pix/i/key.gif\"></A>";
182     }
185     echo "</TD><TD VALIGN=top WIDTH=50%>";
186     echo "<P><FONT SIZE=2>".text_to_html($course->summary)."</FONT></P>";
187     echo "</TD></TR>";
188     echo "</TABLE>";
190     print_simple_box_end();
193 function print_headline($text, $size=2) {
194     echo "<B><FONT SIZE=\"$size\">$text</FONT></B><BR>\n";
197 function print_recent_activity($course) {
198     // $course is an object
199     // This function trawls through the logs looking for 
200     // anything new since the user's last login
202     global $CFG, $USER;
204     if (! $USER->lastlogin ) {
205         echo "<P>Welcome to the course! Here you will find a list of what's new since your last login.</P>";
206         return;
207     }
209     if (! $logs = get_records_sql("SELECT * FROM log WHERE time > '$USER->lastlogin' AND course = '$course->id' ORDER BY time ASC")) {
210         return;
211     }
214     // Firstly, have there been any new enrolments?
216     $heading = false;
217     $content = false;
218     foreach ($logs as $log) {
219         if ($log->module == "course" and $log->action == "enrol") {
220             if (! $heading) {
221                 print_headline("New users:");
222                 $heading = true;
223                 $content = true;
224             }
225             $user = get_record("user", "id", $log->info);
226             echo "<P><FONT SIZE=1><A HREF=\"../user/view.php?id=$user->id&course=$course->id\">$user->firstname $user->lastname</A></FONT></P>";
227         }
228     }
230     // Next, have there been any changes to the course structure?
232     foreach ($logs as $log) {
233         if ($log->module == "course") {
234             if ($log->action == "add mod" or $log->action == "update mod" or $log->action == "delete mod") {
235                 $info = split(" ", $log->info);
236                 $modname = get_field($info[0], "name", "id", $info[1]);
237             
238                 if ($info[0] == "discuss") {
239                     $info[0] = "discussion";  // nasty hack, really.
240                 }
242                 switch ($log->action) {
243                     case "add mod":
244                        $changelist["$log->info"] = array ("operation" => "add", "text" => "Added a ".$info[0].":<BR><A HREF=\"$CFG->wwwroot/course/$log->url\">$modname</A>");
245                     break;
246                     case "update mod":
247                        if (! $changelist["$log->info"]) {
248                            $changelist["$log->info"] = array ("operation" => "update", "text" => "Updated the ".$info[0].":<BR><A HREF=\"$CFG->wwwroot/course/$log->url\">$modname</A>");
249                        }
250                     break;
251                     case "delete mod":
252                        if ($changelist["$log->info"]["operation"] == "add") {
253                            $changelist["$log->info"] = NULL;
254                        } else {
255                            $changelist["$log->info"] = array ("operation" => "delete", "text" => "Deleted a ".$info[0]);
256                        }
257                     break;
258                 }
259             }
260         }
261     }
263     if ($changelist) {
264         foreach ($changelist as $changeinfo => $change) {
265             if ($change) {
266                 $changes[$changeinfo] = $change;
267             }
268         }
269         if (count($changes) > 0) {
270             print_headline("Course changes:");
271             $content = true;
272             foreach ($changes as $changeinfo => $change) {
273                 echo "<P><FONT SIZE=1>".$change["text"]."</FONT></P>";
274             }
275         }
276     }
279     // Now all we need to know are the new posts.
281     $heading = false;
282     foreach ($logs as $log) {
283         
284         if ($log->module == "discuss") {
285             $post = NULL;
287             if ($log->action == "add post") {
288                 $post = get_record_sql("SELECT p.*, u.firstname, u.lastname, 
289                                                u.email, u.picture, u.id as userid
290                                         FROM discuss_posts p, user u 
291                                         WHERE p.id = '$log->info' AND p.user = u.id");
293             } else if ($log->action == "add") {
294                 $post = get_record_sql("SELECT p.*, u.firstname, u.lastname, 
295                                                u.email, u.picture, u.id as userid
296                                         FROM discuss d, discuss_posts p, user u 
297                                         WHERE d.id = '$log->info' AND d.firstpost = p.id AND p.user = u.id");
298             }
300             if ($post) {
301                 if (! $heading) {
302                     print_headline("Discussion Posts:");
303                     $heading = true;
304                     $content = true;
305                 }
306                 echo "<P><FONT SIZE=1>$post->firstname $post->lastname:<BR>";
307                 echo "\"<A HREF=\"$CFG->wwwroot/mod/discuss/$log->url\">";
308                 if ($log->action == "add") {
309                     echo "<B>$post->subject</B>";
310                 } else {
311                     echo "$post->subject";
312                 }
313                 echo "</A>\"</FONT></P>";
314             }
316         }
317     }
319     if (! $content) {
320         echo "<FONT SIZE=2>Nothing new since your last login</FONT>";
321     }
326 function unenrol_student_in_course($user, $course) {
327     global $db;
329     return $db->Execute("DELETE FROM user_students WHERE user = '$user' AND course = '$course'");
334 function enrol_student_in_course($user, $course) {
335     global $db;
337         $timenow = time();
339         $rs = $db->Execute("INSERT INTO user_students (user, course, start, end, time) 
340                         VALUES ($user, $course, 0, 0, $timenow)");
341         if ($rs) {
342                 return true;
343         } else {
344             return false;
345         }
348 ?>