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

1.1       www         1: # The LearningOnline Network with CAPA
1.26      albertel    2: # Routines for messaging
                      3: #
1.118   ! www         4: # $Id: lonmsg.pm,v 1.117 2004/11/13 14:45:57 www Exp $
1.26      albertel    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/
1.1       www        27: #
1.75      www        28: 
                     29: 
1.1       www        30: package Apache::lonmsg;
                     31: 
1.58      bowersj2   32: =pod
                     33: 
                     34: =head1 NAME
                     35: 
                     36: Apache::lonmsg: supports internal messaging
                     37: 
                     38: =head1 SYNOPSIS
                     39: 
                     40: lonmsg provides routines for sending messages, receiving messages, and
                     41: a handler to allow users to read, send, and delete messages.
                     42: 
                     43: =head1 OVERVIEW
                     44: 
                     45: =head2 Messaging Overview
                     46: 
                     47: X<messages>LON-CAPA provides an internal messaging system similar to
                     48: email, but customized for LON-CAPA's usage. LON-CAPA implements its
                     49: own messaging system, rather then building on top of email, because of
                     50: the features LON-CAPA messages can offer that conventional e-mail can
                     51: not:
                     52: 
                     53: =over 4
                     54: 
                     55: =item * B<Critical messages>: A message the recipient B<must>
                     56: acknowlegde receipt of before they are allowed to continue using the
                     57: system, preventing a user from claiming they never got a message
                     58: 
                     59: =item * B<Receipts>: LON-CAPA can reliably send reciepts informing the
                     60: sender that it has been read; again, useful for preventing students
                     61: from claiming they did not see a message. (While conventional e-mail
                     62: has some reciept support, it's sporadic, e-mail client-specific, and
                     63: generally the receiver can opt to not send one, making it useless in
                     64: this case.)
                     65: 
                     66: =item * B<Context>: LON-CAPA knows about the sender, such as where
                     67: they are in a course. When a student mails an instructor asking for
                     68: help on the problem, the instructor receives not just the student's
                     69: question, but all submissions the student has made up to that point,
                     70: the user's rendering of the problem, and the complete view the student
                     71: saw of the resource, including discussion up to that point. Finally,
                     72: the instructor is reading all of this inside of LON-CAPA, not their
                     73: email program, so they have full access to LON-CAPA's grading
                     74: interface, or other features they may wish to use in response to the
                     75: student's query.
                     76: 
1.101     raeburn    77: =item * B<Blocking>: LON-CAPA can block display of e-mails that are 
                     78: sent to a student during an online exam. A course coordinator or
                     79: instructor can set an open and close date/time for scheduled online
                     80: exams in a course. If a user uses the LON-CAPA internal messaging 
                     81: system to display e-mails during the scheduled blocking event,  
                     82: display of all e-mail sent during the blocking period will be 
                     83: suppressed, and a message of explanation, including details of the 
                     84: currently active blocking periods will be displayed instead. A user 
                     85: who has a course coordinator or instructor role in a course will be
                     86: unaffected by any blocking periods for the course, unless the user
                     87: also has a student role in the course, AND has selected the student role.
                     88: 
1.58      bowersj2   89: =back
                     90: 
                     91: Users can ask LON-CAPA to forward messages to conventional e-mail
                     92: addresses on their B<PREF> screen, but generally, LON-CAPA messages
                     93: are much more useful then traditional email can be made to be, even
                     94: with HTML support.
                     95: 
                     96: Right now, this document will cover just how to send a message, since
                     97: it is likely you will not need to programmatically read messages,
                     98: since lonmsg already implements that functionality.
                     99: 
                    100: =head1 FUNCTIONS
                    101: 
                    102: =over 4
                    103: 
                    104: =cut
                    105: 
1.1       www       106: use strict;
                    107: use Apache::lonnet();
1.2       www       108: use vars qw($msgcount);
1.47      albertel  109: use HTML::TokeParser();
1.5       www       110: use Apache::Constants qw(:common);
1.47      albertel  111: use Apache::loncommon();
                    112: use Apache::lontexconvert();
                    113: use HTML::Entities();
1.53      www       114: use Mail::Send;
1.67      www       115: use Apache::lonlocal;
1.95      www       116: use Apache::loncommunicate;
1.1       www       117: 
1.65      www       118: # Querystring component with sorting type
                    119: my $sqs;
1.108     www       120: my $startdis;
                    121: my $interdis;
1.65      www       122: 
1.1       www       123: # ===================================================================== Package
                    124: 
1.3       www       125: sub packagemsg {
1.108     www       126:     my ($subject,$message,$citation,$baseurl,$attachmenturl,
                    127: 	$recuser,$recdomain)=@_;
1.96      albertel  128:     $message =&HTML::Entities::encode($message,'<>&"');
                    129:     $citation=&HTML::Entities::encode($citation,'<>&"');
                    130:     $subject =&HTML::Entities::encode($subject,'<>&"');
1.49      albertel  131:     #remove machine specification
                    132:     $baseurl =~ s|^http://[^/]+/|/|;
1.96      albertel  133:     $baseurl =&HTML::Entities::encode($baseurl,'<>&"');
1.51      www       134:     #remove machine specification
                    135:     $attachmenturl =~ s|^http://[^/]+/|/|;
1.96      albertel  136:     $attachmenturl =&HTML::Entities::encode($attachmenturl,'<>&"');
1.51      www       137: 
1.2       www       138:     my $now=time;
                    139:     $msgcount++;
1.6       www       140:     my $partsubj=$subject;
                    141:     $partsubj=&Apache::lonnet::escape($partsubj);
                    142:     my $msgid=&Apache::lonnet::escape(
                    143:            $now.':'.$partsubj.':'.$ENV{'user.name'}.':'.
                    144:            $ENV{'user.domain'}.':'.$msgcount.':'.$$);
1.49      albertel  145:     my $result='<sendername>'.$ENV{'user.name'}.'</sendername>'.
1.1       www       146:            '<senderdomain>'.$ENV{'user.domain'}.'</senderdomain>'.
                    147:            '<subject>'.$subject.'</subject>'.
1.67      www       148: 	   '<time>'.&Apache::lonlocal::locallocaltime($now).'</time>'.
1.1       www       149: 	   '<servername>'.$ENV{'SERVER_NAME'}.'</servername>'.
                    150:            '<host>'.$ENV{'HTTP_HOST'}.'</host>'.
                    151: 	   '<client>'.$ENV{'REMOTE_ADDR'}.'</client>'.
                    152: 	   '<browsertype>'.$ENV{'browser.type'}.'</browsertype>'.
                    153: 	   '<browseros>'.$ENV{'browser.os'}.'</browseros>'.
                    154: 	   '<browserversion>'.$ENV{'browser.version'}.'</browserversion>'.
                    155:            '<browsermathml>'.$ENV{'browser.mathml'}.'</browsermathml>'.
                    156: 	   '<browserraw>'.$ENV{'HTTP_USER_AGENT'}.'</browserraw>'.
                    157: 	   '<courseid>'.$ENV{'request.course.id'}.'</courseid>'.
1.85      www       158: 	   '<coursesec>'.$ENV{'request.course.sec'}.'</coursesec>'.
1.1       www       159: 	   '<role>'.$ENV{'request.role'}.'</role>'.
                    160: 	   '<resource>'.$ENV{'request.filename'}.'</resource>'.
1.2       www       161:            '<msgid>'.$msgid.'</msgid>'.
1.108     www       162: 	   '<recuser>'.$recuser.'</recuser>'.
                    163: 	   '<recdomain>'.$recdomain.'</recdomain>'.
1.49      albertel  164: 	   '<message>'.$message.'</message>';
                    165:     if (defined($citation)) {
                    166: 	$result.='<citation>'.$citation.'</citation>';
                    167:     }
                    168:     if (defined($baseurl)) {
                    169: 	$result.= '<baseurl>'.$baseurl.'</baseurl>';
                    170:     }
1.51      www       171:     if (defined($attachmenturl)) {
1.52      www       172: 	$result.= '<attachmenturl>'.$attachmenturl.'</attachmenturl>';
1.51      www       173:     }
1.49      albertel  174:     return $msgid,$result;
1.1       www       175: }
                    176: 
1.2       www       177: # ================================================== Unpack message into a hash
                    178: 
1.3       www       179: sub unpackagemsg {
1.52      www       180:     my ($message,$notoken)=@_;
1.2       www       181:     my %content=();
                    182:     my $parser=HTML::TokeParser->new(\$message);
                    183:     my $token;
                    184:     while ($token=$parser->get_token) {
                    185:        if ($token->[0] eq 'S') {
                    186: 	   my $entry=$token->[1];
                    187:            my $value=$parser->get_text('/'.$entry);
                    188:            $content{$entry}=$value;
                    189:        }
                    190:     }
1.52      www       191:     if ($content{'attachmenturl'}) {
1.100     albertel  192:        my ($fname)=($content{'attachmenturl'}=~m|/([^/]+)$|);
1.52      www       193:        if ($notoken) {
1.100     albertel  194: 	   $content{'message'}.='<p>'.&mt('Attachment').': <tt>'.$fname.'</tt>';
1.52      www       195:        } else {
1.99      albertel  196: 	   &Apache::lonnet::allowuploaded('/adm/msg',
                    197: 					  $content{'attachmenturl'});
                    198: 	   $content{'message'}.='<p>'.&mt('Attachment').
                    199: 	       ': <a href="'.$content{'attachmenturl'}.'"><tt>'.
1.100     albertel  200: 	       $fname.'</tt></a>';
1.52      www       201:        }
                    202:     }
1.2       www       203:     return %content;
                    204: }
                    205: 
1.6       www       206: # ======================================================= Get info out of msgid
                    207: 
                    208: sub unpackmsgid {
1.106     www       209:     my ($msgid,$folder)=@_;
                    210:     $msgid=&Apache::lonnet::unescape($msgid);
                    211:     my $suffix=&foldersuffix($folder);
1.6       www       212:     my ($sendtime,$shortsubj,$fromname,$fromdomain)=split(/\:/,
1.7       www       213:                           &Apache::lonnet::unescape($msgid));
1.106     www       214:     my %status=&Apache::lonnet::get('email_status'.$suffix,[$msgid]);
1.6       www       215:     if ($status{$msgid}=~/^error\:/) { $status{$msgid}=''; }
                    216:     unless ($status{$msgid}) { $status{$msgid}='new'; }
                    217:     return ($sendtime,$shortsubj,$fromname,$fromdomain,$status{$msgid});
                    218: } 
                    219: 
1.53      www       220: 
                    221: sub sendemail {
                    222:     my ($to,$subject,$body)=@_;
                    223:     $body=
1.67      www       224:     "*** ".&mt('This is an automatic message generated by the LON-CAPA system.')."\n".
                    225:     "*** ".&mt('Please do not reply to this address.')."\n\n".$body;
1.53      www       226:     my $msg = new Mail::Send;
                    227:     $msg->to($to);
                    228:     $msg->subject('[LON-CAPA] '.$subject);
1.103     albertel  229:     my %oldENV=%ENV;
                    230:     undef(%ENV);
1.97      matthew   231:     if (my $fh = $msg->open()) {
1.68      www       232: 	print $fh $body;
                    233: 	$fh->close;
                    234:     }
1.103     albertel  235:     %ENV=%oldENV;
                    236:     undef(%oldENV);
1.53      www       237: }
                    238: 
                    239: # ==================================================== Send notification emails
                    240: 
                    241: sub sendnotification {
                    242:     my ($to,$touname,$toudom,$subj,$crit)=@_;
                    243:     my $sender=$ENV{'environment.firstname'}.' '.$ENV{'environment.lastname'};
                    244:     my $critical=($crit?' critical':'');
                    245:     my $url='http://'.
                    246:       $Apache::lonnet::hostname{&Apache::lonnet::homeserver($touname,$toudom)}.
1.54      www       247:       '/adm/email?username='.$touname.'&domain='.$toudom;
1.53      www       248:     my $body=(<<ENDMSG);
                    249: You received a$critical message from $sender in LON-CAPA. The subject is
                    250: 
                    251:  $subj
                    252: 
                    253: Use
                    254: 
                    255:  $url
                    256: 
                    257: to access this message.
                    258: ENDMSG
                    259:     &sendemail($to,'New'.$critical.' message from '.$sender,$body);
                    260: }
1.40      www       261: # ============================================================= Check for email
                    262: 
                    263: sub newmail {
                    264:     if ((time-$ENV{'user.mailcheck.time'})>300) {
                    265:         my %what=&Apache::lonnet::get('email_status',['recnewemail']);
                    266:         &Apache::lonnet::appenv('user.mailcheck.time'=>time);
                    267:         if ($what{'recnewemail'}>0) { return 1; }
                    268:     }
                    269:     return 0;
                    270: }
                    271: 
1.1       www       272: # =============================== Automated message to the author of a resource
                    273: 
1.58      bowersj2  274: =pod
                    275: 
                    276: =item * B<author_res_msg($filename, $message)>: Sends message $message to the owner
                    277:     of the resource with the URI $filename.
                    278: 
                    279: =cut
                    280: 
