File:  [LON-CAPA] / loncom / interface / lonmsg.pm
Revision 1.14: download - view: text, annotated - select for diffs
Fri Aug 3 17:16:48 2001 UTC (22 years, 10 months ago) by www
Branches: MAIN
CVS tags: HEAD
Mark as deleted.

    1: # The LearningOnline Network with CAPA
    2: #
    3: # Routines for messaging
    4: #
    5: # (Routines to control the menu
    6: #
    7: # (TeX Conversion Module
    8: #
    9: # 05/29/00,05/30 Gerd Kortemeyer)
   10: #
   11: # 10/05 Gerd Kortemeyer)
   12: #
   13: # 10/19,10/20,10/30,
   14: # 02/06/01 Gerd Kortemeyer
   15: # 07/27 Guy Albertelli
   16: # 07/27,07/28,07/30,08/03 Gerd Kortemeyer
   17: 
   18: package Apache::lonmsg;
   19: 
   20: use strict;
   21: use Apache::lonnet();
   22: use vars qw($msgcount);
   23: use HTML::TokeParser;
   24: use Apache::Constants qw(:common);
   25: 
   26: # ===================================================================== Package
   27: 
   28: sub packagemsg {
   29:     my ($subject,$message,$citation)=@_;
   30:     $message=~s/\</\&lt\;/g;
   31:     $message=~s/\>/\&gt\;/g;
   32:     $citation=~s/\</\&lt\;/g;
   33:     $citation=~s/\>/\&gt\;/g;
   34:     $subject=~s/\</\&lt\;/g;
   35:     $subject=~s/\>/\&gt\;/g;
   36:     my $now=time;
   37:     $msgcount++;
   38:     my $partsubj=$subject;
   39:     $partsubj=&Apache::lonnet::escape($partsubj);
   40:     $partsubj=substr($partsubj,0,50);
   41:     my $msgid=&Apache::lonnet::escape(
   42:            $now.':'.$partsubj.':'.$ENV{'user.name'}.':'.
   43:            $ENV{'user.domain'}.':'.$msgcount.':'.$$);
   44:     return $msgid,
   45:            '<sendername>'.$ENV{'user.name'}.'</sendername>'.
   46:            '<senderdomain>'.$ENV{'user.domain'}.'</senderdomain>'.
   47:            '<subject>'.$subject.'</subject>'.
   48: 	   '<time>'.localtime($now).'</time>'.
   49: 	   '<servername>'.$ENV{'SERVER_NAME'}.'</servername>'.
   50:            '<host>'.$ENV{'HTTP_HOST'}.'</host>'.
   51: 	   '<client>'.$ENV{'REMOTE_ADDR'}.'</client>'.
   52: 	   '<browsertype>'.$ENV{'browser.type'}.'</browsertype>'.
   53: 	   '<browseros>'.$ENV{'browser.os'}.'</browseros>'.
   54: 	   '<browserversion>'.$ENV{'browser.version'}.'</browserversion>'.
   55:            '<browsermathml>'.$ENV{'browser.mathml'}.'</browsermathml>'.
   56: 	   '<browserraw>'.$ENV{'HTTP_USER_AGENT'}.'</browserraw>'.
   57: 	   '<courseid>'.$ENV{'request.course.id'}.'</courseid>'.
   58: 	   '<role>'.$ENV{'request.role'}.'</role>'.
   59: 	   '<resource>'.$ENV{'request.filename'}.'</resource>'.
   60:            '<msgid>'.$msgid.'</msgid>'.
   61: 	   '<message>'.$message.'</message>'.
   62: 	   '<citation>'.$citation.'</citation>';
   63: }
   64: 
   65: # ================================================== Unpack message into a hash
   66: 
   67: sub unpackagemsg {
   68:     my $message=shift;
   69:     my %content=();
   70:     my $parser=HTML::TokeParser->new(\$message);
   71:     my $token;
   72:     while ($token=$parser->get_token) {
   73:        if ($token->[0] eq 'S') {
   74: 	   my $entry=$token->[1];
   75:            my $value=$parser->get_text('/'.$entry);
   76:            $content{$entry}=$value;
   77:        }
   78:     }
   79:     return %content;
   80: }
   81: 
   82: # ======================================================= Get info out of msgid
   83: 
   84: sub unpackmsgid {
   85:     my $msgid=&Apache::lonnet::unescape(shift);
   86:     my ($sendtime,$shortsubj,$fromname,$fromdomain)=split(/\:/,
   87:                           &Apache::lonnet::unescape($msgid));
   88:     my %status=&Apache::lonnet::get('email_status',[$msgid]);
   89:     if ($status{$msgid}=~/^error\:/) { $status{$msgid}=''; }
   90:     unless ($status{$msgid}) { $status{$msgid}='new'; }
   91:     return ($sendtime,$shortsubj,$fromname,$fromdomain,$status{$msgid});
   92: } 
   93: 
   94: # =============================== Automated message to the author of a resource
   95: 
   96: sub author_res_msg {
   97:     my ($filename,$message)=@_;
   98:     unless ($message) { return 'empty'; }
   99:     $filename=&Apache::lonnet::declutter($filename);
  100:     my ($domain,$author,@dummy)=split(/\//,$filename);
  101:     my $homeserver=&Apache::lonnet::homeserver($author,$domain);
  102:     if ($homeserver ne 'no_host') {
  103:        my $id=unpack("%32C*",$message);
  104:        my $msgid;
  105:        ($msgid,$message)=&packagemsg($filename,$message);
  106:        return &Apache::lonnet::reply('put:'.$domain.':'.$author.
  107:          ':nohist_res_msgs:'.
  108:           &Apache::lonnet::escape($filename.'_'.$id).'='.
  109:           &Apache::lonnet::escape($message),$homeserver);
  110:     }
  111:     return 'no_host';
  112: }
  113: 
  114: # ================================================== Critical message to a user
  115: 
  116: sub user_crit_msg {
  117:     my ($user,$domain,$subject,$message)=@_;
  118: # Check if allowed missing
  119:     my $status='';
  120:     my $msgid='undefined';
  121:     unless (($message)&&($user)&&($domain)) { $status='empty'; };
  122:     my $homeserver=&Apache::lonnet::homeserver($user,$domain);
  123:     if ($homeserver ne 'no_host') {
  124:        my $msgid;
  125:        ($msgid,$message)=&packagemsg($subject,$message);
  126:        $status=&Apache::lonnet::critical(
  127:            'put:'.$domain.':'.$user.':critical:'.
  128:            &Apache::lonnet::escape($msgid).'='.
  129:            &Apache::lonnet::escape($message),$homeserver);
  130:     } else {
  131:        $status='no_host';
  132:     }
  133:     &Apache::lonnet::logthis(
  134:       'Sending critical email '.$msgid.
  135:       ', log status: '.
  136:       &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
  137:                          $ENV{'user.home'},
  138:       'Sending critical '.$msgid.' to '.$user.' at '.$domain.' with status: '
  139:       .$status));
  140:     return $status;
  141: }
  142: 
  143: # =================================================== Critical message received
  144: 
  145: sub user_crit_received {
  146:     my $msgid=shift;
  147:     my %message=&Apache::lonnet::get('critical',[$msgid]);
  148:     my %contents=&unpackagemsg($message{$msgid});
  149:     my $status='rec: '.
  150:      &user_normal_msg($contents{'sendername'},$contents{'senderdomain'},
  151:                      'Receipt: '.$ENV{'user.name'}.' at '.$ENV{'user.domain'},
  152:                      'User '.$ENV{'user.name'}.' at '.$ENV{'user.domain'}.
  153:                      ' acknowledged receipt of message "'.
  154:                      $contents{'subject'}.'" dated '.$contents{'time'}.".\n\n"
  155:                      .'Message ID: '.$contents{'msgid'});
  156:     $status.=' trans: '.
  157:      &Apache::lonnet::put(
  158:      'nohist_email',{$contents{'msgid'} => $message{$msgid}});
  159:     $status.=' del: '.
  160:      &Apache::lonnet::del('critical',[$contents{'msgid'}]);
  161:     &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
  162:                          $ENV{'user.home'},'Received critical message '.
  163:                          $contents{'msgid'}.
  164:                          ', '.$status);
  165:     return $status;
  166: }
  167: 
  168: # ======================================================== Normal communication
  169: 
  170: sub user_normal_msg {
  171:     my ($user,$domain,$subject,$message,$citation)=@_;
  172: # Check if allowed missing
  173:     my $status='';
  174:     my $msgid='undefined';
  175:     unless (($message)&&($user)&&($domain)) { $status='empty'; };
  176:     my $homeserver=&Apache::lonnet::homeserver($user,$domain);
  177:     if ($homeserver ne 'no_host') {
  178:        my $msgid;
  179:        ($msgid,$message)=&packagemsg($subject,$message,$citation);
  180:        $status=&Apache::lonnet::critical(
  181:            'put:'.$domain.':'.$user.':nohist_email:'.
  182:            &Apache::lonnet::escape($msgid).'='.
  183:            &Apache::lonnet::escape($message),$homeserver);
  184:     } else {
  185:        $status='no_host';
  186:     }
  187:     &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
  188:                          $ENV{'user.home'},
  189:       'Sending '.$msgid.' to '.$user.' at '.$domain.' with status: '.$status);
  190:     return $status;
  191: }
  192: 
  193: # =============================================================== Status Change
  194: 
  195: sub statuschange {
  196:     my ($msgid,$newstatus)=@_;
  197:     my %status=&Apache::lonnet::get('email_status',[$msgid]);
  198:     if ($status{$msgid}=~/^error\:/) { $status{$msgid}=''; }
  199:     unless ($status{$msgid}) { $status{$msgid}='new'; }
  200:     unless (($status{$msgid} eq 'replied') || 
  201:             ($status{$msgid} eq 'forwarded')) {
  202: 	&Apache::lonnet::put('email_status',{$msgid => $newstatus});
  203:     }
  204:     if (($newstatus eq 'deleted') || ($newstatus eq 'new')) {
  205: 	&Apache::lonnet::put('email_status',{$msgid => $newstatus});
  206:     }
  207: }
  208: 
  209: # ==================================================== Display Critical Message
  210: 
  211: sub discrit {
  212:     my $r=shift;
  213:       $r->print('<h1><font color=red>Critical Messages</font></h1>'.
  214:          '<form action=/adm/email method=post>'.
  215:          '<input type=hidden name=confirm value=true>');
  216:       my %what=&Apache::lonnet::dump('critical');
  217:       map {
  218:           my %content=&unpackagemsg($what{$_});
  219:           $content{'message'}=~s/\n/\<br\>/g;
  220: 	  $r->print('<hr>From: <b>'.$content{'sendername'}.'@'.
  221:                     $content{'senderdomain'}.'</b> ('.$content{'time'}.
  222:                     ')<br><blockquote>'.$content{'message'}.'</blockquote>'.
  223:   '<input type=submit name="rec_'.$_.'" value="Confirm Receipt">'.
  224:  '<input type=submit name="reprec_'.$_.'" value="Confirm Receipt and Reply">');
  225:       } sort keys %what;
  226:       $r->print('</form>');
  227: }
  228: 
  229: # =============================================================== Compose reply
  230: 
  231: sub comprep {
  232:     my ($r,$msgid)=@_;
  233:       my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
  234:       my %content=&unpackagemsg($message{$msgid});
  235:       my $quotemsg='> '.$content{'message'};
  236:       $quotemsg=~s/\r/\n/g;
  237:       $quotemsg=~s/\f/\n/g;
  238:       $quotemsg=~s/\n+/\n\> /g;
  239:       my $subject='Re: '.$content{'subject'};
  240:       my $dispcrit='';
  241:       if (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
  242:          $dispcrit=
  243: 	     '<input type=checkbox name=critmsg> Send as critical message<p>';
  244:       }
  245:       $r->print(<<"ENDREPLY");
  246: <form action="/adm/email" method=post>
  247: <input type=hidden name=sendreply value="$msgid">
  248: Subject: <input type=text size=50 name=subject value="$subject"><p>
  249: <textarea name=message cols=60 rows=10>
  250: $quotemsg
  251: </textarea><p>
  252: $dispcrit
  253: <input type=submit value="Send Reply">
  254: </form>
  255: ENDREPLY
  256: }
  257: 
  258: sub disall {
  259:     my $r=shift;
  260:     $r->print('<h1>Display All Messages</h1>'.
  261:      '<table border=2><tr><th colspan=2>&nbsp</th><th>Date</th>'.
  262:      '<th>Username</th><th>Domain</th><th>Subject</th><th>Status</th></tr>');
  263:     map {
  264:         my ($sendtime,$shortsubj,$fromname,$fromdomain,$status)=
  265: 	    &Apache::lonmsg::unpackmsgid($_);
  266:        unless ($status eq 'deleted') {
  267:         if ($status eq 'new') {
  268: 	    $r->print('<tr bgcolor="#FFBB77">');
  269:         } elsif ($status eq 'read') {
  270: 	    $r->print('<tr bgcolor="#BBBB77">');
  271:         } elsif ($status eq 'replied') {
  272: 	    $r->print('<tr bgcolor="#AAAA88">');
  273: 	} else {
  274: 	    $r->print('<tr bgcolor="#99BBBB">');
  275:         }
  276:         $r->print('<td><a href="/adm/email?display='.$_.
  277:                   '">Open</a></td><td><a href="/adm/email?markdel='.$_.
  278:                   '">Delete</a></td><td>'.localtime($sendtime).'</td><td>'.
  279:                   $fromname.'</td><td>'.$fromdomain.'</td><td>'.
  280: 		      &Apache::lonnet::unescape($shortsubj).'</td><td>'.
  281:                       $status.'</td></tr>');
  282:        }
  283:     } sort split(/\&/,&Apache::lonnet::reply('keys:'.
  284: 					$ENV{'user.domain'}.':'.
  285:                                         $ENV{'user.name'}.':nohist_email',
  286:                                         $ENV{'user.home'}));
  287:     $r->print('</table></body></html>');
  288: }
  289: 
  290: # ===================================================================== Handler
  291: 
  292: sub handler {
  293:     my $r=shift;
  294: 
  295: # ----------------------------------------------------------- Set document type
  296: 
  297:   $r->content_type('text/html');
  298:   $r->send_http_header;
  299: 
  300:   return OK if $r->header_only;
  301: 
  302: # --------------------------- Get query string for limited number of parameters
  303: 
  304:     map {
  305:        my ($name, $value) = split(/=/,$_);
  306:        $value =~ tr/+/ /;
  307:        $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
  308:        if (($name eq 'display') || ($name eq 'replyto') || 
  309:            ($name eq 'forward') || ($name eq 'markread') ||
  310:            ($name eq 'markdel') || ($name eq 'markunread') ||
  311:            ($name eq 'sendreply') || ($name eq 'compose') ||
  312:            ($name eq 'sendmail') || ($name eq 'critical')) {
  313:            unless ($ENV{'form.'.$name}) {
  314:               $ENV{'form.'.$name}=$value;
  315: 	   }
  316:        }
  317:     } (split(/&/,$ENV{'QUERY_STRING'}));
  318: 
  319: # --------------------------------------------------------------- Render Output
  320:   
  321:   $r->print('<html><head><title>EMail and Messaging</title></head>');
  322:   $r->print(
  323:    '<body bgcolor="#FFFFFF"><img align=right src=/adm/lonIcons/lonlogos.gif>');
  324:   $r->print('<h1>EMail</h1>');
  325:   if ($ENV{'form.display'}) {
  326:       my $msgid=$ENV{'form.display'};
  327:       &statuschange($msgid,'read');
  328:       my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
  329:       my %content=&unpackagemsg($message{$msgid});
  330:       $r->print('<b>Subject:</b> '.$content{'subject'}.
  331:              '<br><b>From:</b> '.$content{'sendername'}.' at '.
  332:                                  $content{'senderdomain'}.
  333:              '<br><b>Time:</b> '.$content{'time'}.'<p>'.
  334:              '<table border=2><tr bgcolor="#FFFFAA"><td>Functions:</td>'.
  335:            '<td><a href="/adm/email?replyto='.&Apache::lonnet::escape($msgid).
  336:              '"><b>Reply</b></a></td>'.
  337:            '<td><a href="/adm/email?replyto='.&Apache::lonnet::escape($msgid).
  338:              '"><b>Forward</b></a></td>'.
  339:              '</tr></table><p><pre>'.
  340:              $content{'message'}.'</pre><hr>'.$content{'citation'});
  341:   } elsif ($ENV{'form.replyto'}) {
  342:       &comprep($r,$ENV{'form.replyto'});
  343:   } elsif ($ENV{'form.sendreply'}) {
  344:       my $msgid=$ENV{'form.sendreply'};
  345:       my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
  346:       my %content=&unpackagemsg($message{$msgid});
  347:       &statuschange($msgid,'replied');
  348:       if (($ENV{'form.critmsg'}) && 
  349:           (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'}))) {
  350:          $r->print('Sending critical: '.
  351:                 &user_crit_msg($content{'sendername'},
  352:                                  $content{'senderdomain'},
  353:                                  $ENV{'form.subject'},
  354:                                  $ENV{'form.message'}));
  355:       } else {
  356:          $r->print('Sending: '.&user_normal_msg($content{'sendername'},
  357:                                  $content{'senderdomain'},
  358:                                  $ENV{'form.subject'},
  359:                                  $ENV{'form.message'}));
  360:       }
  361:       if ($ENV{'form.displayedcrit'}) {
  362:           &discrit($r);
  363:       } else {
  364: 	  &disall($r);
  365:       }
  366:   } elsif ($ENV{'form.confirm'}) {
  367:       map {
  368:           if ($_=~/^form\.rec\_(.*)$/) {
  369: 	      $r->print('<b>Confirming Receipt:</b> '.
  370:                         &user_crit_received($1).'<br>');
  371:           }
  372:           if ($_=~/^form\.reprec\_(.*)$/) {
  373:               my $msgid=$1;
  374: 	      $r->print('<b>Confirming Receipt:</b> '.
  375:                         &user_crit_received($msgid).'<br>');
  376:               &comprep($r,$msgid);
  377:           }
  378:       } keys %ENV;
  379:       &discrit($r);
  380:   } elsif ($ENV{'form.critical'}) {
  381:       &discrit($r);
  382:   } elsif ($ENV{'form.forward'}) {
  383:   } elsif ($ENV{'form.markread'}) {
  384:   } elsif ($ENV{'form.markdel'}) {
  385:       &statuschange($ENV{'form.markdel'},'deleted');
  386:       &disall($r);
  387:   } elsif ($ENV{'form.markunread'}) {
  388:   } elsif ($ENV{'form.compose'}) {
  389:       my $dispcrit='';
  390:       if (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
  391:          $dispcrit=
  392: 	     '<input type=checkbox name=critmsg> Send as critical message<p>';
  393:       }
  394:       $r->print(<<"ENDCOMP");
  395: <form action="/adm/email" method=post>
  396: <input type=hidden name=sendmail value=on>
  397: Subject: <input type=text size=50 name=subject value=""><p>
  398: <textarea name=message cols=60 rows=10>
  399: </textarea><p>
  400: $dispcrit
  401: <input type=submit value="Send Mail">
  402: </form>
  403: ENDCOMP
  404:   } elsif ($ENV{'form.sendmail'}) {
  405:   } else {
  406:       &disall($r);
  407:   }
  408:   $r->print('</body></html>');
  409:   return OK;
  410: 
  411: }
  412: # ================================================= Main program, reset counter
  413: 
  414: sub BEGIN {
  415:     $msgcount=0;
  416: }
  417: 
  418: 1;
  419: __END__
  420: 
  421: 
  422: 
  423: 
  424: 
  425: 
  426: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>