Annotation of loncom/interface/lonmsg.pm, revision 1.14

1.1       www         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: #
1.6       www        13: # 10/19,10/20,10/30,
                     14: # 02/06/01 Gerd Kortemeyer
1.11      www        15: # 07/27 Guy Albertelli
1.12      www        16: # 07/27,07/28,07/30,08/03 Gerd Kortemeyer
1.1       www        17: 
                     18: package Apache::lonmsg;
                     19: 
                     20: use strict;
                     21: use Apache::lonnet();
1.2       www        22: use vars qw($msgcount);
                     23: use HTML::TokeParser;
1.5       www        24: use Apache::Constants qw(:common);
1.1       www        25: 
                     26: # ===================================================================== Package
                     27: 
1.3       www        28: sub packagemsg {
1.7       www        29:     my ($subject,$message,$citation)=@_;
1.1       www        30:     $message=~s/\</\&lt\;/g;
                     31:     $message=~s/\>/\&gt\;/g;
1.7       www        32:     $citation=~s/\</\&lt\;/g;
                     33:     $citation=~s/\>/\&gt\;/g;
1.1       www        34:     $subject=~s/\</\&lt\;/g;
                     35:     $subject=~s/\>/\&gt\;/g;
1.2       www        36:     my $now=time;
                     37:     $msgcount++;
1.6       www        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.':'.$$);
1.2       www        44:     return $msgid,
                     45:            '<sendername>'.$ENV{'user.name'}.'</sendername>'.
1.1       www        46:            '<senderdomain>'.$ENV{'user.domain'}.'</senderdomain>'.
                     47:            '<subject>'.$subject.'</subject>'.
1.2       www        48: 	   '<time>'.localtime($now).'</time>'.
1.1       www        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>'.
1.2       www        60:            '<msgid>'.$msgid.'</msgid>'.
1.7       www        61: 	   '<message>'.$message.'</message>'.
                     62: 	   '<citation>'.$citation.'</citation>';
1.1       www        63: }
                     64: 
1.2       www        65: # ================================================== Unpack message into a hash
                     66: 
1.3       www        67: sub unpackagemsg {
1.2       www        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: 
1.6       www        82: # ======================================================= Get info out of msgid
                     83: 
                     84: sub unpackmsgid {
1.7       www        85:     my $msgid=&Apache::lonnet::unescape(shift);
1.6       www        86:     my ($sendtime,$shortsubj,$fromname,$fromdomain)=split(/\:/,
1.7       www        87:                           &Apache::lonnet::unescape($msgid));
1.8       albertel   88:     my %status=&Apache::lonnet::get('email_status',[$msgid]);
1.6       www        89:     if ($status{$msgid}=~/^error\:/) { $status{$msgid}=''; }
                     90:     unless ($status{$msgid}) { $status{$msgid}='new'; }
                     91:     return ($sendtime,$shortsubj,$fromname,$fromdomain,$status{$msgid});
                     92: } 
                     93: 
1.1       www        94: # =============================== Automated message to the author of a resource
                     95: 
                     96: sub author_res_msg {
                     97:     my ($filename,$message)=@_;
1.2       www        98:     unless ($message) { return 'empty'; }
1.1       www        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);
1.2       www       104:        my $msgid;
1.3       www       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);
1.1       www       110:     }
1.2       www       111:     return 'no_host';
1.1       www       112: }
                    113: 
                    114: # ================================================== Critical message to a user
                    115: 
                    116: sub user_crit_msg {
                    117:     my ($user,$domain,$subject,$message)=@_;
1.2       www       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;
1.3       www       125:        ($msgid,$message)=&packagemsg($subject,$message);
1.4       www       126:        $status=&Apache::lonnet::critical(
                    127:            'put:'.$domain.':'.$user.':critical:'.
                    128:            &Apache::lonnet::escape($msgid).'='.
                    129:            &Apache::lonnet::escape($message),$homeserver);
1.2       www       130:     } else {
                    131:        $status='no_host';
                    132:     }
                    133:     &Apache::lonnet::logthis(
1.4       www       134:       'Sending critical email '.$msgid.
1.2       www       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: '
1.4       www       139:       .$status));
1.2       www       140:     return $status;
                    141: }
                    142: 
                    143: # =================================================== Critical message received
                    144: 
                    145: sub user_crit_received {
1.12      www       146:     my $msgid=shift;
                    147:     my %message=&Apache::lonnet::get('critical',[$msgid]);
                    148:     my %contents=&unpackagemsg($message{$msgid});
1.5       www       149:     my $status='rec: '.
                    150:      &user_normal_msg($contents{'sendername'},$contents{'senderdomain'},
1.4       www       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'});
1.5       www       156:     $status.=' trans: '.
1.12      www       157:      &Apache::lonnet::put(
                    158:      'nohist_email',{$contents{'msgid'} => $message{$msgid}});
1.5       www       159:     $status.=' del: '.
1.9       albertel  160:      &Apache::lonnet::del('critical',[$contents{'msgid'}]);
1.5       www       161:     &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
                    162:                          $ENV{'user.home'},'Received critical message '.
                    163:                          $contents{'msgid'}.
                    164:                          ', '.$status);
1.12      www       165:     return $status;
1.2       www       166: }
                    167: 
                    168: # ======================================================== Normal communication
                    169: 
                    170: sub user_normal_msg {
1.7       www       171:     my ($user,$domain,$subject,$message,$citation)=@_;
1.2       www       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;
1.7       www       179:        ($msgid,$message)=&packagemsg($subject,$message,$citation);
1.4       www       180:        $status=&Apache::lonnet::critical(
                    181:            'put:'.$domain.':'.$user.':nohist_email:'.
                    182:            &Apache::lonnet::escape($msgid).'='.
                    183:            &Apache::lonnet::escape($message),$homeserver);
1.2       www       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: 
1.7       www       193: # =============================================================== Status Change
                    194: 
                    195: sub statuschange {
                    196:     my ($msgid,$newstatus)=@_;
1.8       albertel  197:     my %status=&Apache::lonnet::get('email_status',[$msgid]);
1.7       www       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')) {
1.10      albertel  202: 	&Apache::lonnet::put('email_status',{$msgid => $newstatus});
1.7       www       203:     }
1.14    ! www       204:     if (($newstatus eq 'deleted') || ($newstatus eq 'new')) {
        !           205: 	&Apache::lonnet::put('email_status',{$msgid => $newstatus});
        !           206:     }
1.7       www       207: }
1.14    ! www       208: 
1.13      www       209: # ==================================================== Display Critical Message
1.5       www       210: 
1.12      www       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>'.
1.13      www       223:   '<input type=submit name="rec_'.$_.'" value="Confirm Receipt">'.
                    224:  '<input type=submit name="reprec_'.$_.'" value="Confirm Receipt and Reply">');
