mirror of
https://github.com/moodle/moodle.git
synced 2025-02-13 12:34:28 +01:00
f950af3c43
All the page headers work correctly also on the site course. On the site page the modules don't require login unless necessary or required by $CFG->forcelogin.
557 lines
19 KiB
PHP
557 lines
19 KiB
PHP
<?PHP // $Id$
|
|
|
|
|
|
if (!isset($CFG->journal_showrecentactivity)) {
|
|
set_config("journal_showrecentactivity", true);
|
|
}
|
|
|
|
|
|
|
|
// STANDARD MODULE FUNCTIONS /////////////////////////////////////////////////////////
|
|
|
|
function journal_user_outline($course, $user, $mod, $journal) {
|
|
if ($entry = get_record("journal_entries", "userid", $user->id, "journal", $journal->id)) {
|
|
|
|
$numwords = count(preg_split("/\w\b/", $entry->text)) - 1;
|
|
|
|
$result->info = get_string("numwords", "", $numwords);
|
|
$result->time = $entry->modified;
|
|
return $result;
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
|
|
function journal_user_complete($course, $user, $mod, $journal) {
|
|
|
|
if ($entry = get_record("journal_entries", "userid", $user->id, "journal", $journal->id)) {
|
|
|
|
print_simple_box_start();
|
|
if ($entry->modified) {
|
|
echo "<P><FONT SIZE=1>".get_string("lastedited").": ".userdate($entry->modified)."</FONT></P>";
|
|
}
|
|
if ($entry->text) {
|
|
echo format_text($entry->text, $entry->format);
|
|
}
|
|
if ($entry->teacher) {
|
|
$grades = make_grades_menu($journal->assessed);
|
|
journal_print_feedback($course, $entry, $grades);
|
|
}
|
|
print_simple_box_end();
|
|
|
|
} else {
|
|
print_string("noentry", "journal");
|
|
}
|
|
}
|
|
|
|
|
|
function journal_user_complete_index($course, $user, $journal, $journalopen, $heading) {
|
|
/// Prints a journal, entry and feedback ... used on the journal index page.
|
|
|
|
if (isteacher($course->id)) {
|
|
$entrycount = journal_count_entries($journal, get_current_group($course->id));
|
|
$entryinfo = " (<a href=\"report.php?id=$journal->coursemodule\">".get_string("viewallentries","journal", $entrycount)."</a>)";
|
|
} else {
|
|
$entryinfo = "";
|
|
}
|
|
|
|
$journal->name = "<a href=\"view.php?id=$journal->coursemodule\">$journal->name</a>";
|
|
|
|
if ($heading) {
|
|
echo "<h3>$heading - $journal->name$entryinfo</h3>";
|
|
} else {
|
|
echo "<h3>$journal->name$entryinfo</h3>";
|
|
}
|
|
|
|
print_simple_box_start("left", "90%");
|
|
echo format_text($journal->intro, $journal->introformat);
|
|
print_simple_box_end();
|
|
echo "<br clear=all />";
|
|
echo "<br />";
|
|
|
|
if (isstudent($course->id) or isteacher($course->id)) {
|
|
|
|
print_simple_box_start("right", "90%");
|
|
|
|
if ($journalopen) {
|
|
echo "<p align=right><a href=\"edit.php?id=$journal->coursemodule\">";
|
|
echo get_string("edit")."</a></p>";
|
|
} else {
|
|
echo "<p align=right><a href=\"view.php?id=$journal->coursemodule\">";
|
|
echo get_string("view")."</a></p>";
|
|
}
|
|
|
|
if ($entry = get_record("journal_entries", "userid", $user->id, "journal", $journal->id)) {
|
|
if ($entry->modified) {
|
|
echo "<p align=\"center\"><font size=1>".get_string("lastedited").": ".userdate($entry->modified)."</font></p>";
|
|
}
|
|
if ($entry->text) {
|
|
echo format_text($entry->text, $entry->format);
|
|
}
|
|
if ($entry->teacher) {
|
|
$grades = make_grades_menu($journal->assessed);
|
|
journal_print_feedback($course, $entry, $grades);
|
|
}
|
|
} else {
|
|
print_string("noentry", "journal");
|
|
}
|
|
|
|
print_simple_box_end();
|
|
echo "<br clear=all />";
|
|
echo "<br />";
|
|
}
|
|
|
|
}
|
|
|
|
|
|
function journal_cron () {
|
|
// Function to be run periodically according to the moodle cron
|
|
// Finds all journal notifications that have yet to be mailed out, and mails them
|
|
|
|
global $CFG, $USER;
|
|
|
|
$cutofftime = time() - $CFG->maxeditingtime;
|
|
|
|
if ($entries = journal_get_unmailed_graded($cutofftime)) {
|
|
$timenow = time();
|
|
|
|
foreach ($entries as $entry) {
|
|
|
|
echo "Processing journal entry $entry->id\n";
|
|
|
|
if (! $user = get_record("user", "id", "$entry->userid")) {
|
|
echo "Could not find user $entry->userid\n";
|
|
continue;
|
|
}
|
|
|
|
$USER->lang = $user->lang;
|
|
|
|
if (! $course = get_record("course", "id", "$entry->course")) {
|
|
echo "Could not find course $entry->course\n";
|
|
continue;
|
|
}
|
|
|
|
if (! isstudent($course->id, $user->id) and !isteacher($course->id, $user->id)) {
|
|
continue; // Not an active participant
|
|
}
|
|
|
|
if (! $teacher = get_record("user", "id", "$entry->teacher")) {
|
|
echo "Could not find teacher $entry->teacher\n";
|
|
continue;
|
|
}
|
|
|
|
|
|
if (! $mod = get_coursemodule_from_instance("journal", $entry->journal, $course->id)) {
|
|
echo "Could not find course module for journal id $entry->journal\n";
|
|
continue;
|
|
}
|
|
|
|
unset($journalinfo);
|
|
$journalinfo->teacher = fullname($teacher);
|
|
$journalinfo->journal = "$entry->name";
|
|
$journalinfo->url = "$CFG->wwwroot/mod/journal/view.php?id=$mod->id";
|
|
|
|
$postsubject = "$course->shortname: Journal feedback: $entry->name";
|
|
$posttext = "$course->shortname -> Journals -> $entry->name\n";
|
|
$posttext .= "---------------------------------------------------------------------\n";
|
|
$posttext .= get_string("journalmail", "journal", $journalinfo);
|
|
$posttext .= "---------------------------------------------------------------------\n";
|
|
if ($user->mailformat == 1) { // HTML
|
|
$posthtml = "<p><font face=\"sans-serif\">".
|
|
"<a href=\"$CFG->wwwroot/course/view.php?id=$course->id\">$course->shortname</a> ->".
|
|
"<a href=\"$CFG->wwwroot/mod/journal/index.php?id=$course->id\">journals</a> ->".
|
|
"<a href=\"$CFG->wwwroot/mod/journal/view.php?id=$mod->id\">$entry->name</a></font></p>";
|
|
$posthtml .= "<hr><font face=\"sans-serif\">";
|
|
$posthtml .= "<p>".get_string("journalmailhtml", "journal", $journalinfo)."</p>";
|
|
$posthtml .= "</font><hr>";
|
|
} else {
|
|
$posthtml = "";
|
|
}
|
|
|
|
if (! email_to_user($user, $teacher, $postsubject, $posttext, $posthtml)) {
|
|
echo "Error: Journal cron: Could not send out mail for id $entry->id to user $user->id ($user->email)\n";
|
|
}
|
|
if (! set_field("journal_entries", "mailed", "1", "id", "$entry->id")) {
|
|
echo "Could not update the mailed field for id $entry->id\n";
|
|
}
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
function journal_print_recent_activity($course, $isteacher, $timestart) {
|
|
global $CFG;
|
|
|
|
if (empty($CFG->journal_showrecentactivity)) { // Don't even bother
|
|
return false;
|
|
}
|
|
|
|
$content = false;
|
|
$journals = NULL;
|
|
|
|
if (!$logs = get_records_select("log", "time > '$timestart' AND ".
|
|
"course = '$course->id' AND ".
|
|
"module = 'journal' AND ".
|
|
"(action = 'add entry' OR action = 'update entry')", "time ASC")){
|
|
return false;
|
|
}
|
|
|
|
foreach ($logs as $log) {
|
|
///Get journal info. I'll need it later
|
|
$j_log_info = journal_log_info($log);
|
|
|
|
//Create a temp valid module structure (course,id)
|
|
$tempmod->course = $log->course;
|
|
$tempmod->id = $j_log_info->id;
|
|
//Obtain the visible property from the instance
|
|
$modvisible = instance_is_visible($log->module,$tempmod);
|
|
|
|
//Only if the mod is visible
|
|
if ($modvisible) {
|
|
if (!isset($journals[$log->info])) {
|
|
$journals[$log->info] = $j_log_info;
|
|
$journals[$log->info]->time = $log->time;
|
|
$journals[$log->info]->url = $log->url;
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($journals) {
|
|
$content = true;
|
|
$strftimerecent = get_string("strftimerecent");
|
|
print_headline(get_string("newjournalentries", "journal").":");
|
|
foreach ($journals as $journal) {
|
|
$date = userdate($journal->time, $strftimerecent);
|
|
echo "<p><font size=1>$date - ".fullname($journal)."<br />";
|
|
echo "\"<a href=\"$CFG->wwwroot/mod/journal/$journal->url\">";
|
|
echo "$journal->name";
|
|
echo "</a>\"</font></p>";
|
|
}
|
|
}
|
|
|
|
return $content;
|
|
}
|
|
|
|
function journal_grades($journalid) {
|
|
/// Must return an array of grades, indexed by user, and a max grade.
|
|
|
|
if (!$journal = get_record("journal", "id", $journalid)) {
|
|
return NULL;
|
|
}
|
|
|
|
$grades = get_records_menu("journal_entries", "journal",
|
|
$journal->id, "", "userid,rating");
|
|
|
|
if ($journal->assessed > 0) {
|
|
$return->grades = $grades;
|
|
$return->maxgrade = $journal->assessed;
|
|
|
|
} else if ($journal->assessed == 0) {
|
|
return NULL;
|
|
|
|
} else {
|
|
if ($scale = get_record("scale", "id", - $journal->assessed)) {
|
|
$scalegrades = make_menu_from_list($scale->scale);
|
|
if ($grades) {
|
|
foreach ($grades as $key => $grade) {
|
|
$grades[$key] = $scalegrades[$grade];
|
|
}
|
|
}
|
|
}
|
|
$return->grades = $grades;
|
|
$return->maxgrade = "";
|
|
}
|
|
|
|
return $return;
|
|
}
|
|
|
|
function journal_get_participants($journalid) {
|
|
//Returns the users with data in one journal
|
|
//(users with records in journal_entries, students and teachers)
|
|
|
|
global $CFG;
|
|
|
|
//Get students
|
|
$students = get_records_sql("SELECT DISTINCT u.*
|
|
FROM {$CFG->prefix}user u,
|
|
{$CFG->prefix}journal_entries j
|
|
WHERE j.journal = '$journalid' and
|
|
u.id = j.userid");
|
|
//Get teachers
|
|
$teachers = get_records_sql("SELECT DISTINCT u.*
|
|
FROM {$CFG->prefix}user u,
|
|
{$CFG->prefix}journal_entries j
|
|
WHERE j.journal = '$journalid' and
|
|
u.id = j.teacher");
|
|
|
|
//Add teachers to students
|
|
if ($teachers) {
|
|
foreach ($teachers as $teacher) {
|
|
$students[$teacher->id] = $teacher;
|
|
}
|
|
}
|
|
//Return students array (it contains an array of unique users)
|
|
return ($students);
|
|
}
|
|
|
|
function journal_scale_used ($journalid,$scaleid) {
|
|
//This function returns if a scale is being used by one journal
|
|
|
|
$return = false;
|
|
|
|
$rec = get_record("journal","id","$journalid","assessed","-$scaleid");
|
|
|
|
if (!empty($rec) && !empty($scaleid)) {
|
|
$return = true;
|
|
}
|
|
|
|
return $return;
|
|
}
|
|
|
|
// SQL FUNCTIONS ///////////////////////////////////////////////////////////////////
|
|
|
|
function journal_get_users_done($journal) {
|
|
global $CFG;
|
|
|
|
// make sure it works on the site course
|
|
$select = "s.course = '$journal->course' AND";
|
|
$site = get_site();
|
|
if ($journal->course == $site->id) {
|
|
$select = '';
|
|
}
|
|
|
|
$studentjournals = get_records_sql ("SELECT u.*
|
|
FROM {$CFG->prefix}journal_entries j,
|
|
{$CFG->prefix}user u,
|
|
{$CFG->prefix}user_students s
|
|
WHERE j.userid = u.id
|
|
AND s.userid = u.id
|
|
AND $select j.journal = $journal->id
|
|
ORDER BY j.modified DESC");
|
|
|
|
$teacherjournals = get_records_sql ("SELECT u.*
|
|
FROM {$CFG->prefix}journal_entries j,
|
|
{$CFG->prefix}user u,
|
|
{$CFG->prefix}user_teachers t
|
|
WHERE j.userid = u.id
|
|
AND t.userid = u.id
|
|
AND j.journal = $journal->id
|
|
AND t.course = $journal->course
|
|
ORDER BY j.modified DESC");
|
|
|
|
if ($studentjournals and !$teacherjournals) {
|
|
return $studentjournals;
|
|
}
|
|
if ($teacherjournals and !$studentjournals) {
|
|
return $teacherjournals;
|
|
}
|
|
if (!$teacherjournals and !$studentjournals) {
|
|
return array();
|
|
}
|
|
return(array_merge($studentjournals, $teacherjournals));
|
|
}
|
|
|
|
function journal_count_entries($journal, $groupid=0) {
|
|
/// Counts all the journal entries (optionally in a given group)
|
|
|
|
global $CFG, $db;
|
|
|
|
if ($groupid) { /// How many in a particular group?
|
|
return count_records_sql("SELECT COUNT(*)
|
|
FROM {$CFG->prefix}journal_entries j,
|
|
{$CFG->prefix}groups_members g
|
|
WHERE j.journal = $journal->id
|
|
AND g.groupid = '$groupid'
|
|
AND j.userid = g.userid");
|
|
|
|
} else { /// Count all the entries from the whole course
|
|
|
|
// make sure it works on the site course
|
|
$select = "s.course = '$journal->course' AND";
|
|
$site = get_site();
|
|
if ($journal->course == $site->id) {
|
|
$select = '';
|
|
}
|
|
|
|
$studentjournals = count_records_sql("SELECT COUNT(*)
|
|
FROM {$CFG->prefix}journal_entries j,
|
|
{$CFG->prefix}user u,
|
|
{$CFG->prefix}user_students s
|
|
WHERE j.userid = u.id
|
|
AND s.userid = u.id
|
|
AND $select j.journal = $journal->id");
|
|
|
|
$teacherjournals = count_records_sql("SELECT COUNT(*)
|
|
FROM {$CFG->prefix}journal_entries j,
|
|
{$CFG->prefix}user u,
|
|
{$CFG->prefix}user_teachers t
|
|
WHERE j.userid = u.id
|
|
AND t.userid = u.id
|
|
AND j.journal = $journal->id
|
|
AND t.course = $journal->course ");
|
|
return ($studentjournals + $teacherjournals);
|
|
}
|
|
}
|
|
|
|
|
|
function journal_get_unmailed_graded($cutofftime) {
|
|
global $CFG;
|
|
return get_records_sql("SELECT e.*, j.course, j.name
|
|
FROM {$CFG->prefix}journal_entries e,
|
|
{$CFG->prefix}journal j
|
|
WHERE e.mailed = '0'
|
|
AND e.timemarked < '$cutofftime'
|
|
AND e.timemarked > 0
|
|
AND e.journal = j.id");
|
|
}
|
|
|
|
function journal_log_info($log) {
|
|
global $CFG;
|
|
return get_record_sql("SELECT j.*, u.firstname, u.lastname
|
|
FROM {$CFG->prefix}journal j,
|
|
{$CFG->prefix}journal_entries e,
|
|
{$CFG->prefix}user u
|
|
WHERE e.id = '$log->info'
|
|
AND e.journal = j.id
|
|
AND e.userid = u.id");
|
|
}
|
|
|
|
// OTHER JOURNAL FUNCTIONS ///////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
function journal_print_user_entry($course, $user, $entry, $teachers, $grades) {
|
|
global $THEME, $USER;
|
|
|
|
if ($entry->timemarked < $entry->modified) {
|
|
$colour = $THEME->cellheading2;
|
|
} else {
|
|
$colour = $THEME->cellheading;
|
|
}
|
|
|
|
echo "\n<TABLE BORDER=1 CELLSPACING=0 valign=top cellpadding=10>";
|
|
|
|
echo "\n<TR>";
|
|
echo "\n<TD ROWSPAN=2 BGCOLOR=\"$THEME->body\" WIDTH=35 VALIGN=TOP>";
|
|
print_user_picture($user->id, $course->id, $user->picture);
|
|
echo "</TD>";
|
|
echo "<TD NOWRAP WIDTH=100% BGCOLOR=\"$colour\">".fullname($user);
|
|
if ($entry) {
|
|
echo " <FONT SIZE=1>".get_string("lastedited").": ".userdate($entry->modified)."</FONT>";
|
|
}
|
|
echo "</TR>";
|
|
|
|
echo "\n<TR><TD WIDTH=100% BGCOLOR=\"$THEME->cellcontent\">";
|
|
if ($entry) {
|
|
echo format_text($entry->text, $entry->format);
|
|
} else {
|
|
print_string("noentry", "journal");
|
|
}
|
|
echo "</TD></TR>";
|
|
|
|
if ($entry) {
|
|
echo "\n<TR>";
|
|
echo "<TD WIDTH=35 VALIGN=TOP>";
|
|
if (!$entry->teacher) {
|
|
$entry->teacher = $USER->id;
|
|
}
|
|
print_user_picture($entry->teacher, $course->id, $teachers[$entry->teacher]->picture);
|
|
echo "<TD BGCOLOR=\"$colour\">".get_string("feedback").":";
|
|
choose_from_menu($grades, "r$entry->id", $entry->rating, get_string("nograde")."...");
|
|
if ($entry->timemarked) {
|
|
echo " <FONT SIZE=1>".userdate($entry->timemarked)."</FONT>";
|
|
}
|
|
echo "<BR><TEXTAREA NAME=\"c$entry->id\" ROWS=12 COLS=60 WRAP=virtual>";
|
|
p($entry->comment);
|
|
echo "</TEXTAREA><BR>";
|
|
echo "</TD></TR>";
|
|
}
|
|
echo "</TABLE><BR CLEAR=ALL>\n";
|
|
}
|
|
|
|
|
|
function journal_add_instance($journal) {
|
|
// Given an object containing all the necessary data,
|
|
// (defined by the form in mod.html) this function
|
|
// will create a new instance and return the id number
|
|
// of the new instance.
|
|
|
|
$journal->timemodified = time();
|
|
|
|
return insert_record("journal", $journal);
|
|
}
|
|
|
|
|
|
function journal_update_instance($journal) {
|
|
// Given an object containing all the necessary data,
|
|
// (defined by the form in mod.html) this function
|
|
// will update an existing instance with new data.
|
|
|
|
$journal->timemodified = time();
|
|
$journal->id = $journal->instance;
|
|
|
|
return update_record("journal", $journal);
|
|
}
|
|
|
|
|
|
function journal_delete_instance($id) {
|
|
// Given an ID of an instance of this module,
|
|
// this function will permanently delete the instance
|
|
// and any data that depends on it.
|
|
|
|
if (! $journal = get_record("journal", "id", $id)) {
|
|
return false;
|
|
}
|
|
|
|
$result = true;
|
|
|
|
if (! delete_records("journal_entries", "journal", $journal->id)) {
|
|
$result = false;
|
|
}
|
|
|
|
if (! delete_records("journal", "id", $journal->id)) {
|
|
$result = false;
|
|
}
|
|
|
|
return $result;
|
|
|
|
}
|
|
|
|
|
|
function journal_print_feedback($course, $entry, $grades) {
|
|
global $CFG, $THEME;
|
|
|
|
if (! $teacher = get_record("user", "id", $entry->teacher)) {
|
|
error("Weird journal error");
|
|
}
|
|
|
|
echo "\n<TABLE BORDER=0 CELLPADDING=1 CELLSPACING=1 ALIGN=CENTER><TR><TD BGCOLOR=#888888>";
|
|
echo "\n<TABLE BORDER=0 CELLPADDING=3 CELLSPACING=0 VALIGN=TOP>";
|
|
|
|
echo "\n<TR>";
|
|
echo "\n<TD ROWSPAN=3 BGCOLOR=\"$THEME->body\" WIDTH=35 VALIGN=TOP>";
|
|
print_user_picture($teacher->id, $course->id, $teacher->picture);
|
|
echo "</TD>";
|
|
echo "<TD NOWRAP WIDTH=100% BGCOLOR=\"$THEME->cellheading\">".fullname($teacher);
|
|
echo " <FONT SIZE=2><I>".userdate($entry->timemarked)."</I>";
|
|
echo "</TR>";
|
|
|
|
echo "\n<TR><TD WIDTH=100% BGCOLOR=\"$THEME->cellcontent\">";
|
|
|
|
echo "<P ALIGN=RIGHT><FONT SIZE=-1><I>";
|
|
if ($grades[$entry->rating]) {
|
|
echo get_string("grade").": ";
|
|
echo $grades[$entry->rating];
|
|
} else {
|
|
print_string("nograde");
|
|
}
|
|
echo "</I></FONT></P>";
|
|
|
|
echo format_text($entry->comment);
|
|
echo "</TD></TR></TABLE>";
|
|
echo "</TD></TR></TABLE>";
|
|
}
|
|
|
|
?>
|