1.1       www       281: sub author_res_msg {
                    282:     my ($filename,$message)=@_;
1.2       www       283:     unless ($message) { return 'empty'; }
1.1       www       284:     $filename=&Apache::lonnet::declutter($filename);
1.72      www       285:     my ($domain,$author,@dummy)=split(/\//,$filename);
1.1       www       286:     my $homeserver=&Apache::lonnet::homeserver($author,$domain);
                    287:     if ($homeserver ne 'no_host') {
                    288:        my $id=unpack("%32C*",$message);
1.2       www       289:        my $msgid;
1.72      www       290:        ($msgid,$message)=&packagemsg($filename,$message);
1.3       www       291:        return &Apache::lonnet::reply('put:'.$domain.':'.$author.
1.72      www       292:          ':nohist_res_msgs:'.
                    293:           &Apache::lonnet::escape($filename.'_'.$id).'='.
                    294:           &Apache::lonnet::escape($message),$homeserver);
1.1       www       295:     }
1.2       www       296:     return 'no_host';
1.73      www       297: }
                    298: 
                    299: # =========================================== Retrieve author resource messages
                    300: 
                    301: sub retrieve_author_res_msg {
1.75      www       302:     my $url=shift;
1.73      www       303:     $url=&Apache::lonnet::declutter($url);
1.80      www       304:     my ($domain,$author)=($url=~/^(\w+)\/(\w+)\//);
1.76      www       305:     my %errormsgs=&Apache::lonnet::dump('nohist_res_msgs',$domain,$author);
1.73      www       306:     my $msgs='';
                    307:     foreach (keys %errormsgs) {
1.80      www       308: 	if ($_=~/^\Q$url\E\_\d+$/) {
1.73      www       309: 	    my %content=&unpackagemsg($errormsgs{$_});
1.74      www       310: 	    $msgs.='<p><img src="/adm/lonMisc/bomb.gif" /><b>'.
                    311: 		$content{'time'}.'</b>: '.$content{'message'}.
                    312: 		'<br /></p>';
1.73      www       313: 	}
                    314:     } 
                    315:     return $msgs;     
                    316: }
                    317: 
                    318: 
                    319: # =============================== Delete all author messages related to one URL
                    320: 
                    321: sub del_url_author_res_msg {
1.75      www       322:     my $url=shift;
1.73      www       323:     $url=&Apache::lonnet::declutter($url);
1.77      www       324:     my ($domain,$author)=($url=~/^(\w+)\/(\w+)\//);
                    325:     my @delmsgs=();
                    326:     foreach (&Apache::lonnet::getkeys('nohist_res_msgs',$domain,$author)) {
                    327: 	if ($_=~/^\Q$url\E\_\d+$/) {
                    328: 	    push (@delmsgs,$_);
                    329: 	}
                    330:     }
                    331:     return &Apache::lonnet::del('nohist_res_msgs',\@delmsgs,$domain,$author);
1.73      www       332: }
                    333: 
                    334: # ================= Return hash with URLs for which there is a resource message
                    335: 
                    336: sub all_url_author_res_msg {
                    337:     my ($author,$domain)=@_;
1.75      www       338:     my %returnhash=();
1.76      www       339:     foreach (&Apache::lonnet::getkeys('nohist_res_msgs',$domain,$author)) {
1.75      www       340: 	$_=~/^(.+)\_\d+/;
                    341: 	$returnhash{$1}=1;
                    342:     }
                    343:     return %returnhash;
1.1       www       344: }
                    345: 
                    346: # ================================================== Critical message to a user
                    347: 
1.38      www       348: sub user_crit_msg_raw {
1.24      www       349:     my ($user,$domain,$subject,$message,$sendback)=@_;
1.2       www       350: # Check if allowed missing
                    351:     my $status='';
                    352:     my $msgid='undefined';
                    353:     unless (($message)&&($user)&&($domain)) { $status='empty'; };
                    354:     my $homeserver=&Apache::lonnet::homeserver($user,$domain);
                    355:     if ($homeserver ne 'no_host') {
1.3       www       356:        ($msgid,$message)=&packagemsg($subject,$message);
1.24      www       357:        if ($sendback) { $message.='<sendback>true</sendback>'; }
1.4       www       358:        $status=&Apache::lonnet::critical(
                    359:            'put:'.$domain.':'.$user.':critical:'.
                    360:            &Apache::lonnet::escape($msgid).'='.
                    361:            &Apache::lonnet::escape($message),$homeserver);
1.45      www       362:        if ($ENV{'request.course.id'}) {
                    363:           &user_normal_msg_raw(
                    364:             $ENV{'course.'.$ENV{'request.course.id'}.'.num'},
                    365:             $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
                    366:             'Critical ['.$user.':'.$domain.']',
                    367: 	    $message);
                    368:        }
1.2       www       369:     } else {
                    370:        $status='no_host';
                    371:     }
1.53      www       372: # Notifications
                    373:     my %userenv = &Apache::lonnet::get('environment',['critnotification'],
                    374:                                        $domain,$user);
                    375:     if ($userenv{'critnotification'}) {
                    376:       &sendnotification($userenv{'critnotification'},$user,$domain,$subject,1);
                    377:     }
                    378: # Log this
1.2       www       379:     &Apache::lonnet::logthis(
1.4       www       380:       'Sending critical email '.$msgid.
1.2       www       381:       ', log status: '.
                    382:       &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
                    383:                          $ENV{'user.home'},
                    384:       'Sending critical '.$msgid.' to '.$user.' at '.$domain.' with status: '
1.4       www       385:       .$status));
1.2       www       386:     return $status;
                    387: }
                    388: 
1.38      www       389: # New routine that respects "forward" and calls old routine
                    390: 
1.58      bowersj2  391: =pod
                    392: 
                    393: =item * B<user_crit_msg($user, $domain, $subject, $message, $sendback)>: Sends
                    394:     a critical message $message to the $user at $domain. If $sendback is true,
                    395:     a reciept will be sent to the current user when $user recieves the message.
                    396: 
                    397: =cut
                    398: 
1.38      www       399: sub user_crit_msg {
                    400:     my ($user,$domain,$subject,$message,$sendback)=@_;
                    401:     my $status='';
                    402:     my %userenv = &Apache::lonnet::get('environment',['msgforward'],
                    403:                                        $domain,$user);
                    404:     my $msgforward=$userenv{'msgforward'};
                    405:     if ($msgforward) {
                    406:        foreach (split(/\,/,$msgforward)) {
                    407: 	 my ($forwuser,$forwdomain)=split(/\:/,$_);
                    408:          $status.=
                    409: 	   &user_crit_msg_raw($forwuser,$forwdomain,$subject,$message,
                    410:                 $sendback).' ';
                    411:        }
                    412:     } else { 
                    413: 	$status=&user_crit_msg_raw($user,$domain,$subject,$message,$sendback);
                    414:     }
                    415:     return $status;
                    416: }
                    417: 
1.2       www       418: # =================================================== Critical message received
                    419: 
                    420: sub user_crit_received {
1.12      www       421:     my $msgid=shift;
                    422:     my %message=&Apache::lonnet::get('critical',[$msgid]);
1.52      www       423:     my %contents=&unpackagemsg($message{$msgid},1);
1.24      www       424:     my $status='rec: '.($contents{'sendback'}?
1.5       www       425:      &user_normal_msg($contents{'sendername'},$contents{'senderdomain'},
1.82      www       426:                      &mt('Receipt').': '.$ENV{'user.name'}.' '.&mt('at').' '.$ENV{'user.domain'}.', '.$contents{'subject'},
1.67      www       427:                      &mt('User').' '.$ENV{'user.name'}.' '.&mt('at').' '.$ENV{'user.domain'}.
1.42      www       428:                      ' acknowledged receipt of message'."\n".'   "'.
1.67      www       429:                      $contents{'subject'}.'"'."\n".&mt('dated').' '.
1.42      www       430:                      $contents{'time'}.".\n"
                    431:                      ):'no msg req');
1.5       www       432:     $status.=' trans: '.
1.12      www       433:      &Apache::lonnet::put(
                    434:      'nohist_email',{$contents{'msgid'} => $message{$msgid}});
1.5       www       435:     $status.=' del: '.
1.9       albertel  436:      &Apache::lonnet::del('critical',[$contents{'msgid'}]);
1.5       www       437:     &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
                    438:                          $ENV{'user.home'},'Received critical message '.
                    439:                          $contents{'msgid'}.
                    440:                          ', '.$status);
1.12      www       441:     return $status;
1.2       www       442: }
                    443: 
                    444: # ======================================================== Normal communication
                    445: 
1.38      www       446: sub user_normal_msg_raw {
1.51      www       447:     my ($user,$domain,$subject,$message,$citation,$baseurl,$attachmenturl)=@_;
1.2       www       448: # Check if allowed missing
                    449:     my $status='';
                    450:     my $msgid='undefined';
                    451:     unless (($message)&&($user)&&($domain)) { $status='empty'; };
                    452:     my $homeserver=&Apache::lonnet::homeserver($user,$domain);
                    453:     if ($homeserver ne 'no_host') {
1.51      www       454:        ($msgid,$message)=&packagemsg($subject,$message,$citation,$baseurl,
1.108     www       455:                                      $attachmenturl,$user,$domain);
                    456: # Store in user folder
1.4       www       457:        $status=&Apache::lonnet::critical(
                    458:            'put:'.$domain.':'.$user.':nohist_email:'.
                    459:            &Apache::lonnet::escape($msgid).'='.
                    460:            &Apache::lonnet::escape($message),$homeserver);
1.108     www       461: # Save new message received time
1.40      www       462:        &Apache::lonnet::put
                    463:                          ('email_status',{'recnewemail'=>time},$domain,$user);
1.108     www       464: # Into sent-mail folder
                    465:        $status.=' '.&Apache::lonnet::critical(
                    466:            'put:'.$ENV{'user.domain'}.':'.$ENV{'user.name'}.
                    467: 					      ':nohist_email_sent:'.
                    468:            &Apache::lonnet::escape($msgid).'='.
                    469:            &Apache::lonnet::escape($message),$ENV{'user.home'});
1.2       www       470:     } else {
                    471:        $status='no_host';
1.53      www       472:     }
                    473: # Notifications
                    474:     my %userenv = &Apache::lonnet::get('environment',['notification'],
                    475:                                        $domain,$user);
                    476:     if ($userenv{'notification'}) {
                    477: 	&sendnotification($userenv{'notification'},$user,$domain,$subject,0);
1.2       www       478:     }
                    479:     &Apache::lonnet::log($ENV{'user.domain'},$ENV{'user.name'},
                    480:                          $ENV{'user.home'},
                    481:       'Sending '.$msgid.' to '.$user.' at '.$domain.' with status: '.$status);
                    482:     return $status;
                    483: }
1.38      www       484: 
                    485: # New routine that respects "forward" and calls old routine
                    486: 
1.58      bowersj2  487: =pod
                    488: 
                    489: =item * B<user_normal_msg($user, $domain, $subject, $message,
                    490:     $citation, $baseurl, $attachmenturl)>: Sends a message to the
                    491:     $user at $domain, with subject $subject and message $message.
                    492: 
                    493: =cut
                    494: 
1.38      www       495: sub user_normal_msg {
1.52      www       496:     my ($user,$domain,$subject,$message,$citation,$baseurl,$attachmenturl)=@_;
1.38      www       497:     my $status='';
                    498:     my %userenv = &Apache::lonnet::get('environment',['msgforward'],
                    499:                                        $domain,$user);
                    500:     my $msgforward=$userenv{'msgforward'};
                    501:     if ($msgforward) {
                    502:        foreach (split(/\,/,$msgforward)) {
                    503: 	 my ($forwuser,$forwdomain)=split(/\:/,$_);
                    504:          $status.=
                    505: 	  &user_normal_msg_raw($forwuser,$forwdomain,$subject,$message,
1.52      www       506: 			       $citation,$baseurl,$attachmenturl).' ';
1.38      www       507:        }
                    508:     } else { 
1.49      albertel  509: 	$status=&user_normal_msg_raw($user,$domain,$subject,$message,
1.52      www       510: 				     $citation,$baseurl,$attachmenturl);
1.38      www       511:     }
                    512:     return $status;
                    513: }
                    514: 
1.2       www       515: 
1.106     www       516: # ============================================================ List all folders
                    517: 
                    518: sub folderlist {
                    519:     my $folder=shift;
                    520:     my @allfolders=&Apache::lonnet::getkeys('email_folders');
                    521:     if ($allfolders[0]=~/^error:/) { @allfolders=(); }
                    522:     return '<form method="post" action="/adm/email">'.
1.108     www       523: 	&mt('Folder').': '.
1.106     www       524: 	&Apache::loncommon::select_form($folder,'folder',
                    525: 			     ('' => &mt('INBOX'),'trash' => &mt('TRASH'),
1.114     www       526: 			      'new' => &mt('New Messages Only'),
1.113     www       527:                               'critical' => &mt('Critical'),
1.106     www       528: 			      'sent' => &mt('Sent Messages'),
                    529: 			      map { $_ => $_ } @allfolders)).
1.108     www       530: 			      ' '.&mt('Show').' '.
                    531: 	    &Apache::loncommon::select_form($interdis,'interdis',
                    532: (' 10' => '10', ' 20' => '20', ' 50' => '50', '100' => '100', '200' => '200')).	
                    533:    '<input type="submit" value="'.&mt('View Folder').'" /><br />'.
1.118   ! www       534: 			      ($folder=~/^(new|critical)/?'</form>':'');
        !           535: }
        !           536: 
        !           537: sub scrollbuttons {
        !           538:     my ($start,$maxdis,$first,$finish,$total)=@_;
        !           539:     $start++; $maxdis++;$first++;$finish++;
1.108     www       540:    '<input type="submit" name="firstview" value="'.&mt('First').'" />'.
                    541:    '<input type="submit" name="prevview" value="'.&mt('Previous').'" />'.
1.118   ! www       542:    '<input type="text" size="5" name="startdis" value="'.$start.'" onChange="this.form.submit()" /> of '.$maxdis.
1.108     www       543:    '<input type="submit" name="nextview" value="'.&mt('Next').'" />'.
1.118   ! www       544:    '<input type="submit" name="lastview" value="'.&mt('Last').'" /><br />'.
        !           545:    &mt('Messages [_1] through [_2] of [_3]',$first,$finish,$total).'</form>';
1.106     www       546: }
1.108     www       547: 
1.106     www       548: # =============================================================== Folder suffix
                    549: 
                    550: sub foldersuffix {
                    551:     my $folder=shift;
                    552:     unless ($folder) { return ''; }
                    553:     return '_'.&Apache::lonnet::escape($folder);
                    554: }
                    555: 
1.7       www       556: # =============================================================== Status Change
                    557: 
                    558: sub statuschange {
1.106     www       559:     my ($msgid,$newstatus,$folder)=@_;
                    560:     my $suffix=&foldersuffix($folder);
                    561:     my %status=&Apache::lonnet::get('email_status'.$suffix,[$msgid]);
1.7       www       562:     if ($status{$msgid}=~/^error\:/) { $status{$msgid}=''; }
                    563:     unless ($status{$msgid}) { $status{$msgid}='new'; }
                    564:     unless (($status{$msgid} eq 'replied') || 
                    565:             ($status{$msgid} eq 'forwarded')) {
1.106     www       566: 	&Apache::lonnet::put('email_status'.$suffix,{$msgid => $newstatus});
1.7       www       567:     }
1.14      www       568:     if (($newstatus eq 'deleted') || ($newstatus eq 'new')) {
1.106     www       569: 	&Apache::lonnet::put('email_status'.$suffix,{$msgid => $newstatus});
1.14      www       570:     }
1.7       www       571: }
1.14      www       572: 
1.106     www       573: # ============================================================= Make new folder
                    574: 
                    575: sub makefolder {
                    576:     my ($newfolder)=@_;
1.113     www       577:     if (($newfolder eq 'sent')
                    578:      || ($newfolder eq 'critical')
1.114     www       579:      || ($newfolder eq 'trash')
                    580:      || ($newfolder eq 'new')) { return; }
1.106     www       581:     &Apache::lonnet::put('email_folders',{$newfolder => time});
                    582: }
                    583: 
                    584: # ======================================================== Move between folders
                    585: 
                    586: sub movemsg {
                    587:     my ($msgid,$srcfolder,$trgfolder)=@_;
1.107     www       588:     my $unmsgid=&Apache::lonnet::unescape($msgid);
1.106     www       589:     my $srcsuffix=&foldersuffix($srcfolder);
                    590:     my $trgsuffix=&foldersuffix($trgfolder);
1.107     www       591: 
                    592: # Copy message
                    593:     my %message=&Apache::lonnet::get('nohist_email'.$srcsuffix,[$msgid]);
                    594:     &Apache::lonnet::put('nohist_email'.$trgsuffix,{$msgid => $message{$msgid}});
                    595: 
                    596: # Copy status
                    597:     my %status=&Apache::lonnet::get('email_status'.$srcsuffix,[$unmsgid]);
                    598:     &Apache::lonnet::put('email_status'.$trgsuffix,{$unmsgid => $status{$unmsgid}});
                    599: # See if was deleted -> becomes "read" in trash
1.108     www       600:     my $currentstatus=(&unpackmsgid($status{$unmsgid}),$srcfolder);
1.107     www       601:     if ($currentstatus eq 'deleted') {
                    602: 	&statuschange($msgid,'read',$trgfolder);
                    603:     }
                    604: # Delete orginals
1.106     www       605:     &Apache::lonnet::del('nohist_email'.$srcsuffix,[$msgid]);
1.107     www       606:     &Apache::lonnet::del('email_status'.$srcsuffix,[$unmsgid]);
1.106     www       607: }
                    608: 
1.17      www       609: # ======================================================= Display a course list
                    610: 
                    611: sub discourse {
                    612:     my $r=shift;
1.109     matthew   613:     my $classlist = &Apache::loncoursedata::get_classlist();
1.17      www       614:     my $now=time;
1.67      www       615:     my %lt=&Apache::lonlocal::texthash('cfa' => 'Check for All',
                    616:             'cfs' => 'Check for Section/Group',
                    617:             'cfn' => 'Check for None');
1.17      www       618:     $r->print(<<ENDDISHEADER);
1.92      www       619: <input type="hidden" name="sendmode" value="group" />
1.17      www       620: <script>
                    621:     function checkall() {
                    622: 	for (i=0; i<document.forms.compemail.elements.length; i++) {
                    623:             if 
                    624:           (document.forms.compemail.elements[i].name.indexOf('send_to_')==0) {
                    625: 	      document.forms.compemail.elements[i].checked=true;
                    626:             }
                    627:         }
                    628:     }
                    629: 
1.19      www       630:     function checksec() {
                    631: 	for (i=0; i<document.forms.compemail.elements.length; i++) {
                    632:             if 
                    633:           (document.forms.compemail.elements[i].name.indexOf
                    634:            ('send_to_&&&'+document.forms.compemail.chksec.value)==0) {
                    635: 	      document.forms.compemail.elements[i].checked=true;
                    636:             }
                    637:         }
                    638:     }
                    639: 
1.17      www       640:     function uncheckall() {
                    641: 	for (i=0; i<document.forms.compemail.elements.length; i++) {
                    642:             if 
                    643:           (document.forms.compemail.elements[i].name.indexOf('send_to_')==0) {
                    644: 	      document.forms.compemail.elements[i].checked=false;
                    645:             }
                    646:         }
                    647:     }
                    648: </script>
1.92      www       649: <input type="button" onClick="checkall()" value="$lt{'cfa'}" />&nbsp;
                    650: <input type="button" onClick="checksec()" value="$lt{'cfs'}" />
                    651: <input type="text" size="5" name=chksec />&nbsp;
                    652: <input type="button" onClick="uncheckall()" value="$lt{'cfn'}" />
1.17      www       653: <p>
                    654: ENDDISHEADER
1.109     matthew   655:     my %coursepersonnel=&Apache::lonnet::get_course_adv_roles();
                    656:     $r->print('<table>');
1.61      www       657:     foreach my $role (sort keys %coursepersonnel) {
1.109     matthew   658:         foreach (split(/\,/,$coursepersonnel{$role})) {
                    659:             my ($puname,$pudom)=split(/\:/,$_);
                    660:             $r->print('<tr><td><label>'.
                    661:                       '<input type="checkbox" name="send_to_&&&&&&_'.
                    662:                       $puname.':'.$pudom.'" /> '.
                    663:                       &Apache::loncommon::plainname($puname,$pudom).
                    664:                       '</label></td>'.
                    665:                       '<td>('.$_.'),</td><td><i>'.$role.'</i></td></tr>');
                    666:         }
1.61      www       667:     }
1.110     matthew   668:     $r->print('</table><table>');
1.109     matthew   669:     while (my ($student,$info) = each(%$classlist)) {
                    670:         my ($sname,$sdom,$status,$fullname,$section) =
                    671:             (@{$info}[&Apache::loncoursedata::CL_SNAME(),
                    672:                       &Apache::loncoursedata::CL_SDOM(),
                    673:                       &Apache::loncoursedata::CL_STATUS(),
                    674:                       &Apache::loncoursedata::CL_FULLNAME(),
                    675:                       &Apache::loncoursedata::CL_SECTION()]);
1.110     matthew   676:         next if ($status ne 'Active');
1.109     matthew   677:         my $key = 'send_to_&&&'.$section.'&&&'.$student;
                    678:         if (! defined($fullname) || $fullname eq '') { $fullname = $sname; }
                    679:         $r->print('<tr><td><label>'.
                    680:                   qq{<input type="checkbox" name="$key">}.('&nbsp;'x2).
                    681:                   $fullname.'</td><td>'.$sname.'@'.$sdom.'</td><td>'.$section.
                    682:                   '</td></tr>');
1.28      harris41  683:     }
1.110     matthew   684:     $r->print('</table>');
1.17      www       685: }
                    686: 
1.13      www       687: # ==================================================== Display Critical Message
1.5       www       688: 
1.12      www       689: sub discrit {
                    690:     my $r=shift;
1.67      www       691:     my $header = '<h1><font color=red>'.&mt('Critical Messages').'</font></h1>'.
1.30      matthew   692:         '<form action=/adm/email method=post>'.
                    693:         '<input type=hidden name=confirm value=true>';
                    694:     my %what=&Apache::lonnet::dump('critical');
                    695:     my $result = '';
                    696:     foreach (sort keys %what) {
                    697:         my %content=&unpackagemsg($what{$_});
                    698:         next if ($content{'senderdomain'} eq '');
                    699:         $content{'message'}=~s/\n/\<br\>/g;
1.106     www       700:         $result.='<hr />'.&mt('From').': <b>'.
1.37      www       701: &Apache::loncommon::aboutmewrapper(
                    702:  &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).'</b> ('.
                    703: $content{'sendername'}.'@'.
                    704:             $content{'senderdomain'}.') '.$content{'time'}.
1.106     www       705:             '<br />'.&mt('Subject').': '.$content{'subject'}.
                    706:             '<br /><blockquote>'.
1.36      www       707:               &Apache::lontexconvert::msgtexconverted($content{'message'}).
1.84      www       708:             '</blockquote><small>'.
                    709: &mt('You have to confirm that you received this message. After confirmation, this message will be moved to your regular inbox').
                    710:             '</small><br />'.
1.67      www       711:             '<input type=submit name="rec_'.$_.'" value="'.&mt('Confirm Receipt').'">'.
1.30      matthew   712:             '<input type=submit name="reprec_'.$_.'" '.
1.67      www       713:                   'value="'.&mt('Confirm Receipt and Reply').'">';
1.30      matthew   714:     }
                    715:     # Check to see if there were any messages.
                    716:     if ($result eq '') {
1.67      www       717:         $result = "<h2>".&mt('You have no critical messages.')."</h2>".
1.106     www       718: 	    '<a href="/adm/roles">'.&mt('Select a course').'</a><br />'.
                    719:             '<a href="/adm/email">'.&mt('Communicate').'</a>';
1.30      matthew   720:     } else {
                    721:         $r->print($header);
                    722:     }
                    723:     $r->print($result);
1.108     www       724:     $r->print('<input type="hidden" name="displayedcrit" value="true" /></form>');
1.12      www       725: }
                    726: 
1.65      www       727: sub sortedmessages {
1.106     www       728:     my ($blocked,$startblock,$endblock,$numblocked,$folder) = @_;
                    729:     my $suffix=&foldersuffix($folder);
                    730:     my @messages = &Apache::lonnet::getkeys('nohist_email'.$suffix);
1.65      www       731:     #unpack the varibles and repack into temp for sorting
                    732:     my @temp;
                    733:     foreach (@messages) {
                    734: 	my $msgid=&Apache::lonnet::escape($_);
                    735: 	my ($sendtime,$shortsubj,$fromname,$fromdomain,$status)=
1.108     www       736: 	    &Apache::lonmsg::unpackmsgid($msgid,$folder);
1.65      www       737: 	my @temp1 = ($sendtime,$shortsubj,$fromname,$fromdomain,$status,
                    738: 		     $msgid);
1.101     raeburn   739:         # Check whether message was sent during blocking period.
                    740:         if ($sendtime >= $startblock && ($sendtime <= $endblock && $endblock > 0) ) {
                    741:             my $escid = &Apache::lonnet::unescape($msgid);
                    742:             $$blocked{$escid} = 'ON';
                    743:             $$numblocked ++;
                    744:         } else { 
                    745:             push @temp ,\@temp1;
                    746:         }
1.65      www       747:     }
                    748:     #default sort
                    749:     @temp = sort  {$a->[0] <=> $b->[0]} @temp;    
                    750:     if ($ENV{'form.sortedby'} eq "date"){
                    751:         @temp = sort  {$a->[0] <=> $b->[0]} @temp;    
                    752:     }
                    753:     if ($ENV{'form.sortedby'} eq "revdate"){
                    754:     	@temp = sort  {$b->[0] <=> $a->[0]} @temp; 
                    755:     }
                    756:     if ($ENV{'form.sortedby'} eq "user"){
                    757: 	@temp = sort  {lc($a->[2]) cmp lc($b->[2])} @temp;
                    758:     }
                    759:     if ($ENV{'form.sortedby'} eq "revuser"){
                    760: 	@temp = sort  {lc($b->[2]) cmp lc($a->[2])} @temp;
                    761:     }
                    762:     if ($ENV{'form.sortedby'} eq "domain"){
                    763:         @temp = sort  {$a->[3] cmp $b->[3]} @temp;
                    764:     }
                    765:     if ($ENV{'form.sortedby'} eq "revdomain"){
                    766:         @temp = sort  {$b->[3] cmp $a->[3]} @temp;
                    767:     }
                    768:     if ($ENV{'form.sortedby'} eq "subject"){
                    769:         @temp = sort  {lc($a->[1]) cmp lc($b->[1])} @temp;
                    770:     }
                    771:     if ($ENV{'form.sortedby'} eq "revsubject"){
                    772:         @temp = sort  {lc($b->[1]) cmp lc($a->[1])} @temp;
                    773:     }
                    774:     if ($ENV{'form.sortedby'} eq "status"){
                    775:         @temp = sort  {$a->[4] cmp $b->[4]} @temp;
                    776:     }
                    777:     if ($ENV{'form.sortedby'} eq "revstatus"){
                    778:         @temp = sort  {$b->[4] cmp $a->[4]} @temp;
                    779:     }
                    780:     return @temp;
                    781: }
                    782: 
1.112     www       783: # ======================================================== Display new messages
                    784: 
                    785: 
                    786: sub disnew {
                    787:     my $r=shift;
                    788:     my %lt=&Apache::lonlocal::texthash(
                    789: 				       'nm' => 'New Messages',
                    790: 				       'su' => 'Subject',
                    791: 				       'da' => 'Date',
                    792: 				       'us' => 'Username',
                    793: 				       'op' => 'Open',
                    794: 				       'do' => 'Domain'
                    795: 				       );
                    796:     my @msgids = sort split(/\&/,&Apache::lonnet::reply
                    797:                             ('keys:'.$ENV{'user.domain'}.':'.
                    798:                              $ENV{'user.name'}.':nohist_email',
                    799:                              $ENV{'user.home'}));
                    800:     my @newmsgs;
                    801:     my %setters = ();
                    802:     my $startblock = 0;
                    803:     my $endblock = 0;
                    804:     my %blocked = ();
                    805:     my $numblocked = 0;
                    806:     # Check for blocking of display because of scheduled online exams.
                    807:     &blockcheck(\%setters,\$startblock,\$endblock);
                    808:     foreach (@msgids) {
                    809:         my ($sendtime,$shortsubj,$fromname,$fromdom,$status)=
                    810: 	    &Apache::lonmsg::unpackmsgid($_);
                    811:         if (defined($sendtime) && $sendtime!~/error/) {
                    812:             my $numsendtime = $sendtime;
                    813:             $sendtime = &Apache::lonlocal::locallocaltime($sendtime);
                    814:             if ($status eq 'new') {
                    815:                 if ($numsendtime >= $startblock && ($numsendtime <= $endblock && $endblock > 0) ) {
                    816:                     $blocked{$_} = 'ON';
                    817:                     $numblocked ++;
                    818:                 } else {
                    819:                     push @newmsgs, { 
                    820:                         msgid    => $_,
                    821:                         sendtime => $sendtime,
                    822:                         shortsub => &Apache::lonnet::unescape($shortsubj),
                    823:                         from     => $fromname,
                    824:                         fromdom  => $fromdom 
                    825:                         }
                    826:                 }
                    827:             }
                    828:         }
                    829:     }
                    830:     if ($#newmsgs >= 0) {
                    831:         $r->print(<<TABLEHEAD);
                    832: <h2>$lt{'nm'}</h2>
                    833: <table border=2><tr><th>&nbsp</th>
                    834: <th>$lt{'da'}</th><th>$lt{'us'}</th><th>$lt{'do'}</th><th>$lt{'su'}</th></tr>
                    835: TABLEHEAD
                    836:         foreach my $msg (@newmsgs) {
                    837:             $r->print(<<"ENDLINK");
                    838: <tr bgcolor="#FFBB77">
                    839: <td><a href="/adm/email?display=$msg->{'msgid'}">$lt{'op'}</a></td>
                    840: ENDLINK
                    841:             foreach ('sendtime','from','fromdom','shortsub') {
                    842:                 $r->print("<td>$msg->{$_}</td>");
                    843:             }
                    844:             $r->print("</td></tr>");
                    845:         }
                    846:         $r->print('</table></body></html>');
                    847:     } elsif ($numblocked == 0) {
                    848:         $r->print("<h3>".&mt('You have no unread messages')."</h3>");
                    849:     }
                    850:     if ($numblocked > 0) {
                    851:         my $beginblock = &Apache::lonlocal::locallocaltime($startblock);
                    852:         my $finishblock = &Apache::lonlocal::locallocaltime($endblock);
                    853:         if ($numblocked == 1) {
                    854:             $r->print("<h3>".&mt('You have').' '.$numblocked.' '.&mt('blocked unread message').".</h3>");
                    855:             $r->print(&mt('This message is not viewable because').' ');
                    856:         } else {
                    857:             $r->print("<h3>".&mt('You have').' '.$numblocked.' '.&mt('blocked unread messages').".</h3>");
                    858:             $r->print(&mt('These').' '.$numblocked.' '.&mt('messages are not viewable because '));
                    859:         }
                    860:         $r->print(
                    861: &mt('display of LON-CAPA messages sent to you by other students between').' '.$beginblock.' '.&mt('and').' '.$finishblock.' '.&mt('is currently being blocked because of online exams').'.');
                    862:         &build_block_table($r,$startblock,$endblock,\%setters);
                    863:     }
                    864: }
                    865: 
                    866: 
1.15      www       867: # ======================================================== Display all messages
                    868: 
1.14      www       869: sub disall {
1.106     www       870:     my ($r,$folder)=@_;
1.113     www       871:     $r->print(&folderlist($folder));
1.114     www       872:     if ($folder eq 'new') {
                    873: 	&disnew($r);
                    874:     } elsif ($folder eq 'critical') {
                    875: 	&discrit($r);
                    876:     } else {
                    877: 	&disfolder($r,$folder);
1.113     www       878:     }
1.114     www       879: }
                    880: 
                    881: # ============================================================ Display a folder
                    882: 
                    883: sub disfolder {
                    884:     my ($r,$folder)=@_;
1.101     raeburn   885:     my %blocked = ();
                    886:     my %setters = ();
                    887:     my $startblock;
                    888:     my $endblock;
                    889:     my $numblocked = 0;
                    890:     &blockcheck(\%setters,\$startblock,\$endblock);
                    891:     $r->print(<<ENDDISHEADER);
1.29      www       892: <script>
                    893:     function checkall() {
                    894: 	for (i=0; i<document.forms.disall.elements.length; i++) {
                    895:             if 
                    896:           (document.forms.disall.elements[i].name.indexOf('delmark_')==0) {
                    897: 	      document.forms.disall.elements[i].checked=true;
                    898:             }
                    899:         }
                    900:     }
                    901: 
                    902:     function uncheckall() {
                    903: 	for (i=0; i<document.forms.disall.elements.length; i++) {
                    904:             if 
                    905:           (document.forms.disall.elements[i].name.indexOf('delmark_')==0) {
                    906: 	      document.forms.disall.elements[i].checked=false;
                    907:             }
                    908:         }
                    909:     }
                    910: </script>
                    911: ENDDISHEADER
1.108     www       912:     my $fsqs='&folder='.$folder;
                    913:     my @temp=sortedmessages(\%blocked,$startblock,$endblock,\$numblocked,$folder);
                    914:     my $totalnumber=$#temp+1;
1.118   ! www       915:     my $number=int($totalnumber/$interdis);
        !           916:     if (($startdis<0) || ($startdis>$number)) { $startdis=$number; }
1.108     www       917:     my $firstdis=$interdis*$startdis;
                    918:     if ($firstdis>$#temp) { $firstdis=$#temp-$interdis+1; }
                    919:     my $lastdis=$firstdis+$interdis-1;
                    920:     if ($lastdis>$#temp) { $lastdis=$#temp; }
1.118   ! www       921:     $r->print(&scrollbuttons($startdis,$number,$firstdis,$lastdis,$totalnumber));
1.113     www       922:     $r->print('<form method="post" name="disall" action="/adm/email">'.
1.106     www       923: 	      '<table border=2><tr><th colspan="3">&nbsp</th><th>');
1.62      www       924:     if ($ENV{'form.sortedby'} eq "revdate") {
1.108     www       925: 	$r->print('<a href = "?sortedby=date'.$fsqs.'">'.&mt('Date').'</a></th>');
1.62      www       926:     } else {
1.108     www       927: 	$r->print('<a href = "?sortedby=revdate'.$fsqs.'">'.&mt('Date').'</a></th>');
1.62      www       928:     }
                    929:     $r->print('<th>');
                    930:     if ($ENV{'form.sortedby'} eq "revuser") {
1.108     www       931: 	$r->print('<a href = "?sortedby=user'.$fsqs.'">'.&mt('Username').'</a>');
1.62      www       932:     } else {
1.108     www       933: 	$r->print('<a href = "?sortedby=revuser'.$fsqs.'">'.&mt('Username').'</a>');
1.62      www       934:     }
                    935:     $r->print('</th><th>');
                    936:     if ($ENV{'form.sortedby'} eq "revdomain") {
1.108     www       937: 	$r->print('<a href = "?sortedby=domain'.$fsqs.'">'.&mt('Domain').'</a>');
1.62      www       938:     } else {
1.108     www       939: 	$r->print('<a href = "?sortedby=revdomain'.$fsqs.'">'.&mt('Domain').'</a>');
1.62      www       940:     }
                    941:     $r->print('</th><th>');
                    942:     if ($ENV{'form.sortedby'} eq "revsubject") {
1.108     www       943: 	$r->print('<a href = "?sortedby=subject'.$fsqs.'">'.&mt('Subject').'</a>');
1.62      www       944:     } else {
1.108     www       945:     	$r->print('<a href = "?sortedby=revsubject'.$fsqs.'">'.&mt('Subject').'</a>');
1.62      www       946:     }
                    947:     $r->print('</th><th>');
                    948:     if ($ENV{'form.sortedby'} eq "revstatus") {
1.108     www       949: 	$r->print('<a href = "?sortedby=status'.$fsqs.'">'.&mt('Status').'</th>');
1.62      www       950:     } else {
1.108     www       951:      	$r->print('<a href = "?sortedby=revstatus'.$fsqs.'">'.&mt('Status').'</th>');
1.62      www       952:     }
                    953:     $r->print('</tr>');
1.108     www       954:     for (my $n=$firstdis;$n<=$lastdis;$n++) {
                    955: 	my ($sendtime,$shortsubj,$fromname,$fromdomain,$status,$origID)= @{$temp[$n]};
1.63      albertel  956: 	if (($status ne 'deleted') && defined($sendtime) && $sendtime!~/error/) {
1.39      albertel  957: 	    if ($status eq 'new') {
                    958: 		$r->print('<tr bgcolor="#FFBB77">');
                    959: 	    } elsif ($status eq 'read') {
                    960: 		$r->print('<tr bgcolor="#BBBB77">');
                    961: 	    } elsif ($status eq 'replied') {
1.62      www       962: 		$r->print('<tr bgcolor="#AAAA88">'); 
1.39      albertel  963: 	    } else {
                    964: 		$r->print('<tr bgcolor="#99BBBB">');
                    965: 	    }
1.106     www       966: 	    $r->print('<td></a><input type=checkbox name="delmark_'.$origID.'" /></td><td><a href="/adm/email?display='.$origID.$sqs. 
                    967: 		      '">'.&mt('Open').'</a></td><td>'.
                    968: 		      ($folder ne 'trash'?'<a href="/adm/email?markdel='.$origID.$sqs.
                    969: 		      '">'.&mt('Delete'):'&nbsp').'</td>'.
1.66      www       970: 		      '<td>'.&Apache::lonlocal::locallocaltime($sendtime).'</td><td>'.
1.39      albertel  971: 		      $fromname.'</td><td>'.$fromdomain.'</td><td>'.
1.14      www       972: 		      &Apache::lonnet::unescape($shortsubj).'</td><td>'.
                    973:                       $status.'</td></tr>');
1.106     www       974: 	} elsif ($status eq 'deleted') {
                    975: # purge
1.108     www       976: 	    &movemsg(&Apache::lonnet::unescape($origID),$folder,'trash');
1.63      albertel  977: 	}
                    978:     }   
                    979:     $r->print('</table><p>'.
1.106     www       980:   '<a href="javascript:checkall()">'.&mt('Check All').'</a>&nbsp;'.
                    981:   '<a href="javascript:uncheckall()">'.&mt('Uncheck All').'</a></p>'.
                    982:   '<input type="hidden" name="sortedby" value="'.$ENV{'form.sortedby'}.'" />');
                    983:     if ($folder ne 'trash') {
                    984: 	$r->print(
                    985: 	      '<p><input type="submit" name="markeddel" value="'.&mt('Delete Checked').'" /></p>');
                    986:     }
1.118   ! www       987:     $r->print('<p><input type="submit" name="markedmove" value="'.&mt('Move Checked to Folder').'" />');
1.106     www       988:     my @allfolders=&Apache::lonnet::getkeys('email_folders');
                    989:     if ($allfolders[0]=~/^error:/) { @allfolders=(); }
                    990:     $r->print(
                    991: 	&Apache::loncommon::select_form('','movetofolder',
                    992: 			     ( map { $_ => $_ } @allfolders))
                    993: 	      );
                    994:     $r->print('<input type="hidden" name="folder" value="'.$folder.'" /></form>');
1.101     raeburn   995:     if ($numblocked > 0) {
                    996:         my $beginblock = &Apache::lonlocal::locallocaltime($startblock);
                    997:         my $finishblock = &Apache::lonlocal::locallocaltime($endblock);
                    998:         $r->print('<br /><br />'.
                    999:                   $numblocked.' '.&mt('message(s) is/are not viewable because display of LON-CAPA messages sent to you by other students between').' '.$beginblock.' '.&mt('and').' '.$finishblock.' '.&mt('is currently being blocked because of online exams.'));
                   1000:         &build_block_table($r,$startblock,$endblock,\%setters);
                   1001:     }
1.14      www      1002: }
                   1003: 
1.15      www      1004: # ============================================================== Compose output
                   1005: 
                   1006: sub compout {
1.108     www      1007:     my ($r,$forwarding,$replying,$broadcast,$replycrit,$folder)=@_;
1.92      www      1008: 
                   1009:     if ($broadcast eq 'individual') {
                   1010: 	&printheader($r,'/adm/email?compose=individual',
                   1011: 	     'Send a Message');
                   1012:     } elsif ($broadcast) {
                   1013: 	&printheader($r,'/adm/email?compose=group',
                   1014: 	     'Broadcast Message');
                   1015:     } elsif ($forwarding) {
                   1016: 	&Apache::lonhtmlcommon::add_breadcrumb
                   1017:         ({href=>"/adm/email?display=".&Apache::lonnet::escape($forwarding),
                   1018:           text=>"Display Message"});
                   1019: 	&printheader($r,'/adm/email?forward='.&Apache::lonnet::escape($forwarding),
                   1020: 	     'Forwarding a Message');
                   1021:     } elsif ($replying) {
                   1022: 	&Apache::lonhtmlcommon::add_breadcrumb
                   1023:         ({href=>"/adm/email?display=".&Apache::lonnet::escape($replying),
                   1024:           text=>"Display Message"});
                   1025: 	&printheader($r,'/adm/email?replyto='.&Apache::lonnet::escape($replying),
                   1026: 	     'Replying to a Message');
1.94      www      1027:     } elsif ($replycrit) {
                   1028: 	$r->print('<h3>'.&mt('Replying to a Critical Message').'</h3>');
                   1029: 	$replying=$replycrit;
1.92      www      1030:     } else {
                   1031: 	&printheader($r,'/adm/email?compose=upload',
                   1032: 	     'Distribute from Uploaded File');
                   1033:     }
                   1034: 
1.89      www      1035:     my $dispcrit='';
1.15      www      1036:     my $dissub='';
                   1037:     my $dismsg='';
1.115     www      1038:     my $disbase='';
1.67      www      1039:     my $func=&mt('Send New');
1.69      www      1040:     my %lt=&Apache::lonlocal::texthash('us' => 'Username',
                   1041: 				       'do' => 'Domain',
                   1042: 				       'ad' => 'Additional Recipients',
                   1043: 				       'sb' => 'Subject',
                   1044: 				       'ca' => 'Cancel',
                   1045: 				       'ma' => 'Mail');
                   1046: 
                   1047:     if (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
1.35      bowersj2 1048: 	 my $crithelp = Apache::loncommon::help_open_topic("Course_Critical_Message");
1.15      www      1049:          $dispcrit=
1.92      www      1050:  '<input type="checkbox" name="critmsg" /> '.&mt('Send as critical message').' ' . $crithelp . 
1.35      bowersj2 1051:  '<br>'.
1.92      www      1052:  '<input type="checkbox" name="sendbck" /> '.&mt('Send as critical message').'  ' .
1.67      www      1053:  &mt('and return receipt') . $crithelp . '<p>';
1.92      www      1054:      }
                   1055:     my %message;
                   1056:     my %content;
                   1057:     my $defdom=$ENV{'user.domain'};
1.15      www      1058:     if ($forwarding) {
1.92      www      1059: 	%message=&Apache::lonnet::get('nohist_email',[$forwarding]);
1.108     www      1060: 	%content=&unpackagemsg($message{$forwarding},$folder);
1.92      www      1061: 	$dispcrit.='<input type="hidden" name="forwid" value="'.
                   1062: 	    $forwarding.'" />';
                   1063: 	$func=&mt('Forward');
                   1064: 	
                   1065: 	$dissub=&mt('Forwarding').': '.$content{'subject'};
                   1066: 	$dismsg=&mt('Forwarded message from').' '.
                   1067: 	    $content{'sendername'}.' '.&mt('at').' '.$content{'senderdomain'};
1.115     www      1068: 	if ($content{'baseurl'}) {
                   1069: 	    $disbase='<input type="hidden" name="baseurl" value="'.&Apache::lonnet::escape($content{'baseurl'}).'" />';
                   1070: 	}
1.92      www      1071:     }
                   1072:     if ($replying) {
                   1073: 	%message=&Apache::lonnet::get('nohist_email',[$replying]);
1.108     www      1074: 	%content=&unpackagemsg($message{$replying},$folder);
1.105     albertel 1075: 	$dispcrit.='<input type="hidden" name="replyid" value="'.
                   1076: 	    $replying.'" />';
1.108     www      1077: 	$func=&mt('Send Reply to');
1.92      www      1078: 	
                   1079: 	$dissub=&mt('Reply').': '.$content{'subject'};       
                   1080: 	$dismsg='> '.$content{'message'};
                   1081: 	$dismsg=~s/\r/\n/g;
                   1082: 	$dismsg=~s/\f/\n/g;
                   1083: 	$dismsg=~s/\n+/\n\> /g;
1.115     www      1084: 	if ($content{'baseurl'}) {
                   1085: 	    $disbase='<input type="hidden" name="baseurl" value="'.&Apache::lonnet::escape($content{'baseurl'}).'" />';
                   1086: 	    if ($ENV{'user.adv'}) {
                   1087: 		$disbase='<input type="checkbox" name="storebasecomment" />'.&mt('Store message for re-use').'<br />';
                   1088: 	    }
                   1089: 	}
1.15      www      1090:     }
1.111     www      1091:     my $citation=&displayresource(%content);
1.37      www      1092:     if ($ENV{'form.recdom'}) { $defdom=$ENV{'form.recdom'}; }
1.22      www      1093:       $r->print(
1.31      matthew  1094:                 '<form action="/adm/email"  name="compemail" method="post"'.
                   1095:                 ' enctype="multipart/form-data">'."\n".
1.92      www      1096:                 '<input type="hidden" name="sendmail" value="on" />'."\n".
1.31      matthew  1097:                 '<table>');
1.22      www      1098:     unless (($broadcast eq 'group') || ($broadcast eq 'upload')) {
1.92      www      1099: 	if ($replying) {
                   1100: 	    $r->print('<tr><td colspan="2">'.&mt('Replying to').' '.
                   1101: 		      &Apache::loncommon::aboutmewrapper(
                   1102: 							 &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).' ('.
                   1103: 		      $content{'sendername'}.'@'.
                   1104: 		      $content{'senderdomain'}.')'.
                   1105: 		      '<input type="hidden" name="recuname" value="'.$content{'sendername'}.'" />'.
                   1106: 		      '<input type="hidden" name="recdomain" value="'.$content{'senderdomain'}.'" />'.
                   1107: 		      '</td></tr>');
                   1108: 	} else {
                   1109: 	    my $domform = &Apache::loncommon::select_dom_form($defdom,'recdomain');
                   1110: 	    my $selectlink=&Apache::loncommon::selectstudent_link
1.46      www      1111: 	    ('compemail','recuname','recdomain');
1.92      www      1112: 	    $r->print(<<"ENDREC");
1.69      www      1113: <tr><td>$lt{'us'}:</td><td><input type="text" size="12" name="recuname" value="$ENV{'form.recname'}"></td><td rowspan="2">$selectlink</td></tr>
                   1114: <tr><td>$lt{'do'}:</td>
1.31      matthew  1115: <td>$domform</td></tr>
1.17      www      1116: ENDREC
1.92      www      1117:         }
1.17      www      1118:     }
1.55      bowersj2 1119:     my $latexHelp = Apache::loncommon::helpLatexCheatsheet();
1.31      matthew  1120:     if ($broadcast ne 'upload') {
1.22      www      1121:        $r->print(<<"ENDCOMP");
1.69      www      1122: <tr><td>$lt{'ad'}<br /><tt>username\@domain,username\@domain, ...
1.20      www      1123: </tt></td><td>
1.91      www      1124: <input type="text" size="50" name="additionalrec" /></td></tr>
                   1125: <tr><td>$lt{'sb'}:</td><td><input type="text" size="50" name="subject" value="$dissub" />
1.15      www      1126: </td></tr></table>
1.55      bowersj2 1127: $latexHelp
1.92      www      1128: <textarea name="message" cols="80" rows="15" wrap="hard">$dismsg
1.69      www      1129: </textarea></p><br />
1.15      www      1130: $dispcrit
1.115     www      1131: $disbase
1.69      www      1132: <input type="submit" name="send" value="$func $lt{'ma'}" />
1.111     www      1133: <input type="submit" name="cancel" value="$lt{'ca'}" /><hr />
                   1134: $citation
1.15      www      1135: ENDCOMP
1.31      matthew  1136:     } else { # $broadcast is 'upload'
1.22      www      1137: 	$r->print(<<ENDUPLOAD);
1.91      www      1138: <input type="hidden" name="sendmode" value="upload" />
1.86      www      1139: <input type="hidden" name="send" value="on" />
1.22      www      1140: <h3>Generate messages from a file</h3>
1.31      matthew  1141: <p>
1.91      www      1142: Subject: <input type="text" size="50" name="subject" />
1.31      matthew  1143: </p>
                   1144: <p>General message text<br />
1.91      www      1145: <textarea name="message" cols="60" rows="10" wrap="hard">$dismsg
1.31      matthew  1146: </textarea></p>
                   1147: <p>
                   1148: The file format for the uploaded portion of the message is:
1.22      www      1149: <pre>
                   1150: username1\@domain1: text
                   1151: username2\@domain2: text
1.31      matthew  1152: username3\@domain1: text
1.22      www      1153: </pre>
1.31      matthew  1154: </p>
                   1155: <p>
1.22      www      1156: The messages will be assembled from all lines with the respective 
1.31      matthew  1157: <tt>username\@domain</tt>, and appended to the general message text.</p>
                   1158: <p>
1.91      www      1159: <input type="file" name="upfile" size="40" /></p><p>
1.22      www      1160: $dispcrit
1.92      www      1161: <input type="submit" value="Upload and Send" /></p>
1.22      www      1162: ENDUPLOAD
                   1163:     }
1.17      www      1164:     if ($broadcast eq 'group') {
                   1165:        &discourse;
                   1166:     }
                   1167:     $r->print('</form>');
1.15      www      1168: }
                   1169: 
1.45      www      1170: # ---------------------------------------------------- Display all face to face
                   1171: 
1.104     matthew  1172: sub retrieve_instructor_comments {
                   1173:     my ($user,$domain)=@_;
                   1174:     my $target=$ENV{'form.grade_target'};
                   1175:     if (! $ENV{'request.course.id'}) { return; }
                   1176:     if (! &Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
                   1177: 	return;
                   1178:     }
                   1179:     my %records=&Apache::lonnet::dump('nohist_email',
                   1180: 			 $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
                   1181: 			 $ENV{'course.'.$ENV{'request.course.id'}.'.num'},
                   1182:                          '%255b'.$user.'%253a'.$domain.'%255d');
                   1183:     my $result='';
                   1184:     foreach (sort(keys(%records))) {
                   1185:         my %content=&unpackagemsg($records{$_});
                   1186:         next if ($content{'senderdomain'} eq '');
                   1187:         next if ($content{'subject'} !~ /^Record/);
                   1188:         # $content{'message'}=~s/\n/\<br\>/g;
                   1189:         $result.='Recorded by '.
                   1190:             $content{'sendername'}.'@'.$content{'senderdomain'}."\n";
                   1191:         $result.=
                   1192:             &Apache::lontexconvert::msgtexconverted($content{'message'})."\n";
                   1193:      }
                   1194:     return $result;
                   1195: }
                   1196: 
1.45      www      1197: sub disfacetoface {
                   1198:     my ($r,$user,$domain)=@_;
1.98      sakharuk 1199:     my $target=$ENV{'form.grade_target'};
1.45      www      1200:     unless ($ENV{'request.course.id'}) { return; }
                   1201:     unless (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
                   1202: 	return;
                   1203:     }
                   1204:     my %records=&Apache::lonnet::dump('nohist_email',
                   1205: 			 $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
                   1206: 			 $ENV{'course.'.$ENV{'request.course.id'}.'.num'},
                   1207:                          '%255b'.$user.'%253a'.$domain.'%255d');
                   1208:     my $result='';
                   1209:     foreach (sort keys %records) {
                   1210:         my %content=&unpackagemsg($records{$_});
                   1211:         next if ($content{'senderdomain'} eq '');
                   1212:         $content{'message'}=~s/\n/\<br\>/g;
                   1213:         if ($content{'subject'}=~/^Record/) {
1.69      www      1214: 	    $result.='<h3>'.&mt('Record').'</h3>';
1.102     raeburn  1215:         } elsif ($content{'subject'}=~/^Broadcast/) {
                   1216:             $result .='<h3>'.&mt('Broadcast Message').'</h3>';
1.45      www      1217:         } else {
1.102     raeburn  1218:             $result.='<h3>'.&mt('Critical Message').'</h3>';
1.45      www      1219:             %content=&unpackagemsg($content{'message'});
                   1220:             $content{'message'}=
1.92      www      1221:                 '<b>'.&mt('Subject').': '.$content{'subject'}.'</b><br />'.
1.45      www      1222: 		$content{'message'};
                   1223:         }
1.69      www      1224:         $result.=&mt('By').': <b>'.
1.45      www      1225: &Apache::loncommon::aboutmewrapper(
                   1226:  &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).'</b> ('.
                   1227: $content{'sendername'}.'@'.
                   1228:             $content{'senderdomain'}.') '.$content{'time'}.
1.92      www      1229:             '<br /><blockquote>'.
1.45      www      1230:               &Apache::lontexconvert::msgtexconverted($content{'message'}).
                   1231: 	      '</blockquote>';
                   1232:      }
                   1233:     # Check to see if there were any messages.
                   1234:     if ($result eq '') {
1.98      sakharuk 1235: 	if ($target ne 'tex') { 
1.102     raeburn  1236: 	    $r->print("<p><b>".&mt("No notes, face-to-face discussion records, critical messages, or broadcast messages in this course.")."</b></p>");
1.98      sakharuk 1237: 	} else {
1.102     raeburn  1238: 	    $r->print('\textbf{'.&mt("No notes, face-to-face discussion records, critical messages or broadcast messages in this course.").'}\\\\');
1.98      sakharuk 1239: 	}
1.45      www      1240:     } else {
                   1241:        $r->print($result);
                   1242:     }
                   1243: }
                   1244: 
1.44      www      1245: # ---------------------------------------------------------------- Face to face
                   1246: 
                   1247: sub facetoface {
                   1248:     my ($r,$stage)=@_;
                   1249:     unless (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) {
                   1250: 	return;
                   1251:     }
1.89      www      1252:     &printheader($r,
                   1253: 		 '/adm/email?recordftf=query',
1.102     raeburn  1254: 		 "User Notes, Face-to-Face, Critical Messages, Broadcast Messages");
1.46      www      1255: # from query string
1.88      www      1256: 
1.46      www      1257:     if ($ENV{'form.recname'}) { $ENV{'form.recuname'}=$ENV{'form.recname'}; }
                   1258:     if ($ENV{'form.recdom'}) { $ENV{'form.recdomain'}=$ENV{'form.recdom'}; }
                   1259: 
1.44      www      1260:     my $defdom=$ENV{'user.domain'};
1.46      www      1261: # already filled in
1.44      www      1262:     if ($ENV{'form.recdomain'}) { $defdom=$ENV{'form.recdomain'}; }
1.46      www      1263: # generate output
1.44      www      1264:     my $domform = &Apache::loncommon::select_dom_form($defdom,'recdomain');
1.46      www      1265:     my $stdbrws = &Apache::loncommon::selectstudent_link
                   1266: 	('stdselect','recuname','recdomain');
1.88      www      1267:     my %lt=&Apache::lonlocal::texthash('user' => 'Username',
                   1268: 				       'dom' => 'Domain',
1.102     raeburn  1269: 				       'head' => 'User Notes, Records of Face-To-Face Discussions, Critical Messages, and Broadcast Messages in Course',
1.88      www      1270: 				       'subm' => 'Retrieve discussion and message records',
                   1271: 				       'newr' => 'New Record (record is visible to course faculty and staff)',
                   1272: 				       'post' => 'Post this Record');
1.44      www      1273:     $r->print(<<"ENDTREC");
1.88      www      1274: <h3>$lt{'head'}</h3>
1.46      www      1275: <form method="post" action="/adm/email" name="stdselect">
1.44      www      1276: <input type="hidden" name="recordftf" value="retrieve" />
                   1277: <table>
1.88      www      1278: <tr><td>$lt{'user'}:</td><td><input type="text" size="12" name="recuname" value="$ENV{'form.recuname'}" /></td>
1.44      www      1279: <td rowspan="2">
1.46      www      1280: $stdbrws
1.88      www      1281: <input type="submit" value="$lt{'subm'}" /></td>
1.44      www      1282: </tr>
1.88      www      1283: <tr><td>$lt{'dom'}:</td>
1.44      www      1284: <td>$domform</td></tr>
                   1285: </table>
                   1286: </form>
                   1287: ENDTREC
                   1288:     if (($stage ne 'query') &&
                   1289:         ($ENV{'form.recdomain'}) && ($ENV{'form.recuname'})) {
                   1290:         chomp($ENV{'form.newrecord'});
                   1291:         if ($ENV{'form.newrecord'}) {
1.45      www      1292:            &user_normal_msg_raw(
                   1293:             $ENV{'course.'.$ENV{'request.course.id'}.'.num'},
                   1294:             $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
1.88      www      1295:             &mt('Record').
                   1296: 	     ' ['.$ENV{'form.recuname'}.':'.$ENV{'form.recdomain'}.']',
1.45      www      1297: 	    $ENV{'form.newrecord'});
1.44      www      1298:         }
1.46      www      1299:         $r->print('<h3>'.&Apache::loncommon::plainname($ENV{'form.recuname'},
                   1300: 				     $ENV{'form.recdomain'}).'</h3>');
1.45      www      1301:         &disfacetoface($r,$ENV{'form.recuname'},$ENV{'form.recdomain'});
1.44      www      1302: 	$r->print(<<ENDRHEAD);
                   1303: <form method="post" action="/adm/email">
                   1304: <input name="recdomain" value="$ENV{'form.recdomain'}" type="hidden" />
                   1305: <input name="recuname" value="$ENV{'form.recuname'}" type="hidden" />
                   1306: ENDRHEAD
                   1307:         $r->print(<<ENDBFORM);
1.88      www      1308: <hr />$lt{'newr'}<br />
1.44      www      1309: <textarea name="newrecord" cols="80" rows="10" wrap="hard"></textarea>
1.45      www      1310: <br />
                   1311: <input type="hidden" name="recordftf" value="post" />
1.88      www      1312: <input type="submit" value="$lt{'post'}" />
1.44      www      1313: </form>
                   1314: ENDBFORM
                   1315:     }
                   1316: }
1.91      www      1317: 
1.101     raeburn  1318: # ----------------------------------------------------------- Blocking during exams
                   1319: 
                   1320: sub examblock {
                   1321:     my ($r,$action) = @_;
                   1322:     unless ($ENV{'request.course.id'}) { return;}
                   1323:     unless (&Apache::lonnet::allowed('srm',$ENV{'request.course.id'})) { $r->print('Not allowed'); }
                   1324:     my %lt=&Apache::lonlocal::texthash(
                   1325:             'comb' => 'Communication Blocking',
                   1326:             'cbds' => 'Communication blocking during scheduled exams',
                   1327:             'desc' => 'You can use communication blocking to prevent students enrolled in this course from displaying LON-CAPA messages sent by other students during an online exam. As blocking of communication could potentially interrupt legitimate communication between students who are also both enrolled in a different LON-CAPA course, please be careful that you select the correct start and end times for your scheduled exam when setting or modifying these parameters.',
                   1328:              'mecb' => 'Modify existing communication blocking periods',
                   1329:              'ncbc' => 'No communication blocks currently stored'
                   1330:     );
                   1331: 
                   1332:     my %ltext = &Apache::lonlocal::texthash(
                   1333:             'dura' => 'Duration',
                   1334:             'setb' => 'Set by',
                   1335:             'even' => 'Event',
                   1336:             'actn' => 'Action',
                   1337:             'star' => 'Start',
                   1338:             'endd' => 'End'
                   1339:     );
                   1340: 
                   1341:     &printheader($r,'/adm/email?block=display',$lt{'comb'});
                   1342:     $r->print('<h3>'.$lt{'cbds'}.'</h3>');
                   1343: 
                   1344:     if ($action eq 'store') {
                   1345:         &blockstore($r);
                   1346:     }
                   1347: 
                   1348:     $r->print($lt{'desc'}.'<br /><br />
                   1349:                <form name="blockform" method="post" action="/adm/email?block=store">
                   1350:              ');
                   1351: 
                   1352:     $r->print('<h4>'.$lt{'mecb'}.'</h4>');
                   1353:     my %records = ();
                   1354:     my $blockcount = 0;
                   1355:     my $parmcount = 0;
                   1356:     &get_blockdates(\%records,\$blockcount);
                   1357:     if ($blockcount > 0) {
                   1358:         $parmcount = &display_blocker_status($r,\%records,\%ltext);
                   1359:     } else {
                   1360:         $r->print($lt{'ncbc'}.'<br /><br />');
                   1361:     }
                   1362:     &display_addblocker_table($r,$parmcount,\%ltext);
                   1363:     $r->print(<<"END");
                   1364: <br />
                   1365: <input type="hidden" name="blocktotal" value="$blockcount" />
                   1366: <input type ="submit" value="Save Changes" />
                   1367: </form>
                   1368: </body>
                   1369: </html>
                   1370: END
                   1371:     return;
                   1372: }
                   1373: 
                   1374: sub blockstore {
                   1375:     my $r = shift;
                   1376:     my %lt=&Apache::lonlocal::texthash(
                   1377:             'tfcm' => 'The following changes were made',
                   1378:             'cbps' => 'communication blocking period(s)',
                   1379:             'werm' => 'was/were removed',
                   1380:             'wemo' => 'was/were modified',
                   1381:             'wead' => 'was/were added',
                   1382:             'ncwm' => 'No changes were made.' 
                   1383:     );
                   1384:     my %adds = ();
                   1385:     my %removals = ();
                   1386:     my %cancels = ();
                   1387:     my $modtotal = 0;
                   1388:     my $canceltotal = 0;
                   1389:     my $addtotal = 0;
                   1390:     my %blocking = ();
                   1391:     $r->print('<h3>'.$lt{'head'}.'</h3>');
                   1392:     foreach (keys %ENV) {
                   1393:         if ($_ =~ m/^form\.modify_(\w+)$/) {
                   1394:             $adds{$1} = $1;
                   1395:             $removals{$1} = $1;
                   1396:             $modtotal ++;
                   1397:         } elsif ($_ =~ m/^form\.cancel_(\d+)$/) {
                   1398:             $cancels{$1} = $1;
                   1399:             unless ( defined($removals{$1}) ) {
                   1400:                 $removals{$1} = $1;
                   1401:                 $canceltotal ++;
                   1402:             }
                   1403:         } elsif ($_ =~ m/^form\.add_(\d+)$/) {
                   1404:             $adds{$1} = $1;
                   1405:             $addtotal ++;
                   1406:         }
                   1407:     }
                   1408: 
                   1409:     foreach (keys %removals) {
                   1410:         my $hashkey = $ENV{'form.key_'.$_};
                   1411:         &Apache::lonnet::del('comm_block',["$hashkey"],
                   1412:                          $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
                   1413:                          $ENV{'course.'.$ENV{'request.course.id'}.'.num'}
                   1414:                          );
                   1415:     }
                   1416:     foreach (keys %adds) {
                   1417:         unless ( defined($cancels{$_}) ) {
                   1418:             my ($newstart,$newend) = &get_dates_from_form($_);
                   1419:             my $newkey = $newstart.'____'.$newend;
                   1420:             $blocking{$newkey} = $ENV{'user.name'}.'@'.$ENV{'user.domain'}.':'.$ENV{'form.title_'.$_};
                   1421:         }
                   1422:     }
                   1423:     if ($addtotal + $modtotal > 0) {
                   1424:         &Apache::lonnet::put('comm_block',\%blocking,
                   1425:                      $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
                   1426:                      $ENV{'course.'.$ENV{'request.course.id'}.'.num'}
                   1427:                      );
                   1428:     }
                   1429:     my $chgestotal = $canceltotal + $modtotal + $addtotal;
                   1430:     if ($chgestotal > 0) {
                   1431:         $r->print($lt{'tfcm'}.'<ul>');
                   1432:         if ($canceltotal > 0) {
                   1433:             $r->print('<li>'.$canceltotal.' '.$lt{'cbps'},' '.$lt{'werm'}.'</li>');
                   1434:         }
                   1435:         if ($modtotal > 0) {
                   1436:             $r->print('<li>'.$modtotal.' '.$lt{'cbps'},' '.$lt{'wemo'}.'</li>');
                   1437:         }
                   1438:         if ($addtotal > 0) {
                   1439:             $r->print('<li>'.$addtotal.' '.$lt{'cbps'},' '.$lt{'wead'}.'</li>');
                   1440:         }
                   1441:         $r->print('</ul>');
                   1442:     } else {
                   1443:         $r->print($lt{'ncwm'});
                   1444:     }
                   1445:     $r->print('<br />');
                   1446:     return;
                   1447: }
                   1448: 
                   1449: sub get_dates_from_form {
                   1450:     my $item = shift;
                   1451:     my $startdate = &Apache::lonhtmlcommon::get_date_from_form('startdate_'.$item);
                   1452:     my $enddate   = &Apache::lonhtmlcommon::get_date_from_form('enddate_'.$item);
                   1453:     return ($startdate,$enddate);
                   1454: }
                   1455: 
                   1456: sub get_blockdates {
                   1457:     my ($records,$blockcount) = @_;
                   1458:     $$blockcount = 0;
                   1459:     %{$records} = &Apache::lonnet::dump('comm_block',
                   1460:                          $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
                   1461:                          $ENV{'course.'.$ENV{'request.course.id'}.'.num'}
                   1462:                          );
                   1463:     $$blockcount = keys %{$records};
                   1464:                                                                                                              
                   1465:     foreach (keys %{$records}) {
                   1466:         if ($_ eq 'error: 2 tie(GDBM) Failed while attempting dump') {
                   1467:             $$blockcount = 0;
                   1468:             last;
                   1469:         }
                   1470:     }
                   1471: }
                   1472: 
                   1473: sub display_blocker_status {
                   1474:     my ($r,$records,$ltext) = @_;
                   1475:     my $parmcount = 0;
                   1476:     my @bgcols = ("#eeeeee","#dddddd");
                   1477:     my $function = &Apache::loncommon::get_users_function();
                   1478:     my $color = &Apache::loncommon::designparm($function.'.tabbg',
                   1479:                                                     $ENV{'user.domain'});
                   1480:     my %lt = &Apache::lonlocal::texthash(
                   1481:         'modi' => 'Modify',
                   1482:         'canc' => 'Cancel',
                   1483:     );
                   1484:     $r->print(<<"END");
                   1485: <table border="0" cellpadding="0" cellspacing="0">
                   1486:  <tr>
                   1487:   <td width="100%" bgcolor="#000000">
                   1488:    <table width="100%" border="0" cellpadding="1" cellspacing="0">
                   1489:     <tr>
                   1490:      <td width="100%" bgcolor="#000000">
                   1491:       <table border="0" cellpadding="3" cellspacing="3" bgcolor="#FFFFFF">
                   1492:        <tr bgcolor="$color">
                   1493:         <td><b>$$ltext{'dura'}</b></td>
                   1494:         <td><b>$$ltext{'setb'}</b></td>
                   1495:         <td><b>$$ltext{'even'}</b></td>
                   1496:         <td><b>$$ltext{'actn'}?</b></td>
                   1497:        </tr>
                   1498: END
                   1499:     foreach (sort keys %{$records}) {
                   1500:         my $iter = $parmcount%2;
                   1501:         my $onchange = 'onFocus="javascript:window.document.forms['.
                   1502:                        "'blockform'].elements['modify_".$parmcount."'].".
                   1503:                        'checked=true;"';
                   1504:         my ($start,$end) = split/____/,$_;
                   1505:         my $startform = &Apache::lonhtmlcommon::date_setter('blockform','startdate_'.$parmcount,$start,$onchange);
                   1506:         my $endform = &Apache::lonhtmlcommon::date_setter('blockform','enddate_'.$parmcount,$end,$onchange);
                   1507:         my ($setter,$title) = split/:/,$$records{$_};
                   1508:         my ($setuname,$setudom) = split/@/,$setter;
                   1509:         my $settername = &Apache::loncommon::plainname($setuname,$setudom);
                   1510:         $r->print(<<"END");
                   1511:        <tr bgcolor="$bgcols[$iter]">
                   1512:         <td>$$ltext{'star'}:&nbsp;$startform<br/>$$ltext{'endd'}:&nbsp;&nbsp;$endform</td>
                   1513:         <td>$settername</td>
                   1514:         <td><input type="text" name="title_$parmcount" size="15" value="$title"/><input type="hidden" name="key_$parmcount" value="$_"></td>
                   1515:         <td>$lt{'modi'}?&nbsp;<input type="checkbox" name="modify_$parmcount"/><br />$lt{'canc'}?&nbsp;&nbsp;<input type="checkbox" name="cancel_$parmcount"/>
                   1516:        </tr>
                   1517: END
                   1518:         $parmcount ++;
                   1519:     }
                   1520:     $r->print(<<"END");
                   1521:       </table>
                   1522:      </td>
                   1523:     </tr>
                   1524:    </table>
                   1525:   </td>
                   1526:  </tr>
                   1527: </table>
                   1528: <br />
                   1529: <br />
                   1530: END
                   1531:     return $parmcount;
                   1532: }
                   1533: 
                   1534: sub display_addblocker_table {
                   1535:     my ($r,$parmcount,$ltext) = @_;
                   1536:     my $start = time;
                   1537:     my $end = $start + (60 * 60 * 2); #Default is an exam of 2 hours duration.
                   1538:     my $onchange = 'onFocus="javascript:window.document.forms['.
                   1539:                    "'blockform'].elements['add_".$parmcount."'].".
                   1540:                    'checked=true;"';
                   1541:     my $startform = &Apache::lonhtmlcommon::date_setter('blockform','startdate_'.$parmcount,$start,$onchange);
                   1542:     my $endform = &Apache::lonhtmlcommon::date_setter('blockform','enddate_'.$parmcount,$end,$onchange);
                   1543:     my $function = &Apache::loncommon::get_users_function();
                   1544:     my $color = &Apache::loncommon::designparm($function.'.tabbg',
                   1545:                                                     $ENV{'user.domain'});
                   1546:     my %lt = &Apache::lonlocal::texthash(
                   1547:         'addb' => 'Add block',
                   1548:         'exam' => 'e.g., Exam 1',
                   1549:         'addn' => 'Add new communication blocking periods'
                   1550:     );
                   1551:     $r->print(<<"END");
                   1552: <h4>$lt{'addn'}</h4> 
                   1553: <table border="0" cellpadding="0" cellspacing="0">
                   1554:  <tr>
                   1555:   <td width="100%" bgcolor="#000000">
                   1556:    <table width="100%" border="0" cellpadding="1" cellspacing="0">
                   1557:     <tr>
                   1558:      <td width="100%" bgcolor="#000000">
                   1559:       <table border="0" cellpadding="3" cellspacing="3" bgcolor="#FFFFFF">
                   1560:        <tr bgcolor="#CCCCFF">
                   1561:         <td><b>$$ltext{'dura'}</b></td>
                   1562:         <td><b>$$ltext{'even'} $lt{'exam'}</b></td>
                   1563:         <td><b>$$ltext{'actn'}?</b></td>
                   1564:        </tr>
                   1565:        <tr bgcolor="#eeeeee">
                   1566:         <td>$$ltext{'star'}:&nbsp;$startform<br />$$ltext{'endd'}:&nbsp;&nbsp;$endform</td>
                   1567:         <td><input type="text" name="title_$parmcount" size="15" value=""/></td>
                   1568:         <td>$lt{'addb'}?&nbsp;<input type="checkbox" name="add_$parmcount" value="1"/></td>
                   1569:        </tr>
                   1570:       </table>
                   1571:      </td>
                   1572:     </tr>
                   1573:    </table>
                   1574:   </td>
                   1575:  </tr>
                   1576: </table>
                   1577: END
                   1578:     return;
                   1579: }
                   1580: 
                   1581: sub blockcheck {
                   1582:     my ($setters,$startblock,$endblock) = @_;
                   1583:     # Retrieve active student roles and active course coordinator/instructor roles
                   1584:     my @livecses = ();
                   1585:     my @staffcses = ();
                   1586:     $$startblock = 0;
                   1587:     $$endblock = 0;
                   1588:     foreach (keys %ENV) {
                   1589:         if ($_ =~ m-^user\.role\.(st|cc|in)\./(.+)$-) {
                   1590:             my $role = $1;
                   1591:             my $cse = $2;
                   1592:             $cse =~ s|/|_|;
                   1593:             if ($ENV{$_} =~ m/^(\d*)\.(\d*)$/) {
                   1594:                 unless (($2 > 0 && $2 < time) || ($1 > time)) {
                   1595:                     if ($role eq 'st') {
                   1596:                         push @livecses, $cse;
                   1597:                     } else {
                   1598:                         unless (grep/^$cse$/,@staffcses) {
                   1599:                             push @staffcses, $cse;
                   1600:                         }
                   1601:                     }
                   1602:                 }
                   1603:             }
                   1604:         } elsif ($_ =~ m-user\.role\.cr/(\w+)/(\w+)/([^/]+)\./(.+)$- ) { 
                   1605:             my $rolepriv = $ENV{'user.role..rolesdef_'.$3};
                   1606:         }
                   1607:     }
                   1608:     # Retrieve blocking times and identity of blocker for active courses for students.
                   1609:     if (@livecses > 0) {
                   1610:         foreach my $cse (@livecses) {
                   1611:             my ($cdom,$crs) = split/_/,$cse;
                   1612:             if ( (grep/^$cse$/,@staffcses) && ($ENV{'request.role'} !~ m-^st\./$cdom/$crs$-) ) {
                   1613:                 next;
                   1614:             } else {
                   1615:                 %{$$setters{$cse}} = ();
                   1616:                 @{$$setters{$cse}{'staff'}} = ();
                   1617:                 @{$$setters{$cse}{'times'}} = ();
                   1618:                 my %records = &Apache::lonnet::dump('comm_block',$cdom,$crs);
                   1619:                 foreach (keys %records) {
                   1620:                     if ($_ =~ m/^(\d+)____(\d+)$/) {
                   1621:                         if ($1 <= time && $2 >= time) {
                   1622:                             my ($staff,$title) = split/:/,$records{$_};
                   1623:                             push @{$$setters{$cse}{'staff'}}, $staff;
                   1624:                             push @{$$setters{$cse}{'times'}}, $_;
                   1625:                             if ( ($$startblock == 0) || ($$startblock > $1) ) {
                   1626:                                 $$startblock = $1;
                   1627:                             }
                   1628:                             if ( ($$endblock == 0) || ($$endblock < $2) ) {
                   1629:                                 $$endblock = $2;
                   1630:                             }
                   1631:                         }
                   1632:                     }
                   1633:                 }
                   1634:             }
                   1635:         }
                   1636:     }
                   1637: }
                   1638: 
                   1639: sub build_block_table {
                   1640:     my ($r,$startblock,$endblock,$setters) = @_;
                   1641:     my $function = &Apache::loncommon::get_users_function();
                   1642:     my $color = &Apache::loncommon::designparm($function.'.tabbg',
                   1643:                                                     $ENV{'user.domain'});
                   1644:     my %lt = &Apache::lonlocal::texthash(
                   1645:         'cacb' => 'Currently active communication blocks',
                   1646:         'cour' => 'Course',
                   1647:         'dura' => 'Duration',
                   1648:         'blse' => 'Block set by'
                   1649:     ); 
                   1650:     $r->print(<<"END");
                   1651: <br /<br />$lt{'cacb'}:<br /><br />
                   1652: <table border="0" cellpadding="0" cellspacing="0">
                   1653:  <tr>
                   1654:   <td width="100%" bgcolor="#000000">
                   1655:    <table width="100%" border="0" cellpadding="1" cellspacing="0">
                   1656:     <tr>
                   1657:      <td width="100%" bgcolor="#000000">
                   1658:       <table border="0" cellpadding="3" cellspacing="3" bgcolor="#FFFFFF">
                   1659:        <tr bgcolor="$color">
                   1660:         <td><b>$lt{'cour'}</b></td>
                   1661:         <td><b>$lt{'dura'}</b></td>
                   1662:         <td><b>$lt{'blse'}</b></td>
                   1663:        </tr>
                   1664: END
                   1665:     foreach (keys %{$setters}) {
                   1666:         my %courseinfo=&Apache::lonnet::coursedescription($_);
                   1667:         for (my $i=0; $i<@{$$setters{$_}{staff}}; $i++) {
                   1668:             my ($uname,$udom) = split/\@/,$$setters{$_}{staff}[$i];
                   1669:             my $fullname = &Apache::loncommon::plainname($uname,$udom);
                   1670:             my ($openblock,$closeblock) = split/____/,$$setters{$_}{times}[$i];
                   1671:             $openblock = &Apache::lonlocal::locallocaltime($openblock);
                   1672:             $closeblock= &Apache::lonlocal::locallocaltime($closeblock);
                   1673:             $r->print('<tr><td>'.$courseinfo{'description'}.'</td>'.
                   1674:                       '<td>'.$openblock.' to '.$closeblock.'</td>'.
                   1675:                       '<td>'.$fullname.' ('.$uname.'@'.$udom.
                   1676:                       ')</td></tr>');
                   1677:         }
                   1678:     }
                   1679:     $r->print('</table></td></tr></table></td></tr></table>');
                   1680: }
                   1681: 
1.90      www      1682: # ----------------------------------------------------------- Display a message
                   1683: 
                   1684: sub displaymessage {
1.106     www      1685:     my ($r,$msgid,$folder)=@_;
                   1686:     my $suffix=&foldersuffix($folder);
1.101     raeburn  1687:     my %blocked = ();
                   1688:     my %setters = ();
                   1689:     my $startblock = 0;
                   1690:     my $endblock = 0;
                   1691:     my $numblocked = 0;
                   1692: # info to generate "next" and "previous" buttons and check if message is blocked
                   1693:     &blockcheck(\%setters,\$startblock,\$endblock);
1.107     www      1694:     my @messages=&sortedmessages(\%blocked,$startblock,$endblock,\$numblocked,$folder);
1.101     raeburn  1695:     if ( $blocked{$msgid} eq 'ON' ) {
                   1696:         &printheader($r,'/adm/email',&mt('Display a Message'));
                   1697:         $r->print(&mt('You attempted to display a message that is currently blocked because you are enrolled in one or more courses for which there is an ongoing online exam.'));
                   1698:         &build_block_table($r,$startblock,$endblock,\%setters);
                   1699:         return;
                   1700:     }
1.107     www      1701:     &statuschange($msgid,'read',$folder);
1.106     www      1702:     my %message=&Apache::lonnet::get('nohist_email'.$suffix,[$msgid]);
1.90      www      1703:     my %content=&unpackagemsg($message{$msgid});
1.107     www      1704: 
1.90      www      1705:     my $counter=0;
                   1706:     $r->print('<pre>');
                   1707:     my $escmsgid=&Apache::lonnet::escape($msgid);
                   1708:     foreach (@messages) {
                   1709: 	if ($_->[5] eq $escmsgid){
                   1710: 	    last;
                   1711: 	}
                   1712: 	$counter++;
                   1713:     }
                   1714:     $r->print('</pre>');
                   1715:     my $number_of_messages = scalar(@messages); #subtract 1 for last index
                   1716: # start output
1.92      www      1717:     &printheader($r,'/adm/email?display='.&Apache::lonnet::escape($msgid),'Display a Message','',$content{'baseurl'});
1.90      www      1718:     my %courseinfo=&Apache::lonnet::coursedescription($content{'courseid'});
                   1719: # Functions
                   1720:     $r->print('<table border="2" width="100%"><tr bgcolor="#FFFFAA"><td>'.&mt('Functions').':</td>'.
                   1721: 	      '<td><a href="/adm/email?replyto='.&Apache::lonnet::escape($msgid).$sqs.
                   1722: 	      '"><b>'.&mt('Reply').'</b></a></td>'.
                   1723: 	      '<td><a href="/adm/email?forward='.&Apache::lonnet::escape($msgid).$sqs.
                   1724: 	      '"><b>'.&mt('Forward').'</b></a></td>'.
                   1725: 	      '<td><a href="/adm/email?markunread='.&Apache::lonnet::escape($msgid).$sqs.
                   1726: 	      '"><b>'.&mt('Mark Unread').'</b></a></td>'.
                   1727: 	      '<td><a href="/adm/email?markdel='.&Apache::lonnet::escape($msgid).$sqs.
                   1728: 	      '"><b>Delete</b></a></td>'.
                   1729: 	      '<td><a href="/adm/email?sortedby='.$ENV{'form.sortedby'}.
1.107     www      1730: 	      '&folder='.&Apache::lonnet::escape($folder).
1.90      www      1731: 	      '"><b>'.&mt('Display all Messages').'</b></a></td>');
                   1732:     if ($counter > 0){
                   1733: 	$r->print('<td><a href="/adm/email?display='.$messages[$counter-1]->[5].$sqs.
                   1734: 		  '"><b>'.&mt('Previous').'</b></a></td>');
                   1735:     }
                   1736:     if ($counter < $number_of_messages - 1){
                   1737: 	$r->print('<td><a href="/adm/email?display='.$messages[$counter+1]->[5].$sqs.
                   1738: 		  '"><b>'.&mt('Next').'</b></a></td>');
                   1739:     }
                   1740:     $r->print('</tr></table>');
                   1741:     $r->print('<br /><b>'.&mt('Subject').':</b> '.$content{'subject'}.
1.108     www      1742: 	      ($folder ne 'sent'?'<br /><b>'.&mt('From').':</b> '.
1.90      www      1743: 	      &Apache::loncommon::aboutmewrapper(
                   1744: 						 &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),
                   1745: 						 $content{'sendername'},$content{'senderdomain'}).' ('.
                   1746: 	      $content{'sendername'}.' at '.
1.108     www      1747: 	      $content{'senderdomain'}.') ':'<br /><b>'.&mt('To').':</b> '.
                   1748: 	      &Apache::loncommon::aboutmewrapper(
                   1749: 						 &Apache::loncommon::plainname($content{'recuser'},$content{'recdomain'}),
                   1750: 						 $content{'recuser'},$content{'recdomain'}).' ('.
                   1751: 	      $content{'recuser'}.' at '.
                   1752: 	      $content{'recdomain'}.') ').
1.90      www      1753: 	      ($content{'courseid'}?'<br /><b>'.&mt('Course').':</b> '.$courseinfo{'description'}.
                   1754: 	       ($content{'coursesec'}?' ('.&mt('Group/Section').': '.$content{'coursesec'}.')':''):'').
                   1755: 	      '<br /><b>'.&mt('Time').':</b> '.$content{'time'}.
1.115     www      1756: 	      ($content{'baseurl'}?'<br /><b>'.&mt('Refers to').':</b> <a href="'.$content{'baseurl'}.'">'.
                   1757: 	       $content{'baseurl'}.' ('.&Apache::lonnet::gettitle($content{'baseurl'}).')</a>':'').
1.90      www      1758: 	      '<p><pre>'.
                   1759: 	      &Apache::lontexconvert::msgtexconverted($content{'message'},1).
1.111     www      1760: 	      '</pre><hr />'.&displayresource(%content).'</p>');
1.90      www      1761:     return;   
                   1762: }
1.44      www      1763: 
1.111     www      1764: # =========================================================== Show the citation
                   1765: 
                   1766: sub displayresource {
                   1767:     my %content=@_;
                   1768: #
                   1769: # If the recipient is in the same course that the message was sent from and
                   1770: # has sufficient privileges, show "all details," else show citation
                   1771: #
                   1772:     if (($ENV{'request.course.id'} eq $content{'courseid'})
                   1773:      && (&Apache::lonnet::allowed('vgr',$content{'courseid'}))) {
                   1774: 	my $symb=&Apache::lonnet::symbread($content{'baseurl'});
                   1775: # Could not get a symb, give up
                   1776: 	unless ($symb) { return $content{'citation'}; }
                   1777: # Have a symb, can render
                   1778: 	return '<h2>'.&mt('Current attempts of student (if applicable)').'</h2>'.
                   1779: 	    &Apache::loncommon::get_previous_attempt($symb,
                   1780: 						     $content{'sendername'},
                   1781: 						     $content{'senderdomain'},
                   1782: 						     $content{'courseid'}).
                   1783: 	    '<hr /><h2>'.&mt('Current screen output (if applicable)').'</h2>'.
                   1784: 	    &Apache::loncommon::get_student_view($symb,
                   1785: 						 $content{'sendername'},
                   1786: 						 $content{'senderdomain'},
                   1787: 						 $content{'courseid'}).
                   1788: 	    '<h2>'.&mt('Correct Answer(s) (if applicable)').'</h2>'.
                   1789: 	    &Apache::loncommon::get_student_answers($symb,
                   1790: 						    $content{'sendername'},
                   1791: 						    $content{'senderdomain'},
                   1792: 						    $content{'courseid'});
                   1793:     } else {
                   1794: 	return $content{'citation'};
                   1795:     }
                   1796: }
                   1797: 
1.88      www      1798: # ================================================================== The Header
                   1799: 
                   1800: sub header {
1.90      www      1801:     my ($r,$title,$baseurl)=@_;
1.88      www      1802:     $r->print('<html><head><title>Communication and Messages</title>');
                   1803:     if ($baseurl) {
                   1804: 	$r->print("<base href=\"http://$ENV{'SERVER_NAME'}/$baseurl\" />");
                   1805:     }
                   1806:     $r->print(&Apache::loncommon::studentbrowser_javascript().'</head>'.
                   1807: 	      &Apache::loncommon::bodytag('Communication and Messages'));
                   1808:         $r->print(&Apache::lonhtmlcommon::breadcrumbs
1.90      www      1809:                   (undef,($title?$title:'Communication and Messages')));
1.88      www      1810: 
                   1811: }
                   1812: 
1.90      www      1813: # ---------------------------------------------------------------- Print header
                   1814: 
                   1815: sub printheader {
                   1816:     my ($r,$url,$desc,$title,$baseurl)=@_;
                   1817:     &Apache::lonhtmlcommon::add_breadcrumb
                   1818: 	({href=>$url,
                   1819: 	  text=>$desc});
                   1820:     &header($r,$title,$baseurl);
                   1821: }
                   1822: 
1.115     www      1823: # ---------------------------------------------------------------- Send an email
                   1824: 
                   1825: sub sendoffmail {
                   1826:     my ($r)=@_;
                   1827:     my $sendstatus='';
                   1828:     if ($ENV{'form.send'}) {
                   1829: 	&printheader($r,'','Messages being sent.');
                   1830: 	$r->rflush();
                   1831: 	my %content=();
                   1832: 	undef %content;
                   1833: 	if ($ENV{'form.forwid'}) {
                   1834: 	    my $msgid=$ENV{'form.forwid'};
                   1835: 	    my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
                   1836: 	    %content=&unpackagemsg($message{$msgid},1);
                   1837: 	    &statuschange($msgid,'forwarded');
                   1838: 	    $ENV{'form.message'}.="\n\n-- Forwarded message --\n\n".
                   1839: 		$content{'message'};
                   1840: 	}
                   1841: 	if ($ENV{'form.replyid'}) {
                   1842: 	    my $msgid=$ENV{'form.replyid'};
                   1843: 	    my %message=&Apache::lonnet::get('nohist_email',[$msgid]);
                   1844: 	    %content=&unpackagemsg($message{$msgid},1);
                   1845: 	    &statuschange($msgid,'replied');
                   1846: 	}
                   1847: 	my %toaddr=();
                   1848: 	undef %toaddr;
                   1849: 	if ($ENV{'form.sendmode'} eq 'group') {
                   1850: 	    foreach (keys %ENV) {
                   1851: 		if ($_=~/^form\.send\_to\_\&\&\&[^\&]*\&\&\&\_(.+)$/) {
                   1852: 		    $toaddr{$1}='';
                   1853: 		}
                   1854: 	    }
                   1855: 	} elsif ($ENV{'form.sendmode'} eq 'upload') {
                   1856: 	    foreach (split(/[\n\r\f]+/,$ENV{'form.upfile'})) {
                   1857: 		my ($rec,$txt)=split(/\s*\:\s*/,$_);
                   1858: 		if ($txt) {
                   1859: 		    $rec=~s/\@/\:/;
                   1860: 		    $toaddr{$rec}.=$txt."\n";
                   1861: 		}
                   1862: 	    }
                   1863: 	} else {
                   1864: 	    $toaddr{$ENV{'form.recuname'}.':'.$ENV{'form.recdomain'}}='';
                   1865: 	}
                   1866: 	if ($ENV{'form.additionalrec'}) {
                   1867: 	    foreach (split(/\,/,$ENV{'form.additionalrec'})) {
                   1868: 		my ($auname,$audom)=split(/\@/,$_);
                   1869: 		$toaddr{$auname.':'.$audom}='';
                   1870: 	    }
                   1871: 	}
                   1872: 	
                   1873: 	foreach (keys %toaddr) {
                   1874: 	    my ($recuname,$recdomain)=split(/\:/,$_);
                   1875: 	    my $msgtxt=&Apache::lonfeedback::clear_out_html($ENV{'form.message'});
                   1876: 	    if ($toaddr{$_}) { $msgtxt.='<hr />'.$toaddr{$_}; }
                   1877: 	    my $thismsg;    
                   1878: 	    if ((($ENV{'form.critmsg'}) || ($ENV{'form.sendbck'})) && 
                   1879: 		(&Apache::lonnet::allowed('srm',$ENV{'request.course.id'}))) {
                   1880: 		$r->print(&mt('Sending critical message').' '.$recuname.'@'.$recdomain.': ');
                   1881: 		$thismsg=&user_crit_msg($recuname,$recdomain,
                   1882: 					&Apache::lonfeedback::clear_out_html($ENV{'form.subject'}),
                   1883: 					$msgtxt,
                   1884: 					$ENV{'form.sendbck'});
                   1885: 	    } else {
                   1886: 		$r->print(&mt('Sending').' '.$recuname.'@'.$recdomain.': ');
                   1887: 		$thismsg=&user_normal_msg($recuname,$recdomain,
                   1888: 					  &Apache::lonfeedback::clear_out_html($ENV{'form.subject'}),
                   1889: 					  $msgtxt,
                   1890: 					  $content{'citation'});
                   1891: 		if (($ENV{'request.course.id'}) && ($ENV{'form.sendmode'} eq 'group')) {
                   1892: 		    &user_normal_msg_raw(
                   1893: 					 $ENV{'course.'.$ENV{'request.course.id'}.'.num'},
                   1894: 					 $ENV{'course.'.$ENV{'request.course.id'}.'.domain'},
                   1895: 					 'Broadcast ['.$recuname.':'.$recdomain.']',
                   1896: 					 $msgtxt);
                   1897: 		}
                   1898: 	    }
                   1899: 	    $r->print($thismsg.'<br />');
                   1900: 	    $sendstatus.=' '.$thismsg;
                   1901: 	}
                   1902:     } else {
                   1903: 	&printheader($r,'','No messages sent.'); 
                   1904:     }
                   1905:     if ($sendstatus=~/^(\s*(?:ok|con_delayed)\s*)*$/) {
                   1906: 	$r->print('<br /><font color="green">'.&mt('Completed.').'</font>');
                   1907: 	if ($ENV{'form.displayedcrit'}) {
                   1908: 	    &discrit($r);
                   1909: 	} else {
                   1910: 	    &Apache::loncommunicate::menu($r);
                   1911: 	}
                   1912:     } else {
                   1913: 	$r->print(
                   1914: 		  '<h2><font color="red">'.&mt('Could not deliver message').'</font></h2>'.
                   1915: 		  &mt('Please use the browser "Back" button and correct the recipient addresses')
                   1916: 		  );
                   1917:     }
                   1918: }
1.90      www      1919: 
1.13      www      1920: # ===================================================================== Handler
                   1921: 
1.5       www      1922: sub handler {
                   1923:     my $r=shift;
                   1924: 
                   1925: # ----------------------------------------------------------- Set document type
1.87      www      1926:     
                   1927:     &Apache::loncommon::content_type($r,'text/html');
                   1928:     $r->send_http_header;
                   1929:     
                   1930:     return OK if $r->header_only;
                   1931:     
1.6       www      1932: # --------------------------- Get query string for limited number of parameters
1.32      matthew  1933:     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
                   1934:         ['display','replyto','forward','markread','markdel','markunread',
1.44      www      1935:          'sendreply','compose','sendmail','critical','recname','recdom',
1.108     www      1936:          'recordftf','sortedby','block','folder','startdis','interdis']);
                   1937:     $sqs='&sortedby='.$ENV{'form.sortedby'}.
                   1938: 	 '&startdis='.$ENV{'form.startdis'}.
                   1939: 	 '&interdis='.$ENV{'form.interdis'};
                   1940: 
1.40      www      1941: # ------------------------------------------------------ They checked for email
1.101     raeburn  1942:     unless ($ENV{'form.block'}) {
                   1943:         &Apache::lonnet::put('email_status',{'recnewemail'=>0});
                   1944:     }
1.88      www      1945: 
                   1946: # ----------------------------------------------------------------- Breadcrumbs
                   1947: 
                   1948:     &Apache::lonhtmlcommon::clear_breadcrumbs();
                   1949:     &Apache::lonhtmlcommon::add_breadcrumb
                   1950:         ({href=>"/adm/communicate",
                   1951:           text=>"Communication/Messages",
                   1952:           faq=>12,bug=>'Communication Tools',});
                   1953: 
1.106     www      1954: # ------------------------------------------------------------------ Get Folder
                   1955: 
                   1956:     my $folder=$ENV{'form.folder'};
                   1957:     unless ($folder) { 
                   1958: 	$folder=''; 
                   1959:     } else {
                   1960: 	$sqs='&folder='.&Apache::lonnet::escape($folder);
                   1961:     }
                   1962: 
1.108     www      1963: # --------------------------------------------------------------------- Display
                   1964: 
                   1965:     $startdis=$ENV{'form.startdis'};
1.118   ! www      1966:     $startdis--;
1.108     www      1967:     unless ($startdis) { $startdis=0; }
                   1968:     $interdis=$ENV{'form.interdis'};
                   1969:     unless ($interdis) { $interdis=20; }
1.117     www      1970:     if ($ENV{'form.firstview'}) {
                   1971: 	$startdis=0;
                   1972:     }
                   1973:     if ($ENV{'form.lastview'}) {
                   1974: 	$startdis=-1;
                   1975:     }
                   1976:     if ($ENV{'form.prevview'}) {
                   1977: 	$startdis--;
                   1978:     }
                   1979:     if ($ENV{'form.nextview'}) {
                   1980: 	$startdis++;
                   1981:     }
                   1982: 
1.108     www      1983: 
1.5       www      1984: # --------------------------------------------------------------- Render Output
1.88      www      1985: 
1.87      www      1986:     if ($ENV{'form.display'}) {
1.106     www      1987: 	&displaymessage($r,$ENV{'form.display'},$folder);
1.87      www      1988:     } elsif ($ENV{'form.replyto'}) {
1.108     www      1989: 	&compout($r,'',$ENV{'form.replyto'},undef,undef,$folder);
1.87      www      1990:     } elsif ($ENV{'form.confirm'}) {
1.92      www      1991: 	&printheader($r,'','Confirmed Receipt');
1.87      www      1992: 	foreach (keys %ENV) {
                   1993: 	    if ($_=~/^form\.rec\_(.*)$/) {
1.92      www      1994: 		$r->print('<b>'.&mt('Confirming Receipt').':</b> '.
1.87      www      1995: 			  &user_crit_received($1).'<br>');
                   1996: 	    }
                   1997: 	    if ($_=~/^form\.reprec\_(.*)$/) {
                   1998: 		my $msgid=$1;
1.92      www      1999: 		$r->print('<b>'.&mt('Confirming Receipt').':</b> '.
1.87      www      2000: 			  &user_crit_received($msgid).'<br>');
1.94      www      2001: 		&compout($r,'','','',$msgid);
1.87      www      2002: 	    }
                   2003: 	}
                   2004: 	&discrit($r);
                   2005:     } elsif ($ENV{'form.critical'}) {
1.92      www      2006: 	&printheader($r,'','Displaying Critical Messages');
1.87      www      2007: 	&discrit($r);
                   2008:     } elsif ($ENV{'form.forward'}) {
                   2009: 	&compout($r,$ENV{'form.forward'});
                   2010:     } elsif ($ENV{'form.markdel'}) {
1.92      www      2011: 	&printheader($r,'','Deleted Message');
1.106     www      2012: 	&statuschange($ENV{'form.markdel'},'deleted',$folder);
                   2013: 	&disall($r,$folder);
                   2014:     } elsif ($ENV{'form.markedmove'}) {
                   2015: 	my $total=0;
                   2016: 	foreach (keys %ENV) {
                   2017: 	    if ($_=~/^form\.delmark_(.*)$/) {
                   2018: 		&movemsg(&Apache::lonnet::unescape($1),$folder,
                   2019: 			 $ENV{'form.movetofolder'});
                   2020: 		$total++;
                   2021: 	    }
                   2022: 	}
                   2023: 	&printheader($r,'','Moved Messages');
                   2024: 	$r->print('Moved '.$total.' message(s)<p>');
                   2025: 	&disall($r,$folder);
1.87      www      2026:     } elsif ($ENV{'form.markeddel'}) {
                   2027: 	my $total=0;
                   2028: 	foreach (keys %ENV) {
                   2029: 	    if ($_=~/^form\.delmark_(.*)$/) {
1.108     www      2030: 		&statuschange(&Apache::lonnet::unescape($1),'deleted',$folder);
1.87      www      2031: 		$total++;
                   2032: 	    }
                   2033: 	}
1.92      www      2034: 	&printheader($r,'','Deleted Messages');
1.87      www      2035: 	$r->print('Deleted '.$total.' message(s)<p>');
1.106     www      2036: 	&disall($r,$folder);
1.87      www      2037:     } elsif ($ENV{'form.markunread'}) {
1.92      www      2038: 	&printheader($r,'','Marked Message as Unread');
1.87      www      2039: 	&statuschange($ENV{'form.markunread'},'new');
1.106     www      2040: 	&disall($r,$folder);
1.87      www      2041:     } elsif ($ENV{'form.compose'}) {
1.92      www      2042: 	&compout($r,'','',$ENV{'form.compose'});
1.87      www      2043:     } elsif ($ENV{'form.recordftf'}) {
                   2044: 	&facetoface($r,$ENV{'form.recordftf'});
1.101     raeburn  2045:     } elsif ($ENV{'form.block'}) {
                   2046:         &examblock($r,$ENV{'form.block'});
1.87      www      2047:     } elsif ($ENV{'form.sendmail'}) {
1.116     albertel 2048: 	&sendoffmail($r);
1.106     www      2049:     } elsif ($ENV{'form.newfolder'}) {
                   2050: 	&printheader($r,'','New Folder');
                   2051: 	&makefolder($ENV{'form.newfolder'});
                   2052: 	&disall($r,$ENV{'form.newfolder'});
1.87      www      2053:     } else {
1.92      www      2054: 	&printheader($r,'','Display All Messages');
1.106     www      2055: 	&disall($r,$folder);
1.87      www      2056:     }
                   2057:     $r->print('</body></html>');
                   2058:     return OK;
1.5       www      2059: }
1.2       www      2060: # ================================================= Main program, reset counter
                   2061: 
1.27      www      2062: BEGIN {
1.2       www      2063:     $msgcount=0;
1.1       www      2064: }
1.58      bowersj2 2065: 
                   2066: =pod
                   2067: 
                   2068: =back
                   2069: 
1.59      bowersj2 2070: =cut
                   2071: 
                   2072: 1; 
1.1       www      2073: 
                   2074: __END__
                   2075: 
                   2076: 
                   2077: 
                   2078: 
                   2079: 
                   2080: 
                   2081: 

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