1.12      www       225:       } sort keys %what;
                    226:       $r->print('</form>');
                    227: }
                    228: 
1.13      www       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: 
1.14    ! www       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: 
1.13      www       290: # ===================================================================== Handler
                    291: 
1.5       www       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: 
1.6       www       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') || 
1.14    ! www       309:            ($name eq 'forward') || ($name eq 'markread') ||
        !           310:            ($name eq 'markdel') || ($name eq 'markunread') ||
1.12      www       311:            ($name eq 'sendreply') || ($name eq 'compose') ||
                    312:            ($name eq 'sendmail') || ($name eq 'critical')) {
1.6       www       313:            unless ($ENV{'form.'.$name}) {
                    314:               $ENV{'form.'.$name}=$value;
                    315: 	   }
                    316:        }
                    317:     } (split(/&/,$ENV{'QUERY_STRING'}));
                    318: 
1.5       www       319: # --------------------------------------------------------------- Render Output
                    320:   
                    321:   $r->print('<html><head><title>EMail and Messaging</title></head>');
1.7       www       322:   $r->print(
                    323:    '<body bgcolor="#FFFFFF"><img align=right src=/adm/lonIcons/lonlogos.gif>');
1.5       www       324:   $r->print('<h1>EMail</h1>');
1.6       www       325:   if ($ENV{'form.display'}) {
1.7       www       326:       my $msgid=$ENV{'form.display'};
                    327:       &statuschange($msgid,'read');
1.8       albertel  328:       my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
1.7       www       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'}.
1.14    ! www       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>'.
1.7       www       340:              $content{'message'}.'</pre><hr>'.$content{'citation'});
1.6       www       341:   } elsif ($ENV{'form.replyto'}) {
1.13      www       342:       &comprep($r,$ENV{'form.replyto'});
1.7       www       343:   } elsif ($ENV{'form.sendreply'}) {
                    344:       my $msgid=$ENV{'form.sendreply'};
1.8       albertel  345:       my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
1.7       www       346:       my %content=&unpackagemsg($message{$msgid});
                    347:       &statuschange($msgid,'replied');
1.12      www       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'},
1.7       www       352:                                  $content{'senderdomain'},
                    353:                                  $ENV{'form.subject'},
                    354:                                  $ENV{'form.message'}));
1.12      www       355:       } else {
                    356:          $r->print('Sending: '.&user_normal_msg($content{'sendername'},
                    357:                                  $content{'senderdomain'},
                    358:                                  $ENV{'form.subject'},
                    359:                                  $ENV{'form.message'}));
                    360:       }
1.14    ! www       361:       if ($ENV{'form.displayedcrit'}) {
        !           362:           &discrit($r);
        !           363:       } else {
        !           364: 	  &disall($r);
        !           365:       }
1.12      www       366:   } elsif ($ENV{'form.confirm'}) {
                    367:       map {
                    368:           if ($_=~/^form\.rec\_(.*)$/) {
                    369: 	      $r->print('<b>Confirming Receipt:</b> '.
                    370:                         &user_crit_received($1).'<br>');
1.13      www       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);
1.12      www       377:           }
                    378:       } keys %ENV;
                    379:       &discrit($r);
                    380:   } elsif ($ENV{'form.critical'}) {
                    381:       &discrit($r);
1.6       www       382:   } elsif ($ENV{'form.forward'}) {
1.14    ! www       383:   } elsif ($ENV{'form.markread'}) {
        !           384:   } elsif ($ENV{'form.markdel'}) {
        !           385:       &statuschange($ENV{'form.markdel'},'deleted');
        !           386:       &disall($r);
        !           387:   } elsif ($ENV{'form.markunread'}) {
1.11      www       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'}) {
1.6       www       405:   } else {
1.14    ! www       406:       &disall($r);
1.6       www       407:   }
1.5       www       408:   $r->print('</body></html>');
                    409:   return OK;
                    410: 
                    411: }
1.2       www       412: # ================================================= Main program, reset counter
                    413: 
                    414: sub BEGIN {
                    415:     $msgcount=0;
1.1       www       416: }
                    417: 
                    418: 1;
                    419: __END__
                    420: 
                    421: 
                    422: 
                    423: 
                    424: 
                    425: 
                    426: 

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