1: # The LearningOnline Network with CAPA
2: # Routines for messaging
3: #
4: # $Id: lonmsg.pm,v 1.60 2003/08/12 20:12:05 www Exp $
5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
28: #
29: # (Routines to control the menu
30: #
31: # (TeX Conversion Module
32: #
33: # 05/29/00,05/30 Gerd Kortemeyer)
34: #
35: # 10/05 Gerd Kortemeyer)
36: #
37: # 10/19,10/20,10/30,
38: # 02/06/01 Gerd Kortemeyer
39: # 07/27 Guy Albertelli
40: # 07/27,07/28,07/30,08/03,08/06,08/08,08/09,08/10,8/13,8/15,
41: # 10/1,11/5 Gerd Kortemeyer
42: # YEAR=2002
43: # 1/1,3/18 Gerd Kortemeyer
44: #
45: package Apache::lonmsg;
46:
47: =pod
48:
49: =head1 NAME
50:
51: Apache::lonmsg: supports internal messaging
52:
53: =head1 SYNOPSIS
54:
55: lonmsg provides routines for sending messages, receiving messages, and
56: a handler to allow users to read, send, and delete messages.
57:
58: =head1 OVERVIEW
59:
60: =head2 Messaging Overview
61:
62: X<messages>LON-CAPA provides an internal messaging system similar to
63: email, but customized for LON-CAPA's usage. LON-CAPA implements its
64: own messaging system, rather then building on top of email, because of
65: the features LON-CAPA messages can offer that conventional e-mail can
66: not:
67:
68: =over 4
69:
70: =item * B<Critical messages>: A message the recipient B<must>
71: acknowlegde receipt of before they are allowed to continue using the
72: system, preventing a user from claiming they never got a message
73:
74: =item * B<Receipts>: LON-CAPA can reliably send reciepts informing the
75: sender that it has been read; again, useful for preventing students
76: from claiming they did not see a message. (While conventional e-mail
77: has some reciept support, it's sporadic, e-mail client-specific, and
78: generally the receiver can opt to not send one, making it useless in
79: this case.)
80:
81: =item * B<Context>: LON-CAPA knows about the sender, such as where
82: they are in a course. When a student mails an instructor asking for
83: help on the problem, the instructor receives not just the student's
84: question, but all submissions the student has made up to that point,
85: the user's rendering of the problem, and the complete view the student
86: saw of the resource, including discussion up to that point. Finally,
87: the instructor is reading all of this inside of LON-CAPA, not their
88: email program, so they have full access to LON-CAPA's grading
89: interface, or other features they may wish to use in response to the
90: student's query.
91:
92: =back
93:
94: Users can ask LON-CAPA to forward messages to conventional e-mail
95: addresses on their B<PREF> screen, but generally, LON-CAPA messages
96: are much more useful then traditional email can be made to be, even
97: with HTML support.
98:
99: Right now, this document will cover just how to send a message, since
100: it is likely you will not need to programmatically read messages,
101: since lonmsg already implements that functionality.
102:
103: =head1 FUNCTIONS
104:
105: =over 4
106:
107: =cut
108:
109: use strict;
110: use Apache::lonnet();
111: use vars qw($msgcount);
112: use HTML::TokeParser();
113: use Apache::Constants qw(:common);
114: use Apache::loncommon();
115: use Apache::lontexconvert();
116: use HTML::Entities();
117: use Mail::Send;
118:
119: # ===================================================================== Package
120:
121: sub packagemsg {
122: my ($subject,$message,$citation,$baseurl,$attachmenturl)=@_;
123: $message =&HTML::Entities::encode($message);
124: $citation=&HTML::Entities::encode($citation);
125: $subject =&HTML::Entities::encode($subject);
126: #remove machine specification
127: $baseurl =~ s|^http://[^/]+/|/|;
128: $baseurl =&HTML::Entities::encode($baseurl);
129: #remove machine specification
130: $attachmenturl =~ s|^http://[^/]+/|/|;
131: $attachmenturl =&HTML::Entities::encode($attachmenturl);
132:
133: my $now=time;
134: $msgcount++;
135: my $partsubj=$subject;
136: $partsubj=&Apache::lonnet::escape($partsubj);
137: my $msgid=&Apache::lonnet::escape(
138: $now.':'.$partsubj.':'.$ENV{'user.name'}.':'.
139: $ENV{'user.domain'}.':'.$msgcount.':'.$$);
140: my $result='<sendername>'.$ENV{'user.name'}.'</sendername>'.
141: '<senderdomain>'.$ENV{'user.domain'}.'</senderdomain>'.
142: '<subject>'.$subject.'</subject>'.
143: '<time>'.localtime($now).'</time>'.
144: '<servername>'.$ENV{'SERVER_NAME'}.'</servername>'.
145: '<host>'.$ENV{'HTTP_HOST'}.'</host>'.
146: '<client>'.$ENV{'REMOTE_ADDR'}.'</client>'.
147: '<browsertype>'.$ENV{'browser.type'}.'</browsertype>'.
148: '<browseros>'.$ENV{'browser.os'}.'</browseros>'.
149: '<browserversion>'.$ENV{'browser.version'}.'</browserversion>'.
150: '<browsermathml>'.$ENV{'browser.mathml'}.'</browsermathml>'.
151: '<browserraw>'.$ENV{'HTTP_USER_AGENT'}.'</browserraw>'.
152: '<courseid>'.$ENV{'request.course.id'}.'</courseid>'.
153: '<role>'.$ENV{'request.role'}.'</role>'.
154: '<resource>'.$ENV{'request.filename'}.'</resource>'.
155: '<msgid>'.$msgid.'</msgid>'.
156: '<message>'.$message.'</message>';
157: if (defined($citation)) {
158: $result.='<citation>'.$citation.'</citation>';
159: }
160: if (defined($baseurl)) {
161: $result.= '<baseurl>'.$baseurl.'</baseurl>';
162: }
163: if (defined($attachmenturl)) {
164: $result.= '<attachmenturl>'.$attachmenturl.'</attachmenturl>';
165: }
166: return $msgid,$result;
167: }
168:
169: # ================================================== Unpack message into a hash
170:
171: sub unpackagemsg {
172: my ($message,$notoken)=@_;
173: my %content=();
174: my $parser=HTML::TokeParser->new(\$message);
175: my $token;
176: while ($token=$parser->get_token) {
177: if ($token->[0] eq 'S') {
178: my $entry=$token->[1];
179: my $value=$parser->get_text('/'.$entry);
180: $content{$entry}=$value;
181: }
182: }
183: if ($content{'attachmenturl'}) {
184: my ($fname,$ft)=($content{'attachmenturl'}=~/\/(\w+)\.(\w+)$/);
185: if ($notoken) {
186: $content{'message'}.='<p>Attachment: <tt>'.$fname.'.'.$ft.'</tt>';
187: } else {
188: $content{'message'}.='<p>Attachment: <a href="'.
189: &Apache::lonnet::tokenwrapper($content{'attachmenturl'}).
190: '"><tt>'.$fname.'.'.$ft.'</tt></a>';
191: }
192: }
193: return %content;
194: }
195:
196: # ======================================================= Get info out of msgid
197:
198: sub unpackmsgid {
199: my $msgid=&Apache::lonnet::unescape(shift);
200: my ($sendtime,$shortsubj,$fromname,$fromdomain)=split(/\:/,
201: &Apache::lonnet::unescape($msgid));
202: my %status=&Apache::lonnet::get('email_status',[$msgid]);
203: if ($status{$msgid}=~/^error\:/) { $status{$msgid}=''; }
204: unless ($status{$msgid}) { $status{$msgid}='new'; }
205: return ($sendtime,$shortsubj,$fromname,$fromdomain,$status{$msgid});
206: }
207:
208:
209: sub sendemail {
210: my ($to,$subject,$body)=@_;
211: $body=
212: "*** This is an automatic message generated by the LON-CAPA system.\n".
213: "*** Please do not reply to this address.\n\n".$body;
214: my $msg = new Mail::Send;
215: $msg->to($to);
216: $msg->subject('[LON-CAPA] '.$subject);
217: my $fh = $msg->open('smtp',Server => 'localhost');
218: print $fh $body;
219: $fh->close;
220: }
221:
222: # ==================================================== Send notification emails
223:
224: sub sendnotification {
225: my ($to,$touname,$toudom,$subj,$crit)=@_;
226: my $sender=$ENV{'environment.firstname'}.' '.$ENV{'environment.lastname'};
227: my $critical=($crit?' critical':'');
228: my $url='http://'.
229: $Apache::lonnet::hostname{&Apache::lonnet::homeserver($touname,$toudom)}.
230: '/adm/email?username='.$touname.'&domain='.$toudom;
231: my $body=(<<ENDMSG);
232: You received a$critical message from $sender in LON-CAPA. The subject is
233:
234: $subj
235:
236: Use
237:
238: $url
239:
240: to access this message.
241: ENDMSG
242: &sendemail($to,'New'.$critical.' message from '.$sender,$body);
243: }
244: # ============================================================= Check for email
245:
246: sub newmail {
247: if ((time-$ENV{'user.mailcheck.time'})>300) {
248: my %what=&Apache::lonnet::get('email_status',['recnewemail']);
249: &Apache::lonnet::appenv('user.mailcheck.time'=>time);
250: if ($what{'recnewemail'}>0) { return 1; }
251: }
252: return 0;
253: }
254:
255: # =============================== Automated message to the author of a resource
256:
257: =pod
258:
259: =item * B<author_res_msg($filename, $message)>: Sends message $message to the owner
260: of the resource with the URI $filename.
261:
262: =cut
263:
264: sub author_res_msg {
265: my ($filename,$message)=@_;
266: unless ($message) { return 'empty'; }
267: $filename=&Apache::lonnet::declutter($filename);
268: my ($domain,$author,@dummy)=split(/\//,$filename);
269: my $homeserver=&Apache::lonnet::homeserver($author,$domain);
270: if ($homeserver ne 'no_host') {
271: my $id=unpack("%32C*",$message);
272: my $msgid;
273: ($msgid,$message)=&packagemsg($filename,$message);
274: return &Apache::lonnet::reply('put:'.$domain.':'.$author.
275: ':nohist_res_msgs:'.
276: &Apache::lonnet::escape($filename.'_'.$id).'='.
277: &Apache::lonnet::escape($message),$homeserver);
278: }
279: return 'no_host';
280: }
281:
282: # ================================================== Critical message to a user
283:
284: sub user_crit_msg_raw {
285: my ($user,$domain,$subject,$message,$sendback)=@_;
286: # Check if allowed missing
287: my $status='';
288: my $msgid='undefined';
289: unless (($message)&&($user)&&($domain)) { $status='empty'; };
290: my $homeserver=&Apache::lonnet::homeserver($user,$domain);
291: if ($homeserver ne 'no_host') {
292: ($msgid,$message)=&packagemsg($subject,$message);
293: if ($sendback) { $message.='<sendback>true</sendback>'; }
294: $status=&Apache::lonnet::critical(
295: 'put:'.$domain.':'.$user.':critical:'.
296: &Apache::lonnet::escape($msgid).'='.
297: &Apache::lonnet::escape($message),$homeserver);
298: if ($ENV{'request.course.id'}) {
299: &user_normal_msg_raw(
300: $ENV{'course.'.$ENV{'request.course.id'}.'.num'},
301: $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
302: 'Critical ['.$user.':'.$domain.']',
303: $message);
304: }
305: } else {
306: $status='no_host';
307: }
308: # Notifications
309: my %userenv = &Apache::lonnet::get('environment',['critnotification'],
310: $domain,$user);
311: if ($userenv{'critnotification'}) {
312: &sendnotification($userenv{'critnotification'},$user,$domain,$subject,1);
313: }
314: # Log this
315: &Apache::lonnet::logthis(
316: 'Sending critical email '.$msgid.
317: ', log status: '.
318: &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
319: $ENV{'user.home'},
320: 'Sending critical '.$msgid.' to '.$user.' at '.$domain.' with status: '
321: .$status));
322: return $status;
323: }
324:
325: # New routine that respects "forward" and calls old routine
326:
327: =pod
328:
329: =item * B<user_crit_msg($user, $domain, $subject, $message, $sendback)>: Sends
330: a critical message $message to the $user at $domain. If $sendback is true,
331: a reciept will be sent to the current user when $user recieves the message.
332:
333: =cut
334:
335: sub user_crit_msg {
336: my ($user,$domain,$subject,$message,$sendback)=@_;
337: my $status='';
338: my %userenv = &Apache::lonnet::get('environment',['msgforward'],
339: $domain,$user);
340: my $msgforward=$userenv{'msgforward'};
341: if ($msgforward) {
342: foreach (split(/\,/,$msgforward)) {
343: my ($forwuser,$forwdomain)=split(/\:/,$_);
344: $status.=
345: &user_crit_msg_raw($forwuser,$forwdomain,$subject,$message,
346: $sendback).' ';
347: }
348: } else {
349: $status=&user_crit_msg_raw($user,$domain,$subject,$message,$sendback);
350: }
351: return $status;
352: }
353:
354: # =================================================== Critical message received
355:
356: sub user_crit_received {
357: my $msgid=shift;
358: my %message=&Apache::lonnet::get('critical',[$msgid]);
359: my %contents=&unpackagemsg($message{$msgid},1);
360: my $status='rec: '.($contents{'sendback'}?
361: &user_normal_msg($contents{'sendername'},$contents{'senderdomain'},
362: 'Receipt: '.$ENV{'user.name'}.' at '.$ENV{'user.domain'},
363: 'User '.$ENV{'user.name'}.' at '.$ENV{'user.domain'}.
364: ' acknowledged receipt of message'."\n".' "'.
365: $contents{'subject'}.'"'."\n".'dated '.
366: $contents{'time'}.".\n"
367: ):'no msg req');
368: $status.=' trans: '.
369: &Apache::lonnet::put(
370: 'nohist_email',{$contents{'msgid'} => $message{$msgid}});
371: $status.=' del: '.
372: &Apache::lonnet::del('critical',[$contents{'msgid'}]);
373: &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
374: $ENV{'user.home'},'Received critical message '.
375: $contents{'msgid'}.
376: ', '.$status);
377: return $status;
378: }
379:
380: # ======================================================== Normal communication
381:
382: sub user_normal_msg_raw {
383: my ($user,$domain,$subject,$message,$citation,$baseurl,$attachmenturl)=@_;
384: # Check if allowed missing
385: my $status='';
386: my $msgid='undefined';
387: unless (($message)&&($user)&&($domain)) { $status='empty'; };
388: my $homeserver=&Apache::lonnet::homeserver($user,$domain);
389: if ($homeserver ne 'no_host') {
390: ($msgid,$message)=&packagemsg($subject,$message,$citation,$baseurl,
391: $attachmenturl);
392: $status=&Apache::lonnet::critical(
393: 'put:'.$domain.':'.$user.':nohist_email:'.
394: &Apache::lonnet::escape($msgid).'='.
395: &Apache::lonnet::escape($message),$homeserver);
396: &Apache::lonnet::put
397: ('email_status',{'recnewemail'=>time},$domain,$user);
398: } else {
399: $status='no_host';
400: }
401: # Notifications
402: my %userenv = &Apache::lonnet::get('environment',['notification'],
403: $domain,$user);
404: if ($userenv{'notification'}) {
405: &sendnotification($userenv{'notification'},$user,$domain,$subject,0);
406: }
407: &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
408: $ENV{'user.home'},
409: 'Sending '.$msgid.' to '.$user.' at '.$domain.' with status: '.$status);
410: return $status;
411: }
412:
413: # New routine that respects "forward" and calls old routine
414:
415: =pod
416:
417: =item * B<user_normal_msg($user, $domain, $subject, $message,
418: $citation, $baseurl, $attachmenturl)>: Sends a message to the
419: $user at $domain, with subject $subject and message $message.
420:
421: =cut
422:
423: sub user_normal_msg {
424: my ($user,$domain,$subject,$message,$citation,$baseurl,$attachmenturl)=@_;
425: my $status='';
426: my %userenv = &Apache::lonnet::get('environment',['msgforward'],
427: $domain,$user);
428: my $msgforward=$userenv{'msgforward'};
429: if ($msgforward) {
430: foreach (split(/\,/,$msgforward)) {
431: my ($forwuser,$forwdomain)=split(/\:/,$_);
432: $status.=
433: &user_normal_msg_raw($forwuser,$forwdomain,$subject,$message,
434: $citation,$baseurl,$attachmenturl).' ';
435: }
436: } else {
437: $status=&user_normal_msg_raw($user,$domain,$subject,$message,
438: $citation,$baseurl,$attachmenturl);
439: }
440: return $status;
441: }
442:
443:
444: # =============================================================== Status Change
445:
446: sub statuschange {
447: my ($msgid,$newstatus)=@_;
448: my %status=&Apache::lonnet::get('email_status',[$msgid]);
449: if ($status{$msgid}=~/^error\:/) { $status{$msgid}=''; }
450: unless ($status{$msgid}) { $status{$msgid}='new'; }
451: unless (($status{$msgid} eq 'replied') ||
452: ($status{$msgid} eq 'forwarded')) {
453: &Apache::lonnet::put('email_status',{$msgid => $newstatus});
454: }
455: if (($newstatus eq 'deleted') || ($newstatus eq 'new')) {
456: &Apache::lonnet::put('email_status',{$msgid => $newstatus});
457: }
458: }
459:
460: # ======================================================= Display a course list
461:
462: sub discourse {
463: my $r=shift;
464: my %courselist=&Apache::lonnet::dump(
465: 'classlist',
466: $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
467: $ENV{'course.'.$ENV{'request.course.id'}.'.num'});
468: my $now=time;
469: $r->print(<<ENDDISHEADER);
470: <input type=hidden name=sendmode value=group>
471: <script>
472: function checkall() {
473: for (i=0; i<document.forms.compemail.elements.length; i++) {
474: if
475: (document.forms.compemail.elements[i].name.indexOf('send_to_')==0) {
476: document.forms.compemail.elements[i].checked=true;
477: }
478: }
479: }
480:
481: function checksec() {
482: for (i=0; i<document.forms.compemail.elements.length; i++) {
483: if
484: (document.forms.compemail.elements[i].name.indexOf
485: ('send_to_&&&'+document.forms.compemail.chksec.value)==0) {
486: document.forms.compemail.elements[i].checked=true;
487: }
488: }
489: }
490:
491: function uncheckall() {
492: for (i=0; i<document.forms.compemail.elements.length; i++) {
493: if
494: (document.forms.compemail.elements[i].name.indexOf('send_to_')==0) {
495: document.forms.compemail.elements[i].checked=false;
496: }
497: }
498: }
499: </script>
500: <input type=button onClick="checkall()" value="Check for All">
501: <input type=button onClick="checksec()" value="Check for Section/Group">
502: <input type=text size=5 name=chksec>
503: <input type=button onClick="uncheckall()" value="Check for None">
504: <p>
505: ENDDISHEADER
506: foreach (sort keys %courselist) {
507: my ($end,$start)=split(/\:/,$courselist{$_});
508: my $active=1;
509: if (($end) && ($now>$end)) { $active=0; }
510: if ($active) {
511: my ($sname,$sdom)=split(/\:/,$_);
512: my %reply=&Apache::lonnet::get('environment',
513: ['firstname','middlename','lastname','generation'],
514: $sdom,$sname);
515: my $section=&Apache::lonnet::usection
516: ($sdom,$sname,$ENV{'request.course.id'});
517: $r->print(
518: '<br><input type=checkbox name="send_to_&&&'.$section.'&&&_'.$_.'"> '.
519: $reply{'firstname'}.' '.
520: $reply{'middlename'}.' '.
521: $reply{'lastname'}.' '.
522: $reply{'generation'}.
523: ' ('.$_.') '.$section);
524: }
525: }
526: }
527:
528: # ==================================================== Display Critical Message
529:
530: sub discrit {
531: my $r=shift;
532: my $header = '<h1><font color=red>Critical Messages</font></h1>'.
533: '<form action=/adm/email method=post>'.
534: '<input type=hidden name=confirm value=true>';
535: my %what=&Apache::lonnet::dump('critical');
536: my $result = '';
537: foreach (sort keys %what) {
538: my %content=&unpackagemsg($what{$_});
539: next if ($content{'senderdomain'} eq '');
540: $content{'message'}=~s/\n/\<br\>/g;
541: $result.='<hr>From: <b>'.
542: &Apache::loncommon::aboutmewrapper(
543: &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).'</b> ('.
544: $content{'sendername'}.'@'.
545: $content{'senderdomain'}.') '.$content{'time'}.
546: '<br>Subject: '.$content{'subject'}.
547: '<br><blockquote>'.
548: &Apache::lontexconvert::msgtexconverted($content{'message'}).
549: '</blockquote>'.
550: '<input type=submit name="rec_'.$_.'" value="Confirm Receipt">'.
551: '<input type=submit name="reprec_'.$_.'" '.
552: 'value="Confirm Receipt and Reply">';
553: }
554: # Check to see if there were any messages.
555: if ($result eq '') {
556: $result = "<h2>You have no critical messages.</h2>".
557: '<a href="/adm/roles">Select a course</a>';
558: } else {
559: $r->print($header);
560: }
561: $r->print($result);
562: $r->print('<input type=hidden name="displayedcrit" value="true"></form>');
563: }
564:
565: # =============================================================== Compose reply
566:
567: sub comprep {
568: my ($r,$msgid)=@_;
569: my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
570: my %content=&unpackagemsg($message{$msgid},1);
571: my $quotemsg='> '.$content{'message'};
572: $quotemsg=~s/\r/\n/g;
573: $quotemsg=~s/\f/\n/g;
574: $quotemsg=~s/\n+/\n\> /g;
575: my $torepl=&Apache::loncommon::aboutmewrapper(
576: &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).' ('.
577: $content{'sendername'}.'@'.
578: $content{'senderdomain'}.')';
579: my $subject='Re: '.$content{'subject'};
580: my $dispcrit='';
581: if (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
582: my $crithelp = Apache::loncommon::help_open_topic("Course_Critical_Message");
583: $dispcrit=
584: '<input type=checkbox name=critmsg> Send as critical message ' . $crithelp .
585: '<br>'.
586: '<input type=checkbox name=sendbck> Send as critical message ' .
587: ' and return receipt' . $crithelp . '<p>';
588: }
589: $r->print(<<"ENDREPLY");
590: <form action="/adm/email" method=post>
591: <input type=hidden name=sendreply value="$msgid">
592: To: $torepl<br />
593: Subject: <input type=text size=50 name=subject value="$subject"><p>
594: <textarea name=message cols=84 rows=10 wrap=hard>
595: $quotemsg
596: </textarea><p>
597: $dispcrit
598: <input type=submit value="Send Reply">
599: </form>
600: ENDREPLY
601: }
602:
603: # ======================================================== Display all messages
604:
605: sub disall {
606: my $r=shift;
607: $r->print(<<ENDDISHEADER);
608: <script>
609: function checkall() {
610: for (i=0; i<document.forms.disall.elements.length; i++) {
611: if
612: (document.forms.disall.elements[i].name.indexOf('delmark_')==0) {
613: document.forms.disall.elements[i].checked=true;
614: }
615: }
616: }
617:
618: function uncheckall() {
619: for (i=0; i<document.forms.disall.elements.length; i++) {
620: if
621: (document.forms.disall.elements[i].name.indexOf('delmark_')==0) {
622: document.forms.disall.elements[i].checked=false;
623: }
624: }
625: }
626: </script>
627: ENDDISHEADER
628: $r->print(
629: '<h1>Display All Messages</h1><form method=post name=disall '.
630: 'action="/adm/email">'.
631: '<table border=2><tr><th colspan=2> </th><th>Date</th>'.
632: '<th>Username</th><th>Domain</th><th>Subject</th><th>Status</th></tr>');
633: foreach (sort split(/\&/,&Apache::lonnet::reply('keys:'.
634: $ENV{'user.domain'}.':'.
635: $ENV{'user.name'}.':nohist_email',
636: $ENV{'user.home'}))) {
637: my ($sendtime,$shortsubj,$fromname,$fromdomain,$status)=
638: &Apache::lonmsg::unpackmsgid($_);
639: if (($status ne 'deleted') && defined($sendtime) && $sendtime!~/error/) {
640: if ($status eq 'new') {
641: $r->print('<tr bgcolor="#FFBB77">');
642: } elsif ($status eq 'read') {
643: $r->print('<tr bgcolor="#BBBB77">');
644: } elsif ($status eq 'replied') {
645: $r->print('<tr bgcolor="#AAAA88">');
646: } else {
647: $r->print('<tr bgcolor="#99BBBB">');
648: }
649: $r->print('<td><a href="/adm/email?display='.$_.
650: '">Open</a></td><td><a href="/adm/email?markdel='.$_.
651: '">Delete</a><input type=checkbox name="delmark_'.$_.'"></td>'.
652: '<td>'.localtime($sendtime).'</td><td>'.
653: $fromname.'</td><td>'.$fromdomain.'</td><td>'.
654: &Apache::lonnet::unescape($shortsubj).'</td><td>'.
655: $status.'</td></tr>');
656: }
657: }
658: $r->print('</table><p>'.
659: '<a href="javascript:checkall()">Check All</a> '.
660: '<a href="javascript:uncheckall()">Uncheck All</a><p>'.
661: '<input type=submit name="markeddel" value="Delete Checked">'.
662: '</form></body></html>');
663: }
664:
665: # ============================================================== Compose output
666:
667: sub compout {
668: my ($r,$forwarding,$broadcast)=@_;
669: my $dispcrit='';
670: my $dissub='';
671: my $dismsg='';
672: my $func='Send New';
673: if (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
674: my $crithelp = Apache::loncommon::help_open_topic("Course_Critical_Message");
675: $dispcrit=
676: '<input type=checkbox name=critmsg> Send as critical message ' . $crithelp .
677: '<br>'.
678: '<input type=checkbox name=sendbck> Send as critical message ' .
679: ' and return receipt' . $crithelp . '<p>';
680: }
681: if ($forwarding) {
682: $dispcrit.='<input type=hidden name=forwid value="'.
683: $forwarding.'">';
684: $func='Forward';
685: my %message=&Apache::lonnet::get('nohist_email',[$forwarding]);
686: my %content=&unpackagemsg($message{$forwarding});
687:
688: $dissub='Forwarding: '.$content{'subject'};
689: $dismsg='Forwarded message from '.
690: $content{'sendername'}.' at '.$content{'senderdomain'};
691: }
692: my $defdom=$ENV{'user.domain'};
693: if ($ENV{'form.recdom'}) { $defdom=$ENV{'form.recdom'}; }
694: $r->print(
695: '<form action="/adm/email" name="compemail" method="post"'.
696: ' enctype="multipart/form-data">'."\n".
697: '<input type="hidden" name="sendmail" value="on">'."\n".
698: '<table>');
699: unless (($broadcast eq 'group') || ($broadcast eq 'upload')) {
700: my $domform = &Apache::loncommon::select_dom_form($defdom,'recdomain');
701: my $selectlink=&Apache::loncommon::selectstudent_link
702: ('compemail','recuname','recdomain');
703: $r->print(<<"ENDREC");
704: <table>
705: <tr><td>Username:</td><td><input type=text size=12 name=recuname value="$ENV{'form.recname'}"></td><td rowspan="2">$selectlink</td></tr>
706: <tr><td>Domain:</td>
707: <td>$domform</td></tr>
708: ENDREC
709: }
710: my $latexHelp = Apache::loncommon::helpLatexCheatsheet();
711: if ($broadcast ne 'upload') {
712: $r->print(<<"ENDCOMP");
713: <tr><td>Additional Recipients<br><tt>username\@domain,username\@domain, ...
714: </tt></td><td>
715: <input type=text size=50 name=additionalrec></td></tr>
716: <tr><td>Subject:</td><td><input type=text size=50 name=subject value="$dissub">
717: </td></tr></table>
718: $latexHelp
719: <textarea name=message cols=80 rows=10 wrap=hard>$dismsg
720: </textarea><p>
721: $dispcrit
722: <input type=submit value="$func Mail">
723: ENDCOMP
724: } else { # $broadcast is 'upload'
725: $r->print(<<ENDUPLOAD);
726: <input type=hidden name=sendmode value=upload>
727: <h3>Generate messages from a file</h3>
728: <p>
729: Subject: <input type=text size=50 name=subject>
730: </p>
731: <p>General message text<br />
732: <textarea name=message cols=60 rows=10 wrap=hard>$dismsg
733: </textarea></p>
734: <p>
735: The file format for the uploaded portion of the message is:
736: <pre>
737: username1\@domain1: text
738: username2\@domain2: text
739: username3\@domain1: text
740: </pre>
741: </p>
742: <p>
743: The messages will be assembled from all lines with the respective
744: <tt>username\@domain</tt>, and appended to the general message text.</p>
745: <p>
746: <input type=file name=upfile size=20><p>
747: $dispcrit
748: <input type=submit value="Upload and send">
749: ENDUPLOAD
750: }
751: if ($broadcast eq 'group') {
752: &discourse;
753: }
754: $r->print('</form>');
755: }
756:
757: # ---------------------------------------------------- Display all face to face
758:
759: sub disfacetoface {
760: my ($r,$user,$domain)=@_;
761: unless ($ENV{'request.course.id'}) { return; }
762: unless (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
763: return;
764: }
765: my %records=&Apache::lonnet::dump('nohist_email',
766: $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
767: $ENV{'course.'.$ENV{'request.course.id'}.'.num'},
768: '%255b'.$user.'%253a'.$domain.'%255d');
769: my $result='';
770: foreach (sort keys %records) {
771: my %content=&unpackagemsg($records{$_});
772: next if ($content{'senderdomain'} eq '');
773: $content{'message'}=~s/\n/\<br\>/g;
774: if ($content{'subject'}=~/^Record/) {
775: $result.='<h3>Record</h3>';
776: } else {
777: $result.='<h3>Sent Message</h3>';
778: %content=&unpackagemsg($content{'message'});
779: $content{'message'}=
780: '<b>Subject: '.$content{'subject'}.'</b><br />'.
781: $content{'message'};
782: }
783: $result.='By: <b>'.
784: &Apache::loncommon::aboutmewrapper(
785: &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).'</b> ('.
786: $content{'sendername'}.'@'.
787: $content{'senderdomain'}.') '.$content{'time'}.
788: '<br><blockquote>'.
789: &Apache::lontexconvert::msgtexconverted($content{'message'}).
790: '</blockquote>';
791: }
792: # Check to see if there were any messages.
793: if ($result eq '') {
794: $r->print("<p><b>No notes, face-to-face discussion records, or critical messages in this course.</b></p>");
795: } else {
796: $r->print($result);
797: }
798: }
799:
800: # ---------------------------------------------------------------- Face to face
801:
802: sub facetoface {
803: my ($r,$stage)=@_;
804: unless (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
805: return;
806: }
807: # from query string
808: if ($ENV{'form.recname'}) { $ENV{'form.recuname'}=$ENV{'form.recname'}; }
809: if ($ENV{'form.recdom'}) { $ENV{'form.recdomain'}=$ENV{'form.recdom'}; }
810:
811: my $defdom=$ENV{'user.domain'};
812: # already filled in
813: if ($ENV{'form.recdomain'}) { $defdom=$ENV{'form.recdomain'}; }
814: # generate output
815: my $domform = &Apache::loncommon::select_dom_form($defdom,'recdomain');
816: my $stdbrws = &Apache::loncommon::selectstudent_link
817: ('stdselect','recuname','recdomain');
818: $r->print(<<"ENDTREC");
819: <h3>User Notes, Records of Face-To-Face Discussions, and Critical Messages in Course</h3>
820: <form method="post" action="/adm/email" name="stdselect">
821: <input type="hidden" name="recordftf" value="retrieve" />
822: <table>
823: <tr><td>Username:</td><td><input type=text size=12 name=recuname value="$ENV{'form.recuname'}"></td>
824: <td rowspan="2">
825: $stdbrws
826: <input type="submit" value="Retrieve discussion and message records"></td>
827: </tr>
828: <tr><td>Domain:</td>
829: <td>$domform</td></tr>
830: </table>
831: </form>
832: ENDTREC
833: if (($stage ne 'query') &&
834: ($ENV{'form.recdomain'}) && ($ENV{'form.recuname'})) {
835: chomp($ENV{'form.newrecord'});
836: if ($ENV{'form.newrecord'}) {
837: &user_normal_msg_raw(
838: $ENV{'course.'.$ENV{'request.course.id'}.'.num'},
839: $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
840: 'Record ['.$ENV{'form.recuname'}.':'.$ENV{'form.recdomain'}.']',
841: $ENV{'form.newrecord'});
842: }
843: $r->print('<h3>'.&Apache::loncommon::plainname($ENV{'form.recuname'},
844: $ENV{'form.recdomain'}).'</h3>');
845: &disfacetoface($r,$ENV{'form.recuname'},$ENV{'form.recdomain'});
846: $r->print(<<ENDRHEAD);
847: <form method="post" action="/adm/email">
848: <input name="recdomain" value="$ENV{'form.recdomain'}" type="hidden" />
849: <input name="recuname" value="$ENV{'form.recuname'}" type="hidden" />
850: ENDRHEAD
851: $r->print(<<ENDBFORM);
852: <hr />New Record (record is visible to course faculty and staff)<br />
853: <textarea name="newrecord" cols="80" rows="10" wrap="hard"></textarea>
854: <br />
855: <input type="hidden" name="recordftf" value="post" />
856: <input type="submit" value="Post this record" />
857: </form>
858: ENDBFORM
859: }
860: }
861:
862: # ===================================================================== Handler
863:
864: sub handler {
865: my $r=shift;
866:
867: # ----------------------------------------------------------- Set document type
868:
869: $r->content_type('text/html');
870: $r->send_http_header;
871:
872: return OK if $r->header_only;
873:
874: # --------------------------- Get query string for limited number of parameters
875: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
876: ['display','replyto','forward','markread','markdel','markunread',
877: 'sendreply','compose','sendmail','critical','recname','recdom',
878: 'recordftf']);
879:
880: # ------------------------------------------------------ They checked for email
881: &Apache::lonnet::put('email_status',{'recnewemail'=>0});
882: # --------------------------------------------------------------- Render Output
883: if (!$ENV{'form.display'}) {
884: $r->print('<html><head><title>EMail and Messaging</title>'.
885: &Apache::loncommon::studentbrowser_javascript().'</head>'.
886: &Apache::loncommon::bodytag('EMail and Messages'));
887: }
888: if ($ENV{'form.display'}) {
889: my $msgid=$ENV{'form.display'};
890: &statuschange($msgid,'read');
891: my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
892: my %content=&unpackagemsg($message{$msgid});
893: $r->print('<html><head><title>EMail and Messaging</title>');
894: if (defined($content{'baseurl'})) {
895: $r->print("<base href=\"http://$ENV{'SERVER_NAME'}/$content{'baseurl'}\" />");
896: }
897: $r->print(&Apache::loncommon::studentbrowser_javascript().
898: '</head>'.
899: &Apache::loncommon::bodytag('EMail and Messages'));
900: $r->print('<b>Subject:</b> '.$content{'subject'}.
901: '<br><b>From:</b> '.
902: &Apache::loncommon::aboutmewrapper(
903: &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),
904: $content{'sendername'},$content{'senderdomain'}).' ('.
905: $content{'sendername'}.' at '.
906: $content{'senderdomain'}.') '.
907: '<br><b>Time:</b> '.$content{'time'}.'<p>'.
908: '<table border=2><tr bgcolor="#FFFFAA"><td>Functions:</td>'.
909: '<td><a href="/adm/email?replyto='.&Apache::lonnet::escape($msgid).
910: '"><b>Reply</b></a></td>'.
911: '<td><a href="/adm/email?forward='.&Apache::lonnet::escape($msgid).
912: '"><b>Forward</b></a></td>'.
913: '<td><a href="/adm/email?markunread='.&Apache::lonnet::escape($msgid).
914: '"><b>Mark Unread</b></a></td>'.
915: '<td><a href="/adm/email?markdel='.&Apache::lonnet::escape($msgid).
916: '"><b>Delete</b></a></td>'.
917: '<td><a href="/adm/email"><b>Display all Messages</b></a></td>'.
918: '</tr></table><p><pre>'.
919: &Apache::lontexconvert::msgtexconverted($content{'message'}).
920: '</pre><hr>'.$content{'citation'});
921: } elsif ($ENV{'form.replyto'}) {
922: &comprep($r,$ENV{'form.replyto'});
923: } elsif ($ENV{'form.sendreply'}) {
924: my $msgid=$ENV{'form.sendreply'};
925: my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
926: my %content=&unpackagemsg($message{$msgid},1);
927: &statuschange($msgid,'replied');
928: if ((($ENV{'form.critmsg'}) || ($ENV{'form.sendbck'})) &&
929: (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'}))) {
930: $r->print('Sending critical: '.
931: &user_crit_msg($content{'sendername'},
932: $content{'senderdomain'},
933: &Apache::lonfeedback::clear_out_html($ENV{'form.subject'}),
934: &Apache::lonfeedback::clear_out_html($ENV{'form.message'}),
935: $ENV{'form.sendbck'}));
936: } else {
937: $r->print('Sending: '.&user_normal_msg($content{'sendername'},
938: $content{'senderdomain'},
939: &Apache::lonfeedback::clear_out_html($ENV{'form.subject'}),
940: &Apache::lonfeedback::clear_out_html($ENV{'form.message'})));
941: }
942: if ($ENV{'form.displayedcrit'}) {
943: &discrit($r);
944: } else {
945: &disall($r);
946: }
947: } elsif ($ENV{'form.confirm'}) {
948: foreach (keys %ENV) {
949: if ($_=~/^form\.rec\_(.*)$/) {
950: $r->print('<b>Confirming Receipt:</b> '.
951: &user_crit_received($1).'<br>');
952: }
953: if ($_=~/^form\.reprec\_(.*)$/) {
954: my $msgid=$1;
955: $r->print('<b>Confirming Receipt:</b> '.
956: &user_crit_received($msgid).'<br>');
957: &comprep($r,$msgid);
958: }
959: }
960: &discrit($r);
961: } elsif ($ENV{'form.critical'}) {
962: &discrit($r);
963: } elsif ($ENV{'form.forward'}) {
964: &compout($r,$ENV{'form.forward'});
965: } elsif ($ENV{'form.markread'}) {
966: } elsif ($ENV{'form.markdel'}) {
967: &statuschange($ENV{'form.markdel'},'deleted');
968: &disall($r);
969: } elsif ($ENV{'form.markeddel'}) {
970: my $total=0;
971: foreach (keys %ENV) {
972: if ($_=~/^form\.delmark_(.*)$/) {
973: &statuschange(&Apache::lonnet::unescape($1),'deleted');
974: $total++;
975: }
976: }
977: $r->print('Deleted '.$total.' message(s)<p>');
978: &disall($r);
979: } elsif ($ENV{'form.markunread'}) {
980: &statuschange($ENV{'form.markunread'},'new');
981: &disall($r);
982: } elsif ($ENV{'form.compose'}) {
983: &compout($r,'',$ENV{'form.compose'});
984: } elsif ($ENV{'form.recordftf'}) {
985: &facetoface($r,$ENV{'form.recordftf'});
986: } elsif ($ENV{'form.sendmail'}) {
987: my %content=();
988: undef %content;
989: if ($ENV{'form.forwid'}) {
990: my $msgid=$ENV{'form.forwid'};
991: my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
992: %content=&unpackagemsg($message{$msgid},1);
993: &statuschange($msgid,'forwarded');
994: $ENV{'form.message'}.="\n\n-- Forwarded message --\n\n".
995: $content{'message'};
996: }
997: my %toaddr=();
998: undef %toaddr;
999: if ($ENV{'form.sendmode'} eq 'group') {
1000: foreach (keys %ENV) {
1001: if ($_=~/^form\.send\_to\_\&\&\&[^\&]*\&\&\&\_(.+)$/) {
1002: $toaddr{$1}='';
1003: }
1004: }
1005: } elsif ($ENV{'form.sendmode'} eq 'upload') {
1006: foreach (split(/[\n\r\f]+/,$ENV{'form.upfile'})) {
1007: my ($rec,$txt)=split(/\s*\:\s*/,$_);
1008: if ($txt) {
1009: $rec=~s/\@/\:/;
1010: $toaddr{$rec}.=$txt."\n";
1011: }
1012: }
1013: } else {
1014: $toaddr{$ENV{'form.recuname'}.':'.$ENV{'form.recdomain'}}='';
1015: }
1016: if ($ENV{'form.additionalrec'}) {
1017: foreach (split(/\,/,$ENV{'form.additionalrec'})) {
1018: my ($auname,$audom)=split(/\@/,$_);
1019: $toaddr{$auname.':'.$audom}='';
1020: }
1021: }
1022: foreach (keys %toaddr) {
1023: my ($recuname,$recdomain)=split(/\:/,$_);
1024: my $msgtxt=&Apache::lonfeedback::clear_out_html($ENV{'form.message'});
1025: if ($toaddr{$_}) { $msgtxt.='<hr>'.$toaddr{$_}; }
1026: if ((($ENV{'form.critmsg'}) || ($ENV{'form.sendbck'})) &&
1027: (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'}))) {
1028: $r->print('Sending critical: '.
1029: &user_crit_msg($recuname,$recdomain,
1030: &Apache::lonfeedback::clear_out_html($ENV{'form.subject'}),
1031: $msgtxt,
1032: $ENV{'form.sendbck'}));
1033: } else {
1034: $r->print('Sending: '.&user_normal_msg($recuname,$recdomain,
1035: &Apache::lonfeedback::clear_out_html($ENV{'form.subject'}),
1036: $msgtxt,
1037: $content{'citation'}));
1038: }
1039: $r->print('<br>');
1040: }
1041: if ($ENV{'form.displayedcrit'}) {
1042: &discrit($r);
1043: } else {
1044: &disall($r);
1045: }
1046: } else {
1047: &disall($r);
1048: }
1049: $r->print('</body></html>');
1050: return OK;
1051:
1052: }
1053: # ================================================= Main program, reset counter
1054:
1055: BEGIN {
1056: $msgcount=0;
1057: }
1058:
1059: =pod
1060:
1061: =back
1062:
1063: =cut
1064:
1065: 1;
1066:
1067: __END__
1068:
1069:
1070:
1071:
1072:
1073:
1074:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>