File:  [LON-CAPA] / loncom / interface / lonmsgdisplay.pm
Revision 1.70: download - view: text, annotated - select for diffs
Sun Apr 22 13:41:22 2007 UTC (17 years ago) by raeburn
Branches: MAIN
CVS tags: HEAD
- Bug 4551.  Users with dff privilege in a course can add a copy of a message to a User's Record (category Archive).
- Wording change for forwarding screen

    1: # The LearningOnline Network with CAPA
    2: # Routines for messaging display
    3: #
    4: # $Id: lonmsgdisplay.pm,v 1.70 2007/04/22 13:41:22 raeburn Exp $
    5: #
    6: # Copyright Michigan State University Board of Trustees
    7: #
    8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
    9: #
   10: # LON-CAPA is free software; you can redistribute it and/or modify
   11: # it under the terms of the GNU General Public License as published by
   12: # the Free Software Foundation; either version 2 of the License, or
   13: # (at your option) any later version.
   14: #
   15: # LON-CAPA is distributed in the hope that it will be useful,
   16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
   17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   18: # GNU General Public License for more details.
   19: #
   20: # You should have received a copy of the GNU General Public License
   21: # along with LON-CAPA; if not, write to the Free Software
   22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   23: #
   24: # /home/httpd/html/adm/gpl.txt
   25: #
   26: # http://www.lon-capa.org/
   27: #
   28: 
   29: 
   30: package Apache::lonmsgdisplay;
   31: 
   32: =pod
   33: 
   34: =head1 NAME
   35: 
   36: Apache::lonmsgdisplay: supports internal messaging
   37: 
   38: =head1 SYNOPSIS
   39: 
   40: lonmsgdisplay provides a handler to allow users to read, send, 
   41: and delete messages, and to create and delete message folders,
   42: and to move messages between folders.
   43: 
   44: =head1 OVERVIEW
   45: 
   46: =head2 Messaging Overview
   47: 
   48: X<messages>LON-CAPA provides an internal messaging system similar to
   49: email, but customized for LON-CAPA's usage. LON-CAPA implements its
   50: own messaging system, rather then building on top of email, because of
   51: the features LON-CAPA messages can offer that conventional e-mail can
   52: not:
   53: 
   54: =over 4
   55: 
   56: =item * B<Critical messages>: A message the recipient B<must>
   57: acknowlegde receipt of before they are allowed to continue using the
   58: system, preventing a user from claiming they never got a message
   59: 
   60: =item * B<Receipts>: LON-CAPA can reliably send reciepts informing the
   61: sender that it has been read; again, useful for preventing students
   62: from claiming they did not see a message. (While conventional e-mail
   63: has some reciept support, it's sporadic, e-mail client-specific, and
   64: generally the receiver can opt to not send one, making it useless in
   65: this case.)
   66: 
   67: =item * B<Context>: LON-CAPA knows about the sender, such as where
   68: they are in a course. When a student mails an instructor asking for
   69: help on the problem, the instructor receives not just the student's
   70: question, but all submissions the student has made up to that point,
   71: the user's rendering of the problem, and the complete view the student
   72: saw of the resource, including discussion up to that point. Finally,
   73: the instructor is reading all of this inside of LON-CAPA, not their
   74: email program, so they have full access to LON-CAPA's grading
   75: interface, or other features they may wish to use in response to the
   76: student's query.
   77: 
   78: =item * B<Blocking>: LON-CAPA can block selected communication 
   79: features for students during an online exam. A course coordinator or
   80: instructor can set an open and close date/time for scheduled online
   81: exams in a course. If a user uses the LON-CAPA internal messaging 
   82: system to display e-mails during the scheduled blocking event,  
   83: display of all e-mail sent during the blocking period will be 
   84: suppressed, and a message of explanation, including details of the 
   85: currently active blocking periods will be displayed instead. A user 
   86: who has a course coordinator or instructor role in a course will be
   87: unaffected by any blocking periods for the course, unless the user
   88: also has a student role in the course, AND has selected the student role.
   89: 
   90: =back
   91: 
   92: Users can ask LON-CAPA to forward messages to conventional e-mail
   93: addresses on their B<PREF> screen, but generally, LON-CAPA messages
   94: are much more useful than traditional email can be made to be, even
   95: with HTML support.
   96: 
   97: =cut
   98: 
   99: use strict;
  100: use Apache::lonnet;
  101: use HTML::TokeParser();
  102: use Apache::Constants qw(:common);
  103: use Apache::loncommon();
  104: use Apache::lonhtmlcommon();
  105: use Apache::lontexconvert();
  106: use HTML::Entities();
  107: use Apache::lonlocal;
  108: use Apache::loncommunicate;
  109: use Apache::lonfeedback;
  110: use Apache::lonrss();
  111: use Apache::lonselstudent();
  112: use lib '/home/httpd/lib/perl/';
  113: use LONCAPA;
  114: 
  115: # Querystring component with sorting type
  116: my $sqs;
  117: my $startdis;
  118: 
  119: # ============================================================ List all folders
  120: 
  121: sub folderlist {
  122:     my ($folder,$msgstatus) = @_;
  123:     my %lt = &Apache::lonlocal::texthash(
  124:                 actn => 'Action',
  125:                 fold => 'Folder',
  126:                 show => 'Show',
  127:                 status => 'Message Status',
  128:                 go   => 'Go',
  129:                 nnff => 'New Name for Folder',
  130:                 newn => 'New Name',
  131:                 thfm => 'The folder may not be renamed',
  132:                 fmnb => 'folder may not be renamed as it is a folder provided by the system.',
  133:                 asth => 'as this name is already in use for a system-provided or user-defined folder.',
  134:                 the => 'The',
  135:                 tnfm => 'The new folder may not be named',
  136: 
  137:     );
  138: 
  139:     my %actions = &Apache::lonlocal::texthash(
  140:                                 view => 'View Folder',
  141:                                 rename => 'Rename Folder',
  142:                                 delete => 'Delete Folder',
  143:     );
  144:     $actions{'select_form_order'} = ['view','rename','delete'];
  145: 
  146:     my %statushash = &get_msgstatus_types();
  147: 
  148:     $statushash{'select_form_order'} = ['','new','read','replied','forwarded'];
  149: 
  150:     my %permfolders = &get_permanent_folders();
  151:     my $permlist = join("','",sort(keys(%permfolders)));
  152:     my ($permlistkeys,$permlistvals);
  153:     foreach my $key (sort(keys(%permfolders))) {
  154:         $permlistvals .= $permfolders{$key}."','";
  155:         $permlistkeys .= $key."','";
  156:     }
  157:     $permlistvals =~ s/','$//;
  158:     $permlistkeys =~ s/','$//;
  159:     my %gotfolders = &Apache::lonmsg::get_user_folders();
  160:     my %userfolders;
  161: 
  162:     foreach my $key (keys(%gotfolders)) {
  163:         $key =~ s/(['"])/\$1/g; #' stupid emacs
  164:         $userfolders{$key} = $key;
  165:     }
  166:     my @userorder = sort(keys(%userfolders));
  167:     my %formhash = (%permfolders,%userfolders);
  168:     my $folderlist = join("','",@userorder);
  169:     $folderlist .= "','".$permlistvals;
  170: 
  171:     $formhash{'select_form_order'} = ['','critical',@userorder,'sent','trash'];
  172:     my $output = qq|<script type="text/javascript">
  173: function folder_choice(targetform,caller) {
  174:     var permfolders_keys = new Array('$permlistkeys');
  175:     var permfolders_vals = new Array('$permlistvals');
  176:     var allfolders = new Array('$folderlist');
  177:     if (caller == 'change') {
  178:         if (targetform.folderaction.options[targetform.folderaction.selectedIndex].value == 'rename') {
  179:             for (var i=0; i<permfolders_keys.length; i++) {
  180:                 if (permfolders_keys[i] == targetform.folder.value) {
  181:                     alert("$lt{'the'} '"+permfolders_vals[i]+"' $lt{'fmnb'}");
  182:                     return;
  183:                 }
  184:             }
  185:             var foldername=prompt('$lt{'nnff'}','$lt{'newn'}');
  186:             if (foldername) {
  187:                 targetform.renamed.value=foldername;
  188:                 for (var i=0; i<allfolders.length; i++) {
  189:                     if (allfolders[i] == foldername) {
  190:                         alert("$lt{'thfm'} '"+foldername+"' $lt{'asth'}");
  191:                         return;
  192:                     }
  193:                 }
  194:                 targetform.submit();
  195:             }
  196:         }
  197:         else {
  198:             targetform.submit();
  199:         }
  200:     }
  201:     if (caller == 'new') {
  202:         var newname=targetform.newfolder.value;
  203:         if (newname) {
  204:             for (var i=0; i<allfolders.length; i++) {
  205:                 if (allfolders[i] == newname) {
  206:                     alert("$lt{'tnfm'} '"+newname+"' $lt{'asth'}");
  207:                     return;
  208:                 }
  209:             }
  210:             targetform.submit();
  211:         }
  212:     }
  213: }
  214: </script>|;
  215:     my %show = ('select_form_order' => [10,20,50,100,200],
  216: 		map {$_=>$_} (10,20,50,100,200));
  217: 		
  218: 		   
  219:     $output .= '
  220: <form method="post" action="/adm/email" name="folderlist">
  221: <table border="0" cellspacing="2" cellpadding="2">
  222:  <tr>
  223:   <td align="left">
  224:    <table border="0" cellspacing="2" cellpadding="2">
  225:     <tr>
  226:      <td align="center"><b>'.$lt{'fold'}.'</b><br />'."\n".
  227:          &Apache::loncommon::select_form($folder,'folder',%formhash).'
  228:      </td>
  229:      <td align="center"><b>'.$lt{'show'}.'</b><br />'."\n".
  230:          &Apache::loncommon::select_form($env{'form.interdis'},'interdis',
  231: 					 %show).'
  232:      </td>
  233:      <td align="center"><b>'.$lt{'status'}.'</b><br />'."\n".
  234:        &Apache::loncommon::select_form($msgstatus,'msgstatus',%statushash).'
  235:      </td>
  236:      <td align="center"><b>'.$lt{'actn'}.'</b><br />'.
  237:          &Apache::loncommon::select_form('view','folderaction',%actions).'
  238:      </td><td><br />'.
  239:     '<input type="button" value="'.$lt{'go'}.'" onClick="javascript:folder_choice(this.form,'."'change'".');" />
  240:      </td>
  241:     </tr>
  242:    </table>
  243:   </td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td>
  244:   <td align="right">
  245:    <table><tr><td><br />
  246:     <input type="button" value="'.&mt('Make New Folder').
  247:     '" onClick="javascript:folder_choice(this.form,'."'new'".');" /></td>'.
  248:     '<td align="center"><b>'.&mt('New Folder').'</b><br />'.
  249:     '<input type="text" size="15" name="newfolder" value="" />
  250:     </td></tr></table>
  251:   </td>
  252:  </tr>
  253: </table>'."\n".
  254:     '<input type="hidden" name="sortedby" value="'.$env{'form.sortedby'}.'" />'.
  255:     '<input type="hidden" name="renamed" value="" />'.
  256:         ($folder=~/^critical/?'</form>':'');
  257:     return $output;
  258: }
  259: 
  260: sub get_permanent_folders {
  261:     my %permfolders = 
  262: 	&Apache::lonlocal::texthash(''         => 'INBOX',
  263: 				    'trash'    => 'TRASH',
  264: 				    'critical' => 'Critical',
  265: 				    'sent'     => 'Sent Messages',
  266: 				    );
  267:     return %permfolders;
  268: }
  269: 
  270: sub get_msgstatus_types {
  271:     my %statushash = &Apache::lonlocal::texthash(
  272:                                 '' => 'Any',
  273:                                 new => 'Unread',
  274:                                 read => 'Read',
  275:                                 replied => 'Replied to',
  276:                                 forwarded => 'Forwarded',
  277:     );
  278:     return %statushash;
  279: }
  280: 
  281: sub scrollbuttons {
  282:     my ($start,$maxdis,$first,$finish,$total,$msgstatus)=@_;
  283:     unless ($total>0) { return ''; }
  284:     $start++; $maxdis++;$first++;$finish++;
  285: 
  286:     my %statushash = &get_msgstatus_types();
  287:     my $status;
  288:     if ($msgstatus eq '') {
  289:         $status = &mt('All');
  290:     } else {
  291:         $status = $statushash{$msgstatus};
  292:     }
  293:     return
  294:    '<b>'.&mt('Page').'</b>: '. 
  295:    '<input type="submit" name="firstview" value="'.&mt('First').'" />'.
  296:    '<input type="submit" name="prevview" value="'.&mt('Previous').'" />'.
  297:    '<input type="text" size="5" name="startdis" value="'.$start.'" onChange="this.form.submit()" /> of '.$maxdis.
  298:    '<input type="submit" name="nextview" value="'.&mt('Next').'" />'.
  299:    '<input type="submit" name="lastview" value="'.&mt('Last').'" /><br />'.
  300:    &mt('<b>[_1] messages</b>: showing messages [_2] through [_3] of [_4].',$status,$first,$finish,$total).'</form>';
  301: }
  302: # =============================================================== Status Change
  303: 
  304: sub statuschange {
  305:     my ($msgid,$newstatus,$folder)=@_;
  306:     my $suffix=&Apache::lonmsg::foldersuffix($folder);
  307:     my %status=&Apache::lonnet::get('email_status'.$suffix,[$msgid]);
  308:     if ($status{$msgid}=~/^error\:/) { $status{$msgid}=''; }
  309:     unless ($status{$msgid}) { $status{$msgid}='new'; }
  310:     unless (($status{$msgid} eq 'replied') || 
  311:             ($status{$msgid} eq 'forwarded')) {
  312: 	&Apache::lonnet::put('email_status'.$suffix,{$msgid => $newstatus});
  313:     }
  314:     if (($newstatus eq 'deleted') || ($newstatus eq 'new')) {
  315: 	&Apache::lonnet::put('email_status'.$suffix,{$msgid => $newstatus});
  316:     }
  317:     if ($newstatus eq 'deleted') {
  318: 	return &movemsg($msgid,$folder,'trash');
  319:     }
  320:     return ;
  321: }
  322: 
  323: # ============================================================= Make new folder
  324: 
  325: sub makefolder {
  326:     my ($newfolder) = @_;
  327:     my %permfolders = &get_permanent_folders();
  328:     my %userfolders = &Apache::lonmsg::get_user_folders();
  329:     my ($outcome,$warning);
  330:     if (defined($userfolders{$newfolder})) {
  331:         return &mt('The folder name: "[_1]" is already in use for an existing folder.',$newfolder);
  332:     }
  333:     foreach my $perm (keys(%permfolders)) {
  334:         if ($permfolders{$perm} eq $newfolder) {
  335:             return &mt('The folder name: "[_1]" is already used for one of the folders automatically generated by the system.',$newfolder);
  336:         }
  337:     } 
  338:     if (&get_msgfolder_lock() eq 'ok') {
  339:         my %counter_hash = &Apache::lonnet::get('email_folders',["\0".'idcount']);
  340:         my $lastcount = $counter_hash{"\0".'idcount'};
  341:         my $folder_id = $lastcount + 1;
  342:         while (defined($userfolders{$folder_id})) {
  343:             $folder_id ++;
  344:         }
  345:         my %folderinfo = ( id      => $folder_id,
  346:                            created => time, );
  347:         $outcome =  
  348: 	    &Apache::lonnet::put('email_folders',{$newfolder => \%folderinfo,
  349: 						  "\0".'idcount' => $folder_id});
  350:         my $releaseresult = &release_msgfolder_lock();
  351:         if ($releaseresult ne 'ok') {
  352:             $warning = $releaseresult;
  353:         }
  354:     } else {
  355:         $outcome = 
  356: 	    &mt('Error - could not obtain lock on email folders record.');
  357:     }
  358:     return ($outcome,$warning);
  359: }
  360: 
  361: # ============================================================= Delete folder
  362: 
  363: sub deletefolder {
  364:     my ($folder)=@_;
  365:     my %permfolders = &get_permanent_folders();
  366:     if (defined($permfolders{$folder})) {
  367:         return &mt('The folder "[_1]" may not be deleted',$folder); 
  368:     }
  369:     my %userfolders = &Apache::lonmsg::get_user_folders();
  370:     if (!defined($userfolders{$folder})) {
  371:         return &mt('The folder "[_1]" does not exist so deletion is not required.',
  372:                    $folder);
  373:     }
  374:     # check folder is empty;
  375:     my $suffix=&Apache::lonmsg::foldersuffix($folder);
  376:     my @messages = &Apache::lonnet::getkeys('nohist_email'.$suffix);
  377:     if (@messages > 0) {
  378:         return &mt('The folder "[_1]" contains messages so it may not be deleted.',$folder).
  379:                '<br />'.
  380:                &mt('Delete or move the messages to a different folder first.');
  381:     }
  382:     my $delresult = &Apache::lonnet::del('email_folders',[$folder]);
  383:     return $delresult;
  384: }
  385: 
  386: sub renamefolder {
  387:     my ($folder) = @_;
  388:     my $newname = $env{'form.renamed'};
  389:     my %permfolders = &get_permanent_folders();
  390:     if ($env{'form.renamed'} eq '') {
  391:         return &mt('The folder "[_1]" may not be renamed to "[_2]" as the new name you requested is an invalid name.',$folder,$newname);
  392:     }
  393:     if (defined($permfolders{$newname})) {
  394:         return &mt('The folder "[_1]" may not be renamed to "[_2]" as the new name you requested is reserved for folders provided automatically by the system.',$folder,$newname);
  395:     }
  396:     my %userfolders = &Apache::lonmsg::get_user_folders();
  397:     if (defined($userfolders{$newname})) {
  398:         return &mt('The folder "[_1]" may not be renamed to "[_2]" because the new name you requested is already being used for an existing folder.',$folder,$newname);
  399:     }
  400:     if (!defined($userfolders{$folder})) {
  401:         return &mt('The folder "[_1]" could not be renamed to "[_2]" because the folder does not exist.',$folder,$newname);
  402:     }
  403:     my %folderinfo;
  404:     if (ref($userfolders{$folder}) eq 'HASH') {
  405:         %folderinfo = %{$userfolders{$folder}};
  406:     } else {
  407:         %folderinfo = ( id      => $folder,
  408:                         created => $userfolders{$folder},);
  409:     }
  410:     my $outcome =
  411:      &Apache::lonnet::put('email_folders',{$newname => \%folderinfo});
  412:     if ($outcome eq 'ok') {
  413:         $outcome = &Apache::lonnet::del('email_folders',[$folder]);
  414:     }
  415:     return $outcome;
  416: }
  417: 
  418: sub get_msgfolder_lock {
  419:     # get lock for mail folder counter.
  420:     my $lockhash = { "\0".'lock_counter' => time, };
  421:     my $tries = 0;
  422:     my $gotlock = &Apache::lonnet::newput('email_folders',$lockhash);
  423:     while (($gotlock ne 'ok') && $tries <3) {
  424:         $tries ++;
  425:         sleep(1);
  426:         $gotlock = &Apache::lonnet::newput('email_folders',$lockhash);
  427:     }
  428:     return $gotlock;
  429: }
  430: 
  431: sub release_msgfolder_lock {
  432:     #  remove lock
  433:     my @del_lock = ("\0".'lock_counter');
  434:     my $dellockoutcome=&Apache::lonnet::del('email_folders',\@del_lock);
  435:     if ($dellockoutcome ne 'ok') {
  436:         return ('<br />'.&mt('Warning: failed to release lock for counter').'<br />');
  437:     } else {
  438:         return 'ok';
  439:     }
  440: }
  441: 
  442: 
  443: # ======================================================== Move between folders
  444: 
  445: sub movemsg {
  446:     my ($msgid,$srcfolder,$trgfolder)=@_;
  447:     if ($srcfolder eq 'new') { $srcfolder=''; }
  448:     my $srcsuffix=&Apache::lonmsg::foldersuffix($srcfolder);
  449:     my $trgsuffix=&Apache::lonmsg::foldersuffix($trgfolder);
  450:     if ($srcsuffix eq $trgsuffix) {
  451: 	return (0,&mt('Message not moved, Attempted to move message to the same folder as it already is in.'));
  452:     }
  453: 
  454: # Copy message
  455:     my %message=&Apache::lonnet::get('nohist_email'.$srcsuffix,[$msgid]);
  456:     if (!exists($message{$msgid}) || $message{$msgid} eq '') {
  457: 	if (&Apache::lonnet::error(%message)) {
  458: 	    return (0,&mt('Message not moved, A network error occurred.'));
  459: 	} else {
  460: 	    return (0,&mt('Message not moved as the message is no longer in the source folder.'));
  461: 	}
  462:     }
  463: 
  464:     my $result =&Apache::lonnet::put('nohist_email'.$trgsuffix,
  465: 				     {$msgid => $message{$msgid}});
  466:     if (&Apache::lonnet::error($result)) {
  467: 	return (0,&mt('Message not moved, A network error occurred.'));
  468:     }
  469: 
  470: # Copy status
  471:     unless ($trgfolder eq 'trash') {
  472:        	my %status=&Apache::lonnet::get('email_status'.$srcsuffix,[$msgid]);
  473: 	# a non-existant status is the mark of an unread msg
  474: 	if (&Apache::lonnet::error(%status)) {
  475: 	    return (0,&mt('Message copied to new folder but status was not, A network error occurred.'));
  476: 	}
  477: 	my $result=&Apache::lonnet::put('email_status'.$trgsuffix,
  478: 					{$msgid => $status{$msgid}});
  479: 	if (&Apache::lonnet::error($result)) {
  480: 	    return (0,&mt('Message copied to new folder but status was not, A network error occurred.'));
  481: 	}
  482:     }
  483: 
  484: # Delete orginals
  485:     my $result_del_msg = 
  486: 	&Apache::lonnet::del('nohist_email'.$srcsuffix,[$msgid]);
  487:     my $result_del_stat =
  488: 	&Apache::lonnet::del('email_status'.$srcsuffix,[$msgid]);
  489:     if (&Apache::lonnet::error($result_del_msg)) {
  490: 	return (0,&mt('Message copied, but unable to delete the original from the source folder.'));
  491:     }
  492:     if (&Apache::lonnet::error($result_del_stat)) {
  493: 	return (0,&mt('Message copied, but unable to delete the original status from the source folder.'));
  494:     }
  495: 
  496:     return (1);
  497: }
  498: 
  499: # ======================================================= Display a course list
  500: 
  501: sub discourse {
  502:     my $result;
  503:     my ($course_personnel,
  504: 	$current_members,
  505: 	$expired_members,
  506: 	$future_members) = 
  507: 	    &Apache::lonselstudent::get_people_in_class($env{'request.course.sec'});
  508:     unshift @$current_members, (@$course_personnel);
  509:     my %defaultUsers;
  510:     
  511:     $result .= '<input type="hidden" name="sendmode" value="group" />'."\n";
  512: 
  513:     $result .= &Apache::lonselstudent::render_student_list($current_members,
  514: 							   "compemail",
  515: 							   "current",
  516: 							   \%defaultUsers,
  517: 							   1,"selectedusers",1);
  518: 
  519:     $result .= &Apache::lonselstudent::render_student_list($expired_members,
  520: 							   "compemail",
  521: 							   "expired",
  522: 							   \%defaultUsers,
  523: 							   1, "selectedusers",0);
  524:     $result .= &Apache::lonselstudent::render_student_list($future_members,
  525: 							   "compemail",
  526: 							   "future",
  527: 							   \%defaultUsers,
  528: 							   1, "selectedusers", 0);
  529:     return $result;
  530: }
  531: 
  532: sub disgroup {
  533:     my ($cdom,$cnum,$group,$viewgrps,$editgrps) = @_;
  534:     my $result;
  535:     #  Needs to be in a course
  536:     if (!($env{'request.course.fn'})) {
  537:         $result = &mt('Error: you must have a course role selected to be able to send a broadcast message to a group in the course.');
  538:         return $result;
  539:     }
  540:     if ($cdom eq '' || $cnum eq '') {
  541:         $result = &mt('Error: could not determine domain or number of course');
  542:         return $result;
  543:     }
  544:     my ($memberinfo,$numitems) =
  545:                  &Apache::longroup::group_memberlist($cdom,$cnum,$group,{},[]);
  546:     my @statustypes = ('active');
  547:     if ($viewgrps || $editgrps) {
  548:         push(@statustypes,('future','previous'));
  549:     }
  550:     if (keys(%{$memberinfo}) == 0) {
  551:         $result = &mt('As this group has no members, there are no '.
  552:                       'recipients to select.');
  553:         return $result;
  554:     } else {
  555:         $result = &mt('Select message recipients from the group members listed below.<br />');  
  556:         my %Sortby = (
  557:                          active   => {},
  558:                          previous => {},
  559:                          future   => {},
  560:                      );
  561:         my %lt = &Apache::lonlocal::texthash(
  562:                                      'name'     => 'Name',
  563:                                      'usnm'     => 'Username',
  564:                                      'doma'     => 'Domain',
  565:                                      'active'   => 'Active Members',
  566:                                      'previous' => 'Former Members',
  567:                                      'future'   => 'Future Members',
  568:                                     );
  569:         foreach my $user (sort(keys(%{$memberinfo}))) {
  570:             my $status = $$memberinfo{$user}{status};
  571:             if ($env{'form.'.$status.'.sortby'} eq 'fullname') {
  572:                 push(@{$Sortby{$status}{$$memberinfo{$user}{fullname}}},$user);
  573:             } elsif ($env{'form.'.$status.'.sortby'} eq 'username') {
  574:                 push(@{$Sortby{$status}{$$memberinfo{$user}{uname}}},$user);
  575:             } elsif ($env{'form.'.$status.'.sortby'} eq 'domain') {
  576:                 push(@{$Sortby{$status}{$$memberinfo{$user}{udom}}},$user);
  577:             } else {
  578:                 push(@{$Sortby{$status}{$$memberinfo{$user}{fullname}}},$user);
  579:             }
  580:         }
  581:         $result .= &group_check_uncheck();
  582:         $result .= '<table border="0" cellspacing="8" cellpadding="2">'.
  583:                    '<tr>';
  584:         foreach my $status (@statustypes)  {
  585:             if (ref($numitems) eq 'HASH') {
  586:                 if ((defined($$numitems{$status})) && ($$numitems{$status})) {
  587:                     $result.='<td valign="top">'.
  588:                              '<fieldset><legend><b>'.$lt{$status}.
  589:                              '</b></legend><nobr>'.
  590:                              '<input type="button" value="'.&mt('Check All').'" '.
  591:                              'onclick="javascript:toggleAll('."'".$status."','check'".')" />'.
  592:                              '&nbsp;&nbsp;'.
  593:                              '<input type="button" value="'.&mt('Uncheck All').'" '.
  594:                              'onclick="javascript:toggleAll('."'".$status."','uncheck'".')" />'.
  595:                              '</nobr></fieldset><br />'.
  596:                              &Apache::loncommon::start_data_table().
  597:                              &Apache::loncommon::start_data_table_header_row();
  598:                     $result .= "<th>$lt{'name'}</a></th>".
  599:                                "<th>$lt{'usnm'}</a></th>".
  600:                                "<th>$lt{'doma'}</a></th>".
  601:                     &Apache::loncommon::end_data_table_header_row();
  602:                     foreach my $key (sort(keys(%{$Sortby{$status}}))) {
  603:                         foreach my $user (@{$Sortby{$status}{$key}}) {
  604:                             $result .=
  605:                                 &Apache::loncommon::start_data_table_row().
  606:                                 '<td><input type="checkbox" '.
  607:                                 'name="selectedusers_forminput" value="'.
  608:                                 $user.':'.$status.'" />'.
  609:                                 $$memberinfo{$user}{'fullname'}.'</td>'.
  610:                                 '<td>'.$$memberinfo{$user}{'uname'}.'</td>'.
  611:                                 '<td>'.$$memberinfo{$user}{'udom'}.'</td>'.
  612:                                 &Apache::loncommon::end_data_table_row();
  613:                         }
  614:                     }
  615:                     $result .= &Apache::loncommon::end_data_table();
  616:                 }
  617:             }
  618:             $result .= '</td><td>&nbsp;&nbsp;</td>';
  619:         }
  620:         $result .= '</tr></table>';
  621:     }
  622:     return $result;
  623: }
  624: 
  625: sub group_check_uncheck {
  626:     my $output = qq|
  627: <script type="text/javascript">
  628: function toggleAll(caller,action) {
  629:     var pattern = new RegExp(":"+caller+"\$");
  630:     if (typeof(document.compemail.selectedusers_forminput.length)=="undefined") {
  631:         if (document.compemail.selectedusers_forminput.value.match(pattern)) {
  632:             if (action == 'check') {
  633:                 document.groupmail.selectedusers_forminput.checked = true;
  634:             } else {
  635:                 document.groupmail.selectedusers_forminput.checked = false;
  636:             }
  637:         }
  638:     } else {
  639:         for (var i=0; i<document.compemail.selectedusers_forminput.length; i++) {
  640:             if (document.compemail.selectedusers_forminput[i].value.match(pattern)) {
  641:                 if (action == 'check') {
  642:                     document.compemail.selectedusers_forminput[i].checked = true;
  643:                 } else {
  644:                     document.compemail.selectedusers_forminput[i].checked = false;
  645:                 }
  646:             }
  647:         }
  648:     }
  649: }
  650: </script>
  651:     |;
  652: }
  653: 
  654: sub groupmail_header {
  655:     my ($action,$group,$cdom,$cnum) = @_;
  656:     my ($description,$refarg);
  657:     if (!$cdom || !$cnum) {
  658:         $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
  659:         $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
  660:     }
  661:     if (exists($env{'form.ref'})) {
  662:         $refarg = 'ref='.$env{'form.ref'};
  663:     }
  664:     if (!$group) {
  665:         $group = $env{'form.group'};
  666:     }
  667:     if ($group eq '') {
  668:         return  '';
  669:     } else {
  670:         my %curr_groups = &Apache::longroup::coursegroups($cdom,$cnum,$group);
  671:         if (defined($curr_groups{$group})) {
  672:             my %groupinfo =
  673:                     &Apache::longroup::get_group_settings($curr_groups{$group});
  674:             $description = &unescape($groupinfo{'description'});
  675:         }
  676:     }
  677:     &Apache::lonhtmlcommon::clear_breadcrumbs();
  678:     if ($refarg) {
  679:         &Apache::lonhtmlcommon::add_breadcrumb
  680:             ({href=>"/adm/coursegroups",
  681:               text=>"Groups",
  682:               title=>"View course groups"});
  683:     }
  684:     &Apache::lonhtmlcommon::add_breadcrumb
  685:         ({href=>"/adm/$cdom/$cnum/$group/smppg?$refarg",
  686:           text=>"Group: $description",
  687:           title=>"Go to group's home page"},
  688:          {href=>"/adm/email?compose=group&amp;group=".
  689:                 "$env{'form.group'}&amp;$refarg",
  690:           text=>"Send a Message in a Group",
  691:           title=>"Compose Group Email Message"},);
  692:     if ($action eq 'sending') {
  693:             &Apache::lonhtmlcommon::add_breadcrumb
  694:                          ({text=>"Messages being sent.",
  695:                            title=>"Messages sent"},);
  696:     }
  697:     my $groupheader = &Apache::loncommon::start_page('Group Email');
  698:     $groupheader .= &Apache::lonhtmlcommon::breadcrumbs
  699:                 ('Group - '.$env{'form.group'}.' Email');
  700:     return $groupheader;
  701: }
  702: 
  703: sub groupmail_sent {
  704:     my ($group,$cdom,$cnum) = @_;
  705:     my $refarg;
  706:     if (exists($env{'form.ref'})) {
  707:         $refarg = 'ref='.$env{'form.ref'};
  708:     }
  709:     my $output .= '<br /><br /><a href="/adm/email?compose=group&amp;group='.
  710:                   $group.'&amp;'.$refarg.'">'.
  711:                   &mt('Send another group email').'</a>'.'&nbsp;&nbsp;&nbsp;'.
  712:                   '<a href="/adm/'.$cdom.'/'.$cnum.'/'.$group.'/smppg?'.
  713:                   $refarg.'">'. &mt('Return to group page').'</a>';
  714:     return $output;
  715: }
  716: 
  717: # ==================================================== Display Critical Message
  718: 
  719: sub discrit {
  720:     my $r=shift;
  721:     my $header = '<h1><font color="red">'.&mt('Critical Messages').'</font></h1>'.
  722:         '<form action="/adm/email" method="POST">'.
  723:         '<input type="hidden" name="confirm" value="true" />';
  724:     my %what=&Apache::lonnet::dump('critical');
  725:     my $result = '';
  726:     foreach my $key (sort(keys(%what))) {
  727:         my %content=&Apache::lonmsg::unpackagemsg($what{$key});
  728:         next if ($content{'senderdomain'} eq '');
  729:         $result.='<hr />'.&mt('From').': <b>'.
  730: &Apache::loncommon::aboutmewrapper(
  731:  &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).'</b> ('.
  732: $content{'sendername'}.':'.
  733:             $content{'senderdomain'}.') '.$content{'time'}.
  734:             '<br />'.&mt('Subject').': '.$content{'subject'}.
  735:             '<br /><pre>'.
  736:               &Apache::lontexconvert::msgtexconverted($content{'message'}).
  737:             '</pre><small>'.
  738: &mt('You have to confirm that you received this message. After confirmation, this message will be moved to your regular inbox').
  739:             '</small><br />'.
  740:             '<input type="submit" name="rec_'.$key.'" value="'.&mt('Confirm Receipt').'" />'.
  741:             '<input type="submit" name="reprec_'.$key.'" '.
  742:                   'value="'.&mt('Confirm Receipt and Reply').'" />';
  743:     }
  744:     # Check to see if there were any messages.
  745:     if ($result eq '') {
  746:         $result = "<h2>".&mt('You have no critical messages.')."</h2>".
  747: 	    '<a href="/adm/roles">'.&mt('Select a course').'</a><br />'.
  748:             '<a href="/adm/email">'.&mt('Communicate').'</a>';
  749:     } else {
  750:         $r->print($header);
  751:     }
  752:     $r->print($result);
  753:     $r->print('<input type="hidden" name="displayedcrit" value="true" /></form>');
  754: }
  755: 
  756: sub sortedmessages {
  757:     my ($blocked,$startblock,$endblock,$numblocked,$folder,$msgstatus) = @_;
  758:     my $suffix=&Apache::lonmsg::foldersuffix($folder);
  759:     my @messages = &Apache::lonnet::getkeys('nohist_email'.$suffix);
  760:     #unpack the varibles and repack into temp for sorting
  761:     my @temp;
  762:     my %descriptions;
  763:     my %status_cache = 
  764: 	&Apache::lonnet::get('email_status'.&Apache::lonmsg::foldersuffix($folder),\@messages);
  765: 
  766:     my $get_received;
  767:     if ($folder eq 'sent' 
  768: 	&& ($env{'form.sortedby'} =~ m/^(rev)?(user|domain)$/)) {
  769: 	$get_received = 1;
  770:     }
  771: 
  772:     foreach my $msgid (@messages) {
  773: 	my $esc_msgid=&escape($msgid);
  774: 	my ($sendtime,$shortsubj,$fromname,$fromdomain,$status,$fromcid,$processid,$symb,$error) =
  775: 	    &Apache::lonmsg::unpackmsgid($esc_msgid,$folder,undef,
  776: 					 \%status_cache);
  777:         next if ($msgstatus ne '' && $msgstatus ne $status);
  778:         my $description = &get_course_desc($fromcid,\%descriptions);
  779: 	my @temp1 = ($sendtime,$shortsubj,$fromname,$fromdomain,$status,
  780: 		     $esc_msgid,$description);
  781: 	if ($get_received) {
  782: 	    my %message = &Apache::lonnet::get('nohist_email'.$suffix,
  783: 					       [$msgid]);
  784: 	    my %content = &Apache::lonmsg::unpackagemsg($message{$msgid});
  785: 	    push(@temp1,$content{'recuser'},$content{'recdomain'});
  786: 	}
  787:         # Check whether message was sent during blocking period.
  788:         if ($sendtime >= $startblock && ($sendtime <= $endblock && $endblock > 0) ) {
  789:             $$blocked{$msgid} = 'ON';
  790:             $$numblocked ++;
  791:         } else { 
  792:             push @temp ,\@temp1;
  793:         }
  794:     }
  795:     #default sort
  796:     @temp = sort  {$a->[0] <=> $b->[0]} @temp;    
  797:     if ($env{'form.sortedby'} eq "date"){
  798:         @temp = sort  {$a->[0] <=> $b->[0]} @temp;    
  799:     }
  800:     if ($env{'form.sortedby'} eq "revdate"){
  801:     	@temp = sort  {$b->[0] <=> $a->[0]} @temp; 
  802:     }
  803:     if ($env{'form.sortedby'} eq "user"){
  804: 	if ($get_received) {
  805: 	    @temp = sort  {lc($a->[7][0]) cmp lc($b->[7][0])} @temp;
  806: 	} else {
  807: 	    @temp = sort  {lc($a->[2])    cmp lc($b->[2])}    @temp;
  808: 	}
  809:     }
  810:     if ($env{'form.sortedby'} eq "revuser"){
  811: 	if ($get_received) {
  812: 	    @temp = sort  {lc($b->[7][0]) cmp lc($a->[7][0])} @temp;
  813: 	} else {
  814: 	    @temp = sort  {lc($b->[2])    cmp lc($a->[2])}    @temp;
  815: 	}
  816:     }
  817:     if ($env{'form.sortedby'} eq "domain"){
  818: 	if ($get_received) {
  819: 	    @temp = sort  {$a->[8][0] cmp $b->[8][0]} @temp;
  820: 	} else {
  821: 	    @temp = sort  {$a->[3]    cmp $b->[3]}    @temp;
  822: 	}
  823:     }
  824:     if ($env{'form.sortedby'} eq "revdomain"){
  825: 	if ($get_received) {
  826: 	    @temp = sort  {$b->[8][0] cmp $a->[8][0]} @temp;
  827: 	} else {
  828: 	    @temp = sort  {$b->[3]    cmp $a->[3]}    @temp;
  829: 	}
  830:     }
  831:     if ($env{'form.sortedby'} eq "subject"){
  832:         @temp = sort  {lc($a->[1]) cmp lc($b->[1])} @temp;
  833:     }
  834:     if ($env{'form.sortedby'} eq "revsubject"){
  835:         @temp = sort  {lc($b->[1]) cmp lc($a->[1])} @temp;
  836:     }
  837:     if ($env{'form.sortedby'} eq "course"){
  838:         @temp = sort  {lc($a->[6]) cmp lc($b->[6])} @temp;
  839:     }
  840:     if ($env{'form.sortedby'} eq "revcourse"){
  841:         @temp = sort  {lc($b->[6]) cmp lc($a->[6])} @temp;
  842:     }
  843:     if ($env{'form.sortedby'} eq "status"){
  844:         @temp = sort  {$a->[4] cmp $b->[4]} @temp;
  845:     }
  846:     if ($env{'form.sortedby'} eq "revstatus"){
  847:         @temp = sort  {$b->[4] cmp $a->[4]} @temp;
  848:     }
  849:     return @temp;
  850: }
  851: 
  852: sub get_course_desc {
  853:     my ($fromcid,$descriptions) = @_;
  854:     my $description;
  855:     if (!$fromcid) {
  856:         return $description;
  857:     } else {
  858:         if (defined($$descriptions{$fromcid})) {
  859:             $description = $$descriptions{$fromcid};
  860:         } else {
  861:             if (defined($env{'course.'.$fromcid.'.description'})) {
  862:                 $description = $env{'course.'.$fromcid.'.description'};
  863:             } else {
  864:                 my %courseinfo=&Apache::lonnet::coursedescription($fromcid);
  865:                 $description = $courseinfo{'description'};
  866:             }
  867:             $$descriptions{$fromcid} = $description;
  868:         }
  869:         return $description;
  870:     }
  871: }
  872: 
  873: # ======================================================== Display all messages
  874: 
  875: sub disall {
  876:     my ($r,$folder,$msgstatus)=@_;
  877:     my %saveable = ('folder'    => 'scalar',
  878: 		    'msgstatus' => 'scalar',
  879: 		    'sortedby'  => 'scalar',
  880: 		    'interdis'  => 'scalar',
  881: 		    );
  882:     &Apache::loncommon::store_settings('user','mail',\%saveable);
  883:     &Apache::loncommon::restore_settings('user','mail',\%saveable);
  884:     $folder    ||= $env{'form.folder'};
  885:     $msgstatus ||= $env{'form.msgstatus'};
  886:     $env{'form.interdis'} ||= 20;
  887: 
  888:     $r->print(&folderlist($folder,$msgstatus));
  889:     if ($folder eq 'critical') {
  890: 	&discrit($r);
  891:     } else {
  892: 	&disfolder($r,$folder,$msgstatus);
  893:     }
  894: }
  895: 
  896: # ============================================================ Display a folder
  897: 
  898: sub disfolder {
  899:     my ($r,$folder,$msgstatus)=@_;
  900:     my %statushash = &get_msgstatus_types();
  901:     my %blocked = ();
  902:     my %setters = ();
  903:     my $numblocked = 0;
  904:     my ($startblock,$endblock) = &Apache::loncommon::blockcheck(\%setters,'com');
  905:     my %lt = &Apache::lonlocal::texthash(
  906:                       sede => 'Select a destination folder to which the messages will be moved.',
  907:                       nome => 'No messages have been selected to apply ths action to.',
  908:                       chec => 'Check the checkbox for at least one message.',  
  909:     );
  910:     my $jscript = &Apache::loncommon::check_uncheck_jscript();
  911:     $r->print(<<ENDDISHEADER);
  912: <script type="text/javascript">
  913:     $jscript
  914: 
  915:     function checkfoldermove() {
  916:         if (document.disall.checkedaction.options[document.disall.checkedaction.selectedIndex].value == 'markedmove') {
  917:             if (document.disall.movetofolder.options[document.disall.movetofolder.selectedIndex].value == "") {
  918:                 alert("$lt{'sede'}");
  919:                 return;
  920:             }
  921:         }
  922:         return; 
  923:     }
  924: 
  925:     function validate_checkedaction() {
  926:         document.disall.markedaction.value = document.disall.checkedaction.options[document.disall.checkedaction.selectedIndex].value;
  927:         if (document.disall.checkedaction.options[document.disall.checkedaction.selectedIndex].value == 'markedmove') {
  928:             if (document.disall.movetofolder.options[document.disall.movetofolder.selectedIndex].value == "") {
  929:                 alert("$lt{'sede'}");
  930:                 return;
  931:             } 
  932:         }
  933:         var checktotal = 0;
  934:         if (document.forms.disall.delmark.length > 0) {
  935:             for (var i=0; i<document.forms.disall.delmark.length; i++) {
  936:                 if (document.forms.disall.delmark[i].checked) {
  937:                     checktotal ++;
  938:                 }
  939:             }
  940:         } else {
  941:             if (document.forms.disall.delmark.checked) {
  942:                 checktotal ++;
  943:             }
  944:         }   
  945:         if (checktotal == 0) {
  946:             alert("$lt{'nome'}\\n$lt{'chec'}");
  947:             return;
  948:         }
  949:         document.disall.submit();
  950:     }
  951: 
  952: </script>
  953: ENDDISHEADER
  954: 
  955:     my $fsqs='&folder='.$folder;
  956:     my @temp=&sortedmessages(\%blocked,$startblock,$endblock,\$numblocked,$folder,$msgstatus);
  957:     my $totalnumber=$#temp+1;
  958:     if ($totalnumber < 1) {
  959:         if ($msgstatus eq '') {
  960: 	    $r->print('<h2>'.&mt('Empty Folder').'</h2>');
  961:         } elsif ($msgstatus eq 'replied') {
  962:             $r->print('<h2>'.&mt('You have not replied to any messages in this folder.').'</h2>');
  963:         } else { 
  964:             $r->print('<h2>'.&mt('There are no '.lc($statushash{$msgstatus}).' messages in this folder.').'</h2>');
  965:         }
  966:         if ($numblocked > 0) {
  967:             $r->print(&blocked_in_folder($numblocked,$startblock,$endblock,
  968:                                          \%setters));
  969:         }
  970: 	return;
  971:     }
  972:     my $interdis = $env{'form.interdis'};
  973:     my $number=int($totalnumber/$interdis);
  974:     if ($totalnumber%$interdis == 0) {
  975: 	$number--; 
  976:     }
  977: 
  978:     if (($startdis<0) || ($startdis>$number)) { $startdis=$number; }
  979:     my $firstdis=$interdis*$startdis;
  980:     if ($firstdis>$#temp) { $firstdis=$#temp-$interdis+1; }
  981:     my $lastdis=$firstdis+$interdis-1;
  982:     if ($lastdis>$#temp) { $lastdis=$#temp; }
  983:     $r->print(&scrollbuttons($startdis,$number,$firstdis,$lastdis,$totalnumber,$msgstatus));
  984:     $r->print('<form method="post" name="disall" action="/adm/email">'.
  985: 	      '<table class="LC_mail_list"><tr><th colspan="1">&nbsp;</th><th>');
  986:     if ($env{'form.sortedby'} eq "revdate") {
  987: 	$r->print('<a href = "?sortedby=date'.$fsqs.'">'.&mt('Date').'</a></th>');
  988:     } else {
  989: 	$r->print('<a href = "?sortedby=revdate'.$fsqs.'">'.&mt('Date').'</a></th>');
  990:     }
  991:     $r->print('<th>');
  992:     if ($env{'form.sortedby'} eq "revuser") {
  993: 	$r->print('<a href = "?sortedby=user'.$fsqs.'">'.&mt('Username').'</a>');
  994:     } else {
  995: 	$r->print('<a href = "?sortedby=revuser'.$fsqs.'">'.&mt('Username').'</a>');
  996:     }
  997:     $r->print('</th><th>');
  998:     if ($env{'form.sortedby'} eq "revdomain") {
  999: 	$r->print('<a href = "?sortedby=domain'.$fsqs.'">'.&mt('Domain').'</a>');
 1000:     } else {
 1001: 	$r->print('<a href = "?sortedby=revdomain'.$fsqs.'">'.&mt('Domain').'</a>');
 1002:     }
 1003:     $r->print('</th><th>');
 1004:     if ($env{'form.sortedby'} eq "revsubject") {
 1005: 	$r->print('<a href = "?sortedby=subject'.$fsqs.'">'.&mt('Subject').'</a>');
 1006:     } else {
 1007:     	$r->print('<a href = "?sortedby=revsubject'.$fsqs.'">'.&mt('Subject').'</a>');
 1008:     }
 1009:     $r->print('</th><th>');
 1010:     if ($env{'form.sortedby'} eq "revcourse") {
 1011:         $r->print('<a href = "?sortedby=course'.$fsqs.'">'.&mt('Course').'</a>');
 1012:     } else {
 1013:         $r->print('<a href = "?sortedby=revcourse'.$fsqs.'">'.&mt('Course').'</a>');
 1014:     }
 1015:     $r->print('</th><th>');
 1016:     if ($env{'form.sortedby'} eq "revstatus") {
 1017: 	$r->print('<a href = "?sortedby=status'.$fsqs.'">'.&mt('Status').'</a></th>');
 1018:     } else {
 1019:      	$r->print('<a href = "?sortedby=revstatus'.$fsqs.'">'.&mt('Status').'</a></th>');
 1020:     }
 1021:     $r->print("</tr>\n");
 1022: 
 1023:     my $suffix = &Apache::lonmsg::foldersuffix($folder);
 1024:     for (my $n=$firstdis;$n<=$lastdis;$n++) {
 1025: 	my ($sendtime,$shortsubj,$fromname,$fromdomain,$status,$origID,
 1026: 	    $description,$recv_name,$recv_domain)= 
 1027: 		@{$temp[$n]};
 1028: 	if (($status ne 'deleted') && defined($sendtime) && $sendtime!~/error/) {
 1029: 	    if ($status eq 'new') {
 1030: 		$r->print('<tr class="LC_mail_new">');
 1031: 	    } elsif ($status eq 'read') {
 1032: 		$r->print('<tr class="LC_mail_read">');
 1033: 	    } elsif ($status eq 'replied') {
 1034: 		$r->print('<tr class="LC_mail_replied">'); 
 1035: 	    } else {
 1036: 		$r->print('<tr class="LC_mail_other">');
 1037: 	    }
 1038: 	    my ($dis_name,$dis_domain) = ($fromname,$fromdomain);
 1039: 	    if ($folder eq 'sent') {
 1040:                 if (defined($recv_name) && defined($recv_domain)) {
 1041: 		    if (ref($recv_name) eq 'ARRAY' && 
 1042:                         ref($recv_domain) eq 'ARRAY') {
 1043: 		        $dis_name   = join('<br />',@{$recv_name});
 1044: 		        $dis_domain = join('<br />',@{$recv_domain});
 1045:                     }
 1046: 		} else {
 1047: 		    my $msg_id  = &unescape($origID);
 1048: 		    my %message = &Apache::lonnet::get('nohist_email'.$suffix,
 1049: 						       [$msg_id]);
 1050: 		    my %content = &Apache::lonmsg::unpackagemsg($message{$msg_id});
 1051:                     if (ref($content{'recuser'}) eq 'ARRAY') {
 1052: 		        $dis_name   = join('<br />',@{$content{'recuser'}});
 1053:                     }
 1054:                     if (ref($content{'recdomain'}) eq 'ARRAY') {
 1055: 		        $dis_domain = join('<br />',@{$content{'recdomain'}});
 1056:                     }
 1057: 		}
 1058: 	    }
 1059:             my $localsenttime = &Apache::lonlocal::locallocaltime($sendtime);
 1060:             my $count = $n +1;
 1061: 	    $r->print('<td align="right"><nobr>'.(($status eq 'new')?'<b>':'').
 1062:                       $count.'.'.(($status eq 'new')?'</b>':'').'&nbsp;'.
 1063:                       '<input type="checkbox" name="delmark"'. 
 1064:                       ' value="'.$origID.'" /></nobr></td>');
 1065:             foreach my $item ($localsenttime,$dis_name,$dis_domain,$shortsubj) {
 1066:                 $r->print('<td>'.(($status eq 'new')?'<b>':'').
 1067:                           '<a href="/adm/email?display='.$origID.$sqs.'">'.
 1068:                           $item.(($status eq 'new')?'</b>':'').'</td>');
 1069:             }
 1070:             my $showstatus;
 1071:             my %statushash = &get_msgstatus_types();
 1072:             if ($status eq '') {
 1073:                 $showstatus = '';
 1074:             } else {
 1075:                 $showstatus = $statushash{$status};
 1076:             }
 1077: 	    $r->print('<td>'.(($status eq 'new')?'<b>':'').$description.
 1078:                       (($status eq 'new')?'</b>':'').'</td><td>'.
 1079:                       (($status eq 'new')?'<b>':'').$showstatus.
 1080:                       (($status eq 'new')?'</b>':'').'</td></tr>'."\n");
 1081: 	} elsif ($status eq 'deleted') {
 1082: # purge
 1083: 	    my ($result,$msg) = 
 1084: 		&movemsg(&unescape($origID),$folder,'trash');
 1085: 	    
 1086: 	}
 1087:     }   
 1088:     $r->print("</table>\n");
 1089:     $r->print('<table border="0" cellspacing="2" cellpadding="2">
 1090:  <tr>
 1091:   <td>'.
 1092:   '<input type="button" onclick="javascript:checkAll(document.disall.delmark)" value="'.&mt('Check All').'" /><br />'."\n".
 1093:   '<input type="button" onclick="javascript:uncheckAll(document.disall.delmark)" value="'.&mt('Uncheck All').'" />'."\n".
 1094:   '<input type="hidden" name="sortedby" value="'.$env{'form.sortedby'}.'" /></td><td>&nbsp;</td>'."\n".
 1095:   '<td align="center"><b>'.&mt('Action').'</b><br />'."\n".
 1096:   '  <select name="checkedaction" onchange="javascript:checkfoldermove()">'."\n");
 1097: 
 1098:     if ($folder ne 'trash') {
 1099:         $r->print('    <option value="markeddel">'.&mt('Delete').'</option>'."\n");
 1100:     }
 1101:     if ($msgstatus ne 'read') {
 1102:         $r->print('    <option value="markedread">'.&mt('Mark Read').'</option>."\n"');
 1103:     }
 1104:     if ($msgstatus ne 'unread') {
 1105:         $r->print('    <option value="markedunread">'.&mt('Mark Unread').'</option>'."\n");
 1106:     }
 1107:     $r->print('   <option value="markedforward">'.&mt('Forward').'</option>'."\n");
 1108: 
 1109:     my %gotfolders = &Apache::lonmsg::get_user_folders();
 1110:     if (keys(%gotfolders) > 0) {
 1111:         $r->print('   <option value="markedmove">'.&mt('Move to Folder ->').
 1112:                   '</option>');
 1113:     }
 1114:     $r->print("\n".'</select></td>'."\n");
 1115: 
 1116:     if (keys(%gotfolders) > 0) {
 1117:         $r->print('<td align="center"><b>'.&mt('Destination folder').'<b><br />');
 1118: 	my %userfolders;
 1119:         foreach my $key (keys(%gotfolders)) {
 1120:             $userfolders{$key} = $key;
 1121:         }
 1122:         $userfolders{''} = "";
 1123:         $r->print(&Apache::loncommon::select_form('','movetofolder',%userfolders).
 1124:                   '</td>');
 1125:     }
 1126:     $r->print('<td>&nbsp;</td><td>&nbsp;&nbsp;'.
 1127:               '<input type="button" name="go" value="'.&mt('Go').
 1128:               '" onclick="javascript:validate_checkedaction()"/></td>'."\n".
 1129:               '</tr></table>');
 1130:     my $postedstartdis=$startdis+1;
 1131:     $r->print('<input type="hidden" name="folder" value="'.$folder.'" /><input type="hidden" name="startdis" value="'.$postedstartdis.'" /><input type="hidden" name="interdis" value="'.$env{'form.interdis'}.'" /><input type="hidden" name="msgstatus" value="'.$msgstatus.'" ><input type="hidden" name="markedaction" value="" /></form>');
 1132:     if ($numblocked > 0) {
 1133:         $r->print(&blocked_in_folder($numblocked,$startblock,$endblock,
 1134:                                      \%setters));
 1135:     }
 1136: }
 1137: 
 1138: sub blocked_in_folder {
 1139:     my ($numblocked,$startblock,$endblock,$setters) = @_;
 1140:     my $beginblock = &Apache::lonlocal::locallocaltime($startblock);
 1141:     my $finishblock = &Apache::lonlocal::locallocaltime($endblock);
 1142:     my $output = '<br /><br />'.
 1143:                   &mt('[quant,_1,message is, messages are] not viewable because display of LON-CAPA messages sent to you by other students between [_2] and [_3] is currently being blocked because of online exams.',$numblocked,$beginblock,$finishblock);
 1144:     $output .= &Apache::loncommon::build_block_table($startblock,$endblock,
 1145:                                                      $setters);
 1146:     return $output;
 1147: }
 1148: 
 1149: # ============================================================== Compose output
 1150: 
 1151: sub compout {
 1152:     my ($r,$forwarding,$replying,$broadcast,$replycrit,$folder,$dismode,
 1153:         $multiforward)=@_;
 1154:     my $suffix=&Apache::lonmsg::foldersuffix($folder);
 1155:     my ($cdom,$cnum,$group,$refarg);
 1156:     if (exists($env{'form.group'})) {
 1157:         $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
 1158:         $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
 1159:         $group = $env{'form.group'};
 1160:         my $action = 'composing';
 1161:         $r->print(&groupmail_header($action,$group,$cdom,$cnum));
 1162:     } elsif ($broadcast eq 'individual') {
 1163: 	&printheader($r,'/adm/email?compose=individual',
 1164: 	     'Send a Message');
 1165:     } elsif ($broadcast) {
 1166: 	&printheader($r,'/adm/email?compose=group',
 1167: 	     'Broadcast Message');
 1168:     } elsif ($forwarding) {
 1169: 	&Apache::lonhtmlcommon::add_breadcrumb
 1170:         ({href=>"/adm/email?display=".&escape($forwarding),
 1171:           text=>"Display Message"});
 1172: 	&printheader($r,'/adm/email?forward='.&escape($forwarding),
 1173: 	     'Forwarding a Message');
 1174:     } elsif ($replying) {
 1175: 	&Apache::lonhtmlcommon::add_breadcrumb
 1176:         ({href=>"/adm/email?display=".&escape($replying),
 1177:           text=>"Display Message"});
 1178: 	&printheader($r,'/adm/email?replyto='.&escape($replying),
 1179: 	     'Replying to a Message');
 1180:     } elsif ($replycrit) {
 1181: 	$r->print('<h3>'.&mt('Replying to a Critical Message').'</h3>');
 1182: 	$replying=$replycrit;
 1183:     } elsif ($multiforward) {
 1184:         &Apache::lonhtmlcommon::add_breadcrumb
 1185:         ({href=>"/adm/email?folder=".&escape($folder),
 1186:           text=>"Display All Messages"});
 1187:         &printheader($r,'/adm/email?compose=multiforward',
 1188:              'Forwarding Multiple Messages');
 1189:         if ($multiforward > 1) {
 1190:             $r->print(&mt('Each of the <b>[quant,_1,message]</b> you checked
 1191: will be forwarded to the recipient(s) you select below.',$multiforward).'<br />');
 1192:         } else {
 1193:             $r->print(&mt('The message you checked will be forwarded to the recipient(s) you select below.').'<br />');
 1194:         }
 1195: 
 1196:     } else {
 1197: 	&printheader($r,'/adm/email?compose=upload',
 1198: 	     'Distribute from Uploaded File');
 1199:     }
 1200: 
 1201:     my $dispcrit='';
 1202:     my $dissub='';
 1203:     my $dismsg='';
 1204:     my $disbase='';
 1205:     my $func=&mt('Send New');
 1206:     my %lt=&Apache::lonlocal::texthash('us'  => 'Username',
 1207: 				       'do'  => 'Domain',
 1208: 				       'ad'  => 'Additional Recipients',
 1209: 				       'sb'  => 'Subject',
 1210: 				       'ca'  => 'Cancel',
 1211: 				       'ma'  => 'Mail',
 1212:                                        'msg' => 'Messages',
 1213:                                        'gen' => 'Generate messages from a file',
 1214:                                        'gmt' => 'General message text',
 1215:                                        'tff' => 'The file format for the uploaded portion of the message is',
 1216:                                        'uas' => 'Upload and Send',
 1217:                                       );
 1218:     if (&Apache::lonnet::allowed('srm',$env{'request.course.id'})
 1219: 	|| &Apache::lonnet::allowed('srm',$env{'request.course.id'}.
 1220: 				    '/'.$env{'request.course.sec'})) {
 1221: 	 my $crithelp = Apache::loncommon::help_open_topic("Course_Critical_Message");
 1222:          $dispcrit=
 1223:  '<p><label><input type="checkbox" name="critmsg" /> '.&mt('Send as critical message').'</label> ' . $crithelp . 
 1224:  '</p><p>'.
 1225:  '<label><input type="checkbox" name="sendbck" /> '.&mt('Send as critical message').'  ' .
 1226:  &mt('and return receipt') . '</label>' . $crithelp . 
 1227:  '</p><p><label><input type="checkbox" name="permanent" /> '.
 1228: &mt('Send copy to permanent email address (if known)').'</label></p>'.
 1229: '<p><label><input type="checkbox" name="rsspost" /> '.
 1230: 		  &mt('Include in course RSS newsfeed').'</label></p>';
 1231:     }
 1232:     if (&Apache::lonnet::allowed('dff',$env{'request.course.id'}) ||
 1233:         &Apache::lonnet::allowed('dff',$env{'request.course.id'}.
 1234:                                  '/'.$env{'request.course.sec'})) {
 1235: 
 1236:         $dispcrit.='<p><label>'.
 1237:                    '<input type="checkbox" name="courserecord" value="1" /> '.
 1238:                    &mt("Include in course's 'User records' for recipient(s)").
 1239:                    '</label></p>';
 1240:     }
 1241: 
 1242:     my %message;
 1243:     my %content;
 1244:     my $defdom=$env{'user.domain'};
 1245:     if ($forwarding) {
 1246: 	%message=&Apache::lonnet::get('nohist_email'.$suffix,[$forwarding]);
 1247: 	%content=&Apache::lonmsg::unpackagemsg($message{$forwarding},$folder);
 1248: 	$dispcrit.='<input type="hidden" name="forwid" value="'.
 1249: 	    $forwarding.'" />';
 1250: 	$func=&mt('Forward');
 1251: 	
 1252: 	$dissub=&mt('Forwarding').': '.$content{'subject'};
 1253: 	$dismsg=&mt('Forwarded message from').' '.
 1254: 	    $content{'sendername'}.' '.&mt('at').' '.$content{'senderdomain'};
 1255: 	if ($content{'baseurl'}) {
 1256: 	    $disbase='<input type="hidden" name="baseurl" value="'.&escape($content{'baseurl'}).'" />';
 1257: 	}
 1258:     }
 1259:     if ($replying) {
 1260: 	%message=&Apache::lonnet::get('nohist_email'.$suffix,[$replying]);
 1261: 	%content=&Apache::lonmsg::unpackagemsg($message{$replying},$folder);
 1262: 	$dispcrit.='<input type="hidden" name="replyid" value="'.
 1263: 	    $replying.'" />';
 1264: 	$func=&mt('Send Reply to');
 1265: 	
 1266: 	$dissub=&mt('Reply').': '.$content{'subject'};       
 1267: 	$dismsg='> '.$content{'message'};
 1268: 	$dismsg=~s/\r/\n/g;
 1269: 	$dismsg=~s/\f/\n/g;
 1270: 	$dismsg=~s/\n+/\n\> /g;
 1271: 	if ($content{'baseurl'}) {
 1272: 	    $disbase='<input type="hidden" name="baseurl" value="'.&escape($content{'baseurl'}).'" />';
 1273: 	    if ($env{'user.adv'}) {
 1274: 		$disbase.='<label><input type="checkbox" name="storebasecomment" />'.&mt('Store message for re-use').
 1275: 		    '</label> <a href="/adm/email?showcommentbaseurl='.
 1276: 		    &escape($content{'baseurl'}).'" target="comments">'.
 1277: 		    &mt('Show re-usable messages').'</a><br />';
 1278: 	    }
 1279: 	}
 1280:     }
 1281:     my $citation=&displayresource(%content);
 1282:     my ($can_grp_broadcast,$viewgrps,$editgrps);
 1283:     if ($env{'form.recdom'}) { $defdom=$env{'form.recdom'}; }
 1284:     if ($env{'form.text'}) { $dismsg=$env{'form.text'}; }
 1285:     if ($env{'form.subject'}) { $dissub=$env{'form.subject'}; }
 1286:     $r->print(
 1287:                 '<form action="/adm/email"  name="compemail" method="post"'.
 1288:                 ' enctype="multipart/form-data">'."\n".
 1289:                 '<input type="hidden" name="sendmail" value="on" />'."\n");
 1290:     if ($broadcast eq 'group' && $env{'form.group'} ne '') {
 1291:         $can_grp_broadcast = 
 1292:                 &Apache::lonnet::allowed('sgb',$env{'request.course.id'}.'/'.
 1293:                                          $group);
 1294:         $viewgrps = 
 1295:                &Apache::lonnet::allowed('vcg',$env{'request.course.id'}.
 1296:                ($env{'request.course.sec'}?'/'.$env{'request.course.sec'}:''));
 1297:         $editgrps = 
 1298:                &Apache::lonnet::allowed('mdg',$env{'request.course.id'}.
 1299:                ($env{'request.course.sec'}?'/'.$env{'request.course.sec'}:''));
 1300:         if ($viewgrps || $editgrps || $can_grp_broadcast) {
 1301:             $r->print(&disgroup($cdom,$cnum,$group,$viewgrps,$editgrps));
 1302:         }
 1303:     }
 1304:     $r->print('<table>');
 1305:     if (($broadcast eq 'group') && ($group ne '') && 
 1306:         (!$can_grp_broadcast && !$viewgrps && !$editgrps)) {
 1307:         $r->print(&recipient_input_row($cdom,%lt));
 1308:     } 
 1309:     if (($broadcast ne 'group') && ($broadcast ne 'upload')) {
 1310: 	if ($replying) {
 1311: 	    $r->print('<tr><td colspan="2">'.&mt('Replying to').' '.
 1312: 		      &Apache::loncommon::aboutmewrapper(
 1313: 							 &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).' ('.
 1314: 		      $content{'sendername'}.':'.
 1315: 		      $content{'senderdomain'}.')'.
 1316: 		      '<input type="hidden" name="recuname" value="'.$content{'sendername'}.'" />'.
 1317: 		      '<input type="hidden" name="recdomain" value="'.$content{'senderdomain'}.'" />'.
 1318: 		      '</td></tr>');
 1319: 	} else {
 1320:             $r->print(&recipient_input_row($defdom,%lt));
 1321:         }
 1322:     }
 1323:     my $latexHelp = Apache::loncommon::helpLatexCheatsheet();
 1324:     my $subj_size;
 1325:     if ($multiforward) {
 1326:         $r->print(&additional_rec_row(\%lt));
 1327:         $r->print('<tr><td colspan="2">'.
 1328:                   &mt('Unless you choose otherwise:').'<ul><li>'.
 1329:         &mt("The subject in each forwarded message will be <i>'Forwarding:'</i> followed by the original subject.").'</li><li>'.
 1330:         &mt("The message itself will begin with a first line: <i>'Forwarded message from'</i> followed by the original sender's name.").'</li></ul></td></tr>');
 1331:         $func=&mt('Forward');
 1332:         $dissub = &mt('Forwarding').': ';
 1333:         $subj_size = '10';
 1334:         my $extra = '&lt;'.&mt('original subject').'&gt;&nbsp;&nbsp;&nbsp;'.
 1335:                     '<input type="radio" name="showorigsubj" value="1" checked="checked" />'.&mt('Yes').'&nbsp;<input type="radio" name="showorigsubj" value="0" />'.&mt('No');
 1336:         $dismsg = &mt('Forwarded message from ').' ';
 1337:         my $sender = &mt("sender's name");
 1338:         $r->print(&msg_subject_row($dissub,\%lt,$subj_size,$extra));
 1339:         $r->print('<tr><td>'.&mt('Message begins with:').'</td><td><input type="text" name="msgheader" value="'.$dismsg.'" />&nbsp;'.$sender.'&nbsp;&nbsp;&nbsp;<input type="radio" name="showorigsender" value="1" checked="checked" />'.&mt('Yes').'&nbsp;<input type="radio" name="showorigsender" value="0" />'.&mt('No').'<input type="hidden" name="multiforward" value="'.$multiforward.'" /></td></tr>
 1340: </table>
 1341: <br />'.
 1342: $latexHelp.
 1343: &mt("Any new text to display before the text of the original messages:").'<br />
 1344: <textarea name="message" id="message" cols="80" rows="5" wrap="hard">
 1345: </textarea></p><br />');
 1346:         my @to_forward = &Apache::loncommon::get_env_multiple('form.delmark');
 1347:         foreach my $msg (@to_forward) {
 1348:             $r->print('<input type="hidden" name="delmark" value="'.$msg.'" />');
 1349:         }
 1350:         $r->print(&submit_button_row($folder,$dismode,$func.' '.$lt{'msg'},
 1351:                                      \%lt));
 1352:     } elsif ($broadcast ne 'upload') {
 1353:         $subj_size = '50';
 1354:         $r->print(&additional_rec_row(\%lt));
 1355:         $r->print(&msg_subject_row($dissub,\%lt,$subj_size));
 1356:         $r->print(<<"ENDCOMP");
 1357: </table>
 1358: $latexHelp
 1359: <textarea name="message" id="message" cols="80" rows="15" wrap="hard">$dismsg
 1360: </textarea></p><br />
 1361: $dispcrit
 1362: $disbase
 1363: ENDCOMP
 1364:         $r->print(&submit_button_row($folder,$dismode,$func.' '.$lt{'ma'},
 1365:                                      \%lt));
 1366:         $r->print($citation);
 1367:         if (exists($env{'form.ref'})) {
 1368:             $r->print('<input type="hidden" name="ref" value="'.
 1369:                       $env{'form.ref'}.'" />');
 1370:         }
 1371:         if (exists($env{'form.group'})) {
 1372:             $r->print('<input type="hidden" name="group" value="'.
 1373:                       $env{'form.group'}.'" />');
 1374:         }
 1375:     } else { # $broadcast is 'upload'
 1376: 	$r->print(<<ENDBLOCK);
 1377: <input type="hidden" name="sendmode" value="upload" />
 1378: <input type="hidden" name="send" value="on" />
 1379: <h3>$lt{'gen'}</h3>
 1380: <p>
 1381: Subject: <input type="text" size="50" name="subject" />
 1382: </p>
 1383: <p>$lt{'gmt'}:<br />
 1384: <textarea name="message" id="message" cols="60" rows="10" wrap="hard">$dismsg
 1385: </textarea></p>
 1386: <p>
 1387: $lt{'tff'}:
 1388: ENDBLOCK
 1389:        $r->print('
 1390: <pre>'."\n".
 1391: &mt('username1:domain1: text')."\n".
 1392: &mt('username2:domain2: text')."\n".
 1393: &mt('username3:domain1: text')."\n".
 1394: '</pre>
 1395: </p>
 1396: <p>
 1397: '.&mt('The messages will be assembled from all lines with the respective'."\n".'<tt>username:domain</tt>, and appended to the general message text.'));
 1398:         $r->print(<<ENDUPLOAD);
 1399: </p>
 1400: <p>
 1401: <input type="file" name="upfile" size="40" /></p><p>
 1402: $dispcrit
 1403: <input type="submit" value="$lt{'uas'}" /></p>
 1404: ENDUPLOAD
 1405:     }
 1406:     if ($broadcast eq 'group') {
 1407:        if ($group eq '') {
 1408:            my $studentsel = &discourse();
 1409:            $r->print($studentsel);
 1410:        }
 1411:     }
 1412:     if ($env{'form.displayedcrit'}) {
 1413: 	$r->print('<input type="hidden" name="displayedcrit" value="true" />');
 1414:     }
 1415:     $r->print('</form>'.
 1416: 	      &Apache::lonfeedback::generate_preview_button('compemail','message').
 1417: 	      &Apache::lonhtmlcommon::htmlareaselectactive('message'));
 1418: }
 1419: 
 1420: # ---------------------------------------------------- Display all face to face
 1421: 
 1422: sub recipient_input_row {
 1423:     my ($dom,%lt) = @_;
 1424:     my $domform = &Apache::loncommon::select_dom_form($dom,'recdomain');
 1425:     my $selectlink=
 1426:       &Apache::loncommon::selectstudent_link('compemail','recuname',
 1427:                                              'recdomain');
 1428:     my $output = <<"ENDREC";
 1429: <tr><td>$lt{'us'}:</td><td><input type="text" size="12" name="recuname" value="$env{'form.recname'}" /></td><td rowspan="2">$selectlink</td></tr>
 1430: <tr><td>$lt{'do'}:</td>
 1431: <td>$domform</td></tr>
 1432: ENDREC
 1433:     return $output;
 1434: }
 1435: 
 1436: sub additional_rec_row {
 1437:     my ($lt) = @_;
 1438:     my $output = <<"ENDADD";
 1439: <tr><td>$lt->{'ad'}:<br /><tt>username:domain,username:domain, ...
 1440: </tt></td><td>
 1441: <input type="text" size="50" name="additionalrec" /></td></tr>
 1442: ENDADD
 1443:     return $output;
 1444: }
 1445: 
 1446: sub submit_button_row {
 1447:     my ($folder,$dismode,$sendtext,$lt) = @_;
 1448:     my $output = qq| 
 1449: <input type="hidden" name="folder" value="$folder" />
 1450: <input type="hidden" name="dismode" value="$dismode" />
 1451: <input type="submit" name="send" value="$sendtext" />
 1452: <input type="submit" name="cancel" value="$lt->{'ca'}" /><hr />
 1453: |;
 1454:     return $output;
 1455: }
 1456: 
 1457: sub msg_subject_row {
 1458:     my ($dissub,$lt,$subj_size,$extra) = @_;
 1459:     my $output = '<tr><td>'.$lt->{'sb'}.':</td><td><input type="text" size="'.
 1460:                  $subj_size.'" name="subject" value="'.$dissub.'" />'.$extra.
 1461:                  '</td></tr>';
 1462:     return $output;
 1463: }
 1464: 
 1465: sub retrieve_instructor_comments {
 1466:     my ($user,$domain)=@_;
 1467:     my $target=$env{'form.grade_target'};
 1468:     if (! $env{'request.course.id'}) { return; }
 1469:     if (! &Apache::lonnet::allowed('dff',$env{'request.course.id'})
 1470: 	&& ! &Apache::lonnet::allowed('dff',$env{'request.course.id'}.
 1471: 				      '/'.$env{'request.course.sec'})) {
 1472: 	return;
 1473:     }
 1474:     my %records=&Apache::lonnet::dump('nohist_email',
 1475: 			 $env{'course.'.$env{'request.course.id'}.'.domain'},
 1476: 			 $env{'course.'.$env{'request.course.id'}.'.num'},
 1477:                          '%255b'.$user.'%253a'.$domain.'%255d');
 1478:     my $result='';
 1479:     foreach my $key (sort(keys(%records))) {
 1480:         my %content=&Apache::lonmsg::unpackagemsg($records{$key});
 1481:         next if ($content{'senderdomain'} eq '');
 1482:         next if ($content{'subject'} !~ /^Record/);
 1483: 	# &Apache::lonfeedback::newline_to_br(\$content{'message'});
 1484: 	$result.='Recorded by '.
 1485:             $content{'sendername'}.':'.$content{'senderdomain'}."\n";
 1486:         $result.=
 1487:             &Apache::lontexconvert::msgtexconverted($content{'message'})."\n";
 1488:      }
 1489:     return $result;
 1490: }
 1491: 
 1492: sub disfacetoface {
 1493:     my ($r,$user,$domain)=@_;
 1494:     my $target=$env{'form.grade_target'};
 1495:     unless ($env{'request.course.id'}) { return; }
 1496:     if  (!&Apache::lonnet::allowed('dff',$env{'request.course.id'})
 1497: 	 && ! &Apache::lonnet::allowed('dff',$env{'request.course.id'}.
 1498: 				       '/'.$env{'request.course.sec'})) {
 1499: 	$r->print(&mt('Not allowed'));
 1500: 	return;
 1501:     }
 1502:     my %records=&Apache::lonnet::dump('nohist_email',
 1503: 			 $env{'course.'.$env{'request.course.id'}.'.domain'},
 1504: 			 $env{'course.'.$env{'request.course.id'}.'.num'},
 1505:                          '%255b'.$user.'%253a'.$domain.'%255d');
 1506:     my $result='';
 1507:     foreach my $key (sort(keys(%records))) {
 1508:         my %content=&Apache::lonmsg::unpackagemsg($records{$key});
 1509:         next if ($content{'senderdomain'} eq '');
 1510: 	&Apache::lonfeedback::newline_to_br(\$content{'message'});
 1511:         if ($content{'subject'}=~/^Record/) {
 1512: 	    $result.='<h3>'.&mt('Record').'</h3>';
 1513:         } elsif ($content{'subject'}=~/^Broadcast/) {
 1514:             $result .='<h3>'.&mt('Broadcast Message').'</h3>';
 1515:             if ($content{'subject'}=~/^Broadcast\./) {
 1516:                 if (defined($content{'coursemsgid'})) {
 1517:                     my $crsmsgid = &escape($content{'coursemsgid'});
 1518:                     my $broadcast_message = &general_message($crsmsgid);
 1519:                     $content{'message'} = '<b>'.&mt('Subject').': '.$content{'message'}.'</b><br />'.$broadcast_message;
 1520:                 } else {
 1521:                     %content=&Apache::lonmsg::unpackagemsg($content{'message'});
 1522:                     $content{'message'} =
 1523:                     '<b>'.&mt('Subject').': '.$content{'subject'}.'</b><br />'.
 1524:                     $content{'message'};
 1525:                 }
 1526:             }
 1527:         } elsif ($content{'subject'}=~/^Archive/) {
 1528:             $result.='<h3>'.&mt('Archived Message').'</h3>';
 1529:             if (defined($content{'coursemsgid'})) {
 1530:                 my $crsmsgid = &escape($content{'coursemsgid'});
 1531:                 my $archive_message = &general_message($crsmsgid);
 1532:                 $content{'message'} = '<b>'.&mt('Subject').': '.$content{'message'}.'</b><br />'.$archive_message;
 1533:             } else {
 1534:                 %content=&Apache::lonmsg::unpackagemsg($content{'message'});
 1535:                 $content{'message'} =
 1536:                 '<b>'.&mt('Subject').': '.$content{'subject'}.'</b><br
 1537: '.
 1538:                 $content{'message'};
 1539:             }
 1540:         } else {
 1541:             $result.='<h3>'.&mt('Critical Message').'</h3>';
 1542:             if (defined($content{'coursemsgid'})) {
 1543:                 my $crsmsgid=&escape($content{'coursemsgid'});
 1544:                 my $critical_message = &general_message($crsmsgid);
 1545:                 $content{'message'} = '<b>'.&mt('Subject').': '.$content{'message'}.'</b><br />'.$critical_message;
 1546:             } else {
 1547:                 %content=&Apache::lonmsg::unpackagemsg($content{'message'});
 1548:                 $content{'message'}=
 1549:                 '<b>'.&mt('Subject').': '.$content{'subject'}.'</b><br />'.
 1550: 		$content{'message'};
 1551:             }
 1552:         }
 1553:         $result.=&mt('By').': <b>'.
 1554: &Apache::loncommon::aboutmewrapper(
 1555:  &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),$content{'sendername'},$content{'senderdomain'}).'</b> ('.
 1556: $content{'sendername'}.':'.
 1557:             $content{'senderdomain'}.') '.$content{'time'}.
 1558:             '<br /><pre>'.
 1559:               &Apache::lontexconvert::msgtexconverted($content{'message'}).
 1560: 	      '</pre>';
 1561:      }
 1562:     # Check to see if there were any messages.
 1563:     if ($result eq '') {
 1564:         my $lctype = lc(&Apache::loncommon::course_type());
 1565: 	if ($target ne 'tex') { 
 1566: 	    $r->print("<p><b>".&mt('No notes, face-to-face discussion records, critical messages, or broadcast messages in this [_1].',$lctype)."</b></p>");
 1567: 	} else {
 1568: 	    $r->print('\textbf{'.&mt('No notes, face-to-face discussion records, critical messages or broadcast messages in this [_1].',$lctype).'}\\\\');
 1569: 	}
 1570:     } else {
 1571:        $r->print($result);
 1572:     }
 1573: }
 1574: 
 1575: sub general_message {
 1576:     my ($crsmsgid) = @_;
 1577:     my %general_content;
 1578:     if ($crsmsgid) { 
 1579:         my %course_content = &Apache::lonnet::get('nohist_email',[$crsmsgid],
 1580:                            $env{'course.'.$env{'request.course.id'}.'.domain'},
 1581:                            $env{'course.'.$env{'request.course.id'}.'.num'});
 1582:         %general_content = &Apache::lonmsg::unpackagemsg($course_content{$crsmsgid});
 1583:     }
 1584:     return $general_content{'message'};
 1585: }
 1586: 
 1587: # ---------------------------------------------------------------- Face to face
 1588: 
 1589: sub facetoface {
 1590:     my ($r,$stage)=@_;
 1591:     if (!&Apache::lonnet::allowed('dff',$env{'request.course.id'})
 1592: 	&& ! &Apache::lonnet::allowed('dff',$env{'request.course.id'}.
 1593: 				      '/'.$env{'request.course.sec'})) {
 1594: 	$r->print(&mt('Not allowed'));
 1595: 	return;
 1596:     }
 1597:     my $crstype = &Apache::loncommon::course_type();
 1598:     my $leaders = ($crstype eq 'Group') ? 'coordinators and leaders'
 1599:                                         : 'faculty and staff';
 1600:     &printheader($r,
 1601: 		 '/adm/email?recordftf=query',
 1602: 		 "User Notes, Face-to-Face, Critical Messages, Broadcast Messages, Archived Messages");
 1603: # from query string
 1604: 
 1605:     if ($env{'form.recname'}) { $env{'form.recuname'}=$env{'form.recname'}; }
 1606:     if ($env{'form.recdom'}) { $env{'form.recdomain'}=$env{'form.recdom'}; }
 1607: 
 1608:     my $defdom=$env{'user.domain'};
 1609: # already filled in
 1610:     if ($env{'form.recdomain'}) { $defdom=$env{'form.recdomain'}; }
 1611: # generate output
 1612:     my $domform = &Apache::loncommon::select_dom_form($defdom,'recdomain');
 1613:     my $stdbrws = &Apache::loncommon::selectstudent_link
 1614: 	('stdselect','recuname','recdomain');
 1615:     my %lt=&Apache::lonlocal::texthash('user' => 'Username',
 1616: 				       'dom' => 'Domain',
 1617: 				       'head' => "User Notes, Records of Face-To-Face Discussions, Critical Messages, Broadcast Messages and Archived Messages in $crstype",
 1618: 				       'subm' => 'Retrieve discussion and message records',
 1619: 				       'newr' => 'New Record (record is visible to '.lc($crstype).' '.$leaders.')',
 1620: 				       'post' => 'Post this Record');
 1621:     $r->print(<<"ENDTREC");
 1622: <h3>$lt{'head'}</h3>
 1623: <form method="post" action="/adm/email" name="stdselect">
 1624: <input type="hidden" name="recordftf" value="retrieve" />
 1625: <table>
 1626: <tr><td>$lt{'user'}:</td><td><input type="text" size="12" name="recuname" value="$env{'form.recuname'}" /></td>
 1627: <td rowspan="2">
 1628: $stdbrws
 1629: <input type="submit" value="$lt{'subm'}" /></td>
 1630: </tr>
 1631: <tr><td>$lt{'dom'}:</td>
 1632: <td>$domform</td></tr>
 1633: </table>
 1634: </form>
 1635: ENDTREC
 1636:     if (($stage ne 'query') &&
 1637:         ($env{'form.recdomain'}) && ($env{'form.recuname'})) {
 1638:         chomp($env{'form.newrecord'});
 1639:         if ($env{'form.newrecord'}) {
 1640: 	    &Apache::lonmsg::store_instructor_comment($env{'form.newrecord'},
 1641: 						      $env{'form.recuname'},
 1642: 						      $env{'form.recdomain'});
 1643:         }
 1644:         $r->print('<h3>'.&Apache::loncommon::plainname($env{'form.recuname'},
 1645: 				     $env{'form.recdomain'}).'</h3>');
 1646:         &disfacetoface($r,$env{'form.recuname'},$env{'form.recdomain'});
 1647: 	$r->print(<<ENDRHEAD);
 1648: <form method="post" action="/adm/email">
 1649: <input name="recdomain" value="$env{'form.recdomain'}" type="hidden" />
 1650: <input name="recuname" value="$env{'form.recuname'}" type="hidden" />
 1651: ENDRHEAD
 1652:         $r->print(<<ENDBFORM);
 1653: <hr />$lt{'newr'}<br />
 1654: <textarea name="newrecord" cols="80" rows="10" wrap="hard"></textarea>
 1655: <br />
 1656: <input type="hidden" name="recordftf" value="post" />
 1657: <input type="submit" value="$lt{'post'}" />
 1658: </form>
 1659: ENDBFORM
 1660:     }
 1661: }
 1662: 
 1663: # ----------------------------------------------------------- Blocking during exams
 1664: 
 1665: sub examblock {
 1666:     my ($r,$action) = @_;
 1667:     unless ($env{'request.course.id'}) { return;}
 1668:     if (!&Apache::lonnet::allowed('dcm',$env{'request.course.id'})
 1669: 	&& ! &Apache::lonnet::allowed('dcm',$env{'request.course.id'}.
 1670: 				      '/'.$env{'request.course.sec'})) {
 1671: 	$r->print('Not allowed');
 1672: 	return;
 1673:     }
 1674:     my $usertype = (&Apache::loncommon::course_type() eq 'Group') ? 'members'
 1675: 	                                                          : 'students';
 1676:     my %lt=&Apache::lonlocal::texthash(
 1677:             'comb' => 'Communication Blocking',
 1678:             'cbds' => 'Communication blocking during scheduled exams',
 1679:             'desc' => "You can use communication blocking to prevent $usertype enrolled in this course from displaying LON-CAPA messages sent by other $usertype during an online exam. As blocking of communication could potentially interrupt legitimate communication between $usertype 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.",
 1680:              'mecb' => 'Modify existing communication blocking periods',
 1681:              'ncbc' => 'No communication blocks currently stored',
 1682:              'stor' => 'Store',
 1683:     );
 1684: 
 1685:     my %ltext = &Apache::lonlocal::texthash(
 1686:             'dura' => 'Duration',
 1687:             'setb' => 'Set by',
 1688:             'even' => 'Event',
 1689:             'blck' => 'Blocked?',
 1690:             'actn' => 'Action',
 1691:             'star' => 'Start',
 1692:             'endd' => 'End'
 1693:     );
 1694: 
 1695:     &printheader($r,'/adm/email?block=display',$lt{'comb'});
 1696:     $r->print('<h3>'.$lt{'cbds'}.'</h3>');
 1697: 
 1698:     if ($action eq 'store') {
 1699:         &blockstore($r);
 1700:     }
 1701: 
 1702:     $r->print($lt{'desc'}.'<br /><br />
 1703:                <form name="blockform" method="post" action="/adm/email?block=store">
 1704:              ');
 1705: 
 1706:     $r->print('<h4>'.$lt{'mecb'}.'</h4>');
 1707:     my %records = ();
 1708:     my $blockcount = 0;
 1709:     my $parmcount = 0;
 1710:     &get_blockdates(\%records,\$blockcount);
 1711:     if ($blockcount > 0) {
 1712:         $parmcount = &display_blocker_status($r,\%records,\%ltext);
 1713:     } else {
 1714:         $r->print($lt{'ncbc'}.'<br /><br />');
 1715:     }
 1716:     &display_addblocker_table($r,$parmcount,\%ltext);
 1717:     my $end_page=&Apache::loncommon::end_page();
 1718:     $r->print(<<"END");
 1719: <br />
 1720: <input type="hidden" name="blocktotal" value="$blockcount" />
 1721: <input type ="submit" value="$lt{'stor'}" />
 1722: </form>
 1723: $end_page
 1724: END
 1725:     return;
 1726: }
 1727: 
 1728: sub blockstore {
 1729:     my $r = shift;
 1730:     my %lt=&Apache::lonlocal::texthash(
 1731:             'tfcm' => 'The following changes were made',
 1732:             'ncwm' => 'No changes were made.' 
 1733:     );
 1734:     my %adds = ();
 1735:     my %removals = ();
 1736:     my %cancels = ();
 1737:     my $modtotal = 0;
 1738:     my $canceltotal = 0;
 1739:     my $addtotal = 0;
 1740:     my %blocking = ();
 1741:     $r->print('<h3>'.$lt{'head'}.'</h3>');
 1742:     foreach my $envkey (keys(%env)) {
 1743:         if ($envkey =~ m/^form\.modify_(\d+)$/) {
 1744:             $adds{$1} = $1;
 1745:             $removals{$1} = $1;
 1746:             $modtotal ++;
 1747:         } elsif ($envkey =~ m/^form\.cancel_(\d+)$/) {
 1748:             $cancels{$1} = $1;
 1749:             unless ( defined($removals{$1}) ) {
 1750:                 $removals{$1} = $1;
 1751:                 $canceltotal ++;
 1752:             }
 1753:         } elsif ($envkey =~ m/^form\.add_(\d+)$/) {
 1754:             $adds{$1} = $1;
 1755:             $addtotal ++;
 1756:         } 
 1757:     }
 1758: 
 1759:     foreach my $key (keys(%removals)) {
 1760:         my $hashkey = $env{'form.key_'.$key};
 1761:         &Apache::lonnet::del('comm_block',["$hashkey"],
 1762:                          $env{'course.'.$env{'request.course.id'}.'.domain'},
 1763:                          $env{'course.'.$env{'request.course.id'}.'.num'}
 1764:                          );
 1765:     }
 1766:     foreach my $key (keys(%adds)) {
 1767:         unless ( defined($cancels{$key}) ) {
 1768:             my ($newstart,$newend) = &get_dates_from_form($key);
 1769:             my $newkey = $newstart.'____'.$newend;
 1770:             my $blocktypes = &get_block_choices($key);
 1771:             $blocking{$newkey} = {
 1772:                           setter => $env{'user.name'}.':'.$env{'user.domain'},
 1773:                           event  => &escape($env{'form.title_'.$key}),
 1774:                           blocks => $blocktypes,
 1775:                         };
 1776:         }
 1777:     }
 1778:     if ($addtotal + $modtotal > 0) {
 1779:         &Apache::lonnet::put('comm_block',\%blocking,
 1780:                      $env{'course.'.$env{'request.course.id'}.'.domain'},
 1781:                      $env{'course.'.$env{'request.course.id'}.'.num'}
 1782:                      );
 1783:     }
 1784:     my $chgestotal = $canceltotal + $modtotal + $addtotal;
 1785:     if ($chgestotal > 0) {
 1786:         $r->print($lt{'tfcm'}.'<ul>');
 1787:         if ($canceltotal > 0) {
 1788:             $r->print('<li>'.&mt('[quant,_1,communication blocking period was,communication blocking periods were] removed.',$canceltotal).'</li>');
 1789:         }
 1790:         if ($modtotal > 0) {
 1791:             $r->print('<li>'.&mt('[quant,_1,communication blocking period was,communication blocking periods were] modified.',$modtotal).'</li>');
 1792:         }
 1793:         if ($addtotal > 0) {
 1794:             $r->print('<li>'.&mt('[quant,_1,communication blocking period was,communication blocking periods were] added.',$addtotal).'</li>');
 1795:         }
 1796:         $r->print('</ul>');
 1797:     } else {
 1798:         $r->print($lt{'ncwm'});
 1799:     }
 1800:     $r->print('<br />');
 1801:     return;
 1802: }
 1803: 
 1804: sub get_dates_from_form {
 1805:     my $item = shift;
 1806:     my $startdate = &Apache::lonhtmlcommon::get_date_from_form('startdate_'.$item);
 1807:     my $enddate   = &Apache::lonhtmlcommon::get_date_from_form('enddate_'.$item);
 1808:     return ($startdate,$enddate);
 1809: }
 1810: 
 1811: sub get_blockdates {
 1812:     my ($records,$blockcount) = @_;
 1813:     $$blockcount = 0;
 1814:     %{$records} = &Apache::lonnet::dump('comm_block',
 1815:                          $env{'course.'.$env{'request.course.id'}.'.domain'},
 1816:                          $env{'course.'.$env{'request.course.id'}.'.num'}
 1817:                          );
 1818:     $$blockcount = keys(%{$records});
 1819: 
 1820:     if ((keys(%{$records}))[0] =~ /^error: 2 /) {
 1821: 	$records = {};
 1822: 	$$blockcount = 0;
 1823:     }
 1824: }
 1825: 
 1826: sub get_block_choices {
 1827:     my $item = shift;
 1828:     my $blocklist;
 1829:     my ($typeorder,$types) = &blocktype_text();
 1830:     foreach my $type (@{$typeorder}) {
 1831:         if ($env{'form.'.$type.'_'.$item}) {
 1832:             $blocklist->{$type} = 'on'; 
 1833:         } else {
 1834:             $blocklist->{$type} = 'off';
 1835:         }
 1836:     }
 1837:     return $blocklist;
 1838: }
 1839: 
 1840: sub display_blocker_status {
 1841:     my ($r,$records,$ltext) = @_;
 1842:     my $parmcount = 0;
 1843:   
 1844:     my %lt = &Apache::lonlocal::texthash(
 1845:         'modi' => 'Modify',
 1846:         'canc' => 'Cancel',
 1847:     );
 1848:     my ($typeorder,$types) = &blocktype_text();
 1849:     $r->print(&Apache::loncommon::start_data_table());
 1850:     $r->print(<<"END");
 1851:   <tr>
 1852:     <th>$ltext->{'dura'}</th>
 1853:     <th>$ltext->{'setb'}</th>
 1854:     <th>$ltext->{'even'}</th>
 1855:     <th>$ltext->{'blck'}</th>
 1856:     <th>$ltext->{'actn'}?</th>
 1857:   </tr>
 1858: END
 1859:     foreach my $record (sort(keys(%{$records}))) {
 1860:         my $onchange = 'onFocus="javascript:window.document.forms['.
 1861:                        "'blockform'].elements['modify_".$parmcount."'].".
 1862:                        'checked=true;"';
 1863:         my ($start,$end) = split(/____/,$record);
 1864:         my $startform = &Apache::lonhtmlcommon::date_setter('blockform','startdate_'.$parmcount,$start,$onchange);
 1865:         my $endform = &Apache::lonhtmlcommon::date_setter('blockform','enddate_'.$parmcount,$end,$onchange);
 1866: 	
 1867: 	my ($setuname,$setudom,$title,$blocks) = 
 1868: 	    &Apache::loncommon::parse_block_record($$records{$record});
 1869: 	$title = &HTML::Entities::encode($title,'"<>&');
 1870:         my $settername = 
 1871:            &Apache::loncommon::aboutmewrapper(
 1872:                            &Apache::loncommon::plainname($setuname,$setudom),
 1873:                            $setuname,$setudom);
 1874:         $r->print(&Apache::loncommon::start_data_table_row());
 1875:         $r->print(<<"END");
 1876:         <td>$ltext->{'star'}:&nbsp;$startform<br/>$ltext->{'endd'}:&nbsp;&nbsp;$endform</td>
 1877:         <td>$settername</td>
 1878:         <td><input type="text" name="title_$parmcount" size="15" value="$title" /><input type="hidden" name="key_$parmcount" value="$record" /></td>
 1879:         <td>
 1880: END
 1881:         foreach my $block (@{$typeorder}) {
 1882:             my $blockstatus = '';
 1883:             if ($blocks->{$block} eq 'on') {
 1884:                 $blockstatus = 'checked="true"';
 1885:             }
 1886:             $r->print('<label><input type="checkbox" name="'.$block.'_'.$parmcount.'" '.$blockstatus.' value="1" />'.$types->{$block}.'</label><br />');
 1887:         }
 1888:         $r->print(<<"END");
 1889:         </td>      
 1890:         <td><label>$lt{'modi'}?&nbsp;<input type="checkbox" name="modify_$parmcount" /></label><br /><label>$lt{'canc'}?&nbsp;&nbsp;<input type="checkbox" name="cancel_$parmcount" /></label>
 1891: END
 1892:         $r->print(&Apache::loncommon::end_data_table_row());
 1893:         $parmcount++;
 1894:     }
 1895:     $r->print(<<"END");
 1896: </table>
 1897: <br />
 1898: <br />
 1899: END
 1900:     return $parmcount;
 1901: }
 1902: 
 1903: sub display_addblocker_table {
 1904:     my ($r,$parmcount,$ltext) = @_;
 1905:     my $start = time;
 1906:     my $end = $start + (60 * 60 * 2); #Default is an exam of 2 hours duration.
 1907:     my $onchange = 'onFocus="javascript:window.document.forms['.
 1908:                    "'blockform'].elements['add_".$parmcount."'].".
 1909:                    'checked=true;"';
 1910:     my $startform = &Apache::lonhtmlcommon::date_setter('blockform','startdate_'.$parmcount,$start,$onchange);
 1911:     my $endform = &Apache::lonhtmlcommon::date_setter('blockform','enddate_'.$parmcount,$end,$onchange);
 1912:     my %lt = &Apache::lonlocal::texthash(
 1913:         'addb' => 'Add block',
 1914:         'exam' => 'e.g., Exam 1',
 1915:         'addn' => 'Add new communication blocking periods'
 1916:     );
 1917:     my ($typeorder,$types) = &blocktype_text();
 1918:     $r->print(<<"END");
 1919: <h4>$lt{'addn'}</h4> 
 1920: END
 1921:     $r->print(&Apache::loncommon::start_data_table());
 1922:     $r->print(<<"END");
 1923:    <tr>
 1924:      <th>$ltext->{'dura'}</th>
 1925:      <th>$ltext->{'even'} $lt{'exam'}</th>
 1926:      <th>$ltext->{'blck'}</th>
 1927:      <th>$ltext->{'actn'}?</th>
 1928:    </tr>
 1929: END
 1930:     $r->print(&Apache::loncommon::start_data_table_row());
 1931:     $r->print(<<"END");
 1932:      <td>$ltext->{'star'}:&nbsp;$startform<br />$ltext->{'endd'}:&nbsp;&nbsp;$endform</td>
 1933:      <td><input type="text" name="title_$parmcount" size="15" value="" /></td>
 1934:      <td>
 1935: END
 1936:     foreach my $block (@{$typeorder}) {
 1937:         $r->print('<label><input type="checkbox" name="'.$block.'_'.$parmcount.'" value="1" />'.$types->{$block}.'</label><br />');
 1938:      }
 1939:      $r->print(<<"END");
 1940:      </td> 
 1941:      <td><label>$lt{'addb'}?&nbsp;<input type="checkbox" name="add_$parmcount" value="1" /></label></td>
 1942: END
 1943:     $r->print(&Apache::loncommon::end_data_table_row());
 1944:     $r->print(&Apache::loncommon::end_data_table());
 1945:     return;
 1946: }
 1947: 
 1948: sub blocktype_text {
 1949:     my %types = &Apache::lonlocal::texthash(
 1950:         'com' => 'Messaging',
 1951:         'chat' => 'Chat',
 1952:         'boards' => 'Discussion',
 1953:         'port' => 'Portfolio',
 1954:         'groups' => 'Groups',
 1955:         'blogs' => 'Blogs',
 1956:     );
 1957:     my $typeorder = ['com','chat','boards','port','groups','blogs'];
 1958:     return ($typeorder,\%types);
 1959: }
 1960: 
 1961: # ----------------------------------------------------------- Display a message
 1962: 
 1963: sub displaymessage {
 1964:     my ($r,$msgid,$folder,$msgstatus)=@_;
 1965:     my $suffix=&Apache::lonmsg::foldersuffix($folder);
 1966:     my %blocked = ();
 1967:     my %setters = ();
 1968:     my $numblocked = 0;
 1969:     my $crstype = &Apache::loncommon::course_type();
 1970: 
 1971: # info to generate "next" and "previous" buttons and check if message is blocked
 1972:     my ($startblock,$endblock) = &Apache::loncommon::blockcheck(\%setters,'com');
 1973:     my @messages=&sortedmessages(\%blocked,$startblock,$endblock,\$numblocked,$folder,$msgstatus);
 1974:     if ( $blocked{$msgid} eq 'ON' ) {
 1975:         &printheader($r,'/adm/email',&mt('Display a Message'));
 1976:         $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.'));
 1977:         &build_block_table($r,$startblock,$endblock,\%setters);
 1978:         return;
 1979:     }
 1980:     if ($msgstatus eq '') {
 1981:         &statuschange($msgid,'read',$folder);
 1982:     }
 1983:     my %message=&Apache::lonnet::get('nohist_email'.$suffix,[$msgid]);
 1984:     my %content=&Apache::lonmsg::unpackagemsg($message{$msgid});
 1985: 
 1986:     my $counter=0;
 1987:     $r->print('<pre>');
 1988:     my $escmsgid=&escape($msgid);
 1989:     foreach (@messages) {
 1990: 	if ($_->[5] eq $escmsgid){
 1991: 	    last;
 1992: 	}
 1993: 	$counter++;
 1994:     }
 1995:     $r->print('</pre>');
 1996:     my $number_of_messages = scalar(@messages); #subtract 1 for last index
 1997: # start output
 1998:     &printheader($r,'/adm/email?display='.&escape($msgid),'Display a Message','',$content{'baseurl'});
 1999:     my %courseinfo=&Apache::lonnet::coursedescription($content{'courseid'});
 2000: # Functions
 2001:     $r->print('<table border="2" width="100%"><tr bgcolor="#FFFFAA"><td>'.&mt('Functions').':</td>'.
 2002: 	      '<td><a href="/adm/email?replyto='.&escape($msgid).$sqs.
 2003: 	      '"><b>'.&mt('Reply').'</b></a></td>'.
 2004: 	      '<td><a href="/adm/email?forward='.&escape($msgid).$sqs.
 2005: 	      '"><b>'.&mt('Forward').'</b></a></td>'.
 2006: 	      '<td><a href="/adm/email?markunread='.&escape($msgid).$sqs.
 2007: 	      '"><b>'.&mt('Mark Unread').'</b></a></td>'.
 2008: 	      '<td><a href="/adm/email?markdel='.&escape($msgid).$sqs.
 2009: 	      '"><b>'.&mt('Delete').'</b></a></td>'.
 2010: 	      '<td><a href="/adm/email?'.$sqs.
 2011: 	      '"><b>'.&mt('Back to Folder Display').'</b></a></td>');
 2012:     if ($counter > 0){
 2013: 	$r->print('<td><a href="/adm/email?display='.$messages[$counter-1]->[5].$sqs.
 2014: 		  '"><b>'.&mt('Previous').'</b></a></td>');
 2015:     }
 2016:     if ($counter < $number_of_messages - 1){
 2017: 	$r->print('<td><a href="/adm/email?display='.$messages[$counter+1]->[5].$sqs.
 2018: 		  '"><b>'.&mt('Next').'</b></a></td>');
 2019:     }
 2020:     $r->print('</tr></table>');
 2021:     my $symb;
 2022:     if (defined($content{'symb'})) {
 2023:         $symb = $content{'symb'};
 2024:     } elsif (defined($content{'baseurl'})) {
 2025:         $symb=&Apache::lonnet::symbread($content{'baseurl'});
 2026:     }
 2027:     if ($env{'user.adv'}) {
 2028: 	$r->print('<table border="2" width="100%"><tr bgcolor="#FFAAAA"><td>'.&mt('Currently available actions (will open extra window)').':</td>');
 2029: 	if (&Apache::lonnet::allowed('vgr',$env{'request.course.id'})) {
 2030: 		$r->print('<td><b>'.&Apache::loncommon::track_student_link(&mt('View recent activity'),$content{'sendername'},$content{'senderdomain'},'check').'</b></td>');
 2031: 	    }
 2032: 	if (&Apache::lonnet::allowed('opa',$env{'request.course.id'}) && $symb) {
 2033: 	    $r->print('<td><b>'.&Apache::loncommon::pprmlink(&mt('Set/Change parameters'),$content{'sendername'},$content{'senderdomain'},$symb,'check').'</b></td>');
 2034: 	}
 2035: 	if (&Apache::lonnet::allowed('mgr',$env{'request.course.id'}) && $symb) {
 2036: 	    $r->print('<td><b>'.&Apache::loncommon::pgrdlink(&mt('Set/Change grades'),$content{'sendername'},$content{'senderdomain'},$symb,'check').'</b></td>');
 2037: 	}
 2038: 	$r->print('</tr></table>');
 2039:     }
 2040:     my $tolist;
 2041:     my @recipients = ();
 2042:     for (my $i=0; $i<@{$content{'recuser'}}; $i++) {
 2043:         $recipients[$i] =  &Apache::loncommon::aboutmewrapper(
 2044:            &Apache::loncommon::plainname($content{'recuser'}[$i],
 2045:                                       $content{'recdomain'}[$i]),
 2046:               $content{'recuser'}[$i],$content{'recdomain'}[$i]).
 2047:        ' ('.$content{'recuser'}[$i].' at '.$content{'recdomain'}[$i].') ';
 2048:     }
 2049:     $tolist = join(', ',@recipients);
 2050:     my ($restitle,$baseurl,$refers_to);
 2051:     if (defined($content{'resource_title'})) {
 2052:         $restitle = $content{'resource_title'};
 2053:     } else {
 2054:         if (defined($content{'baseurl'})) {
 2055:             $restitle = &Apache::lonnet::gettitle($content{'baseurl'});
 2056:         }
 2057:     }
 2058:     if (defined($content{'baseurl'})) {
 2059:         $baseurl = &Apache::lonenc::check_encrypt($content{'baseurl'});
 2060:     }
 2061:     $r->print(&Apache::loncommon::student_image_tag($content{'senderdomain'},$content{'sendername'}));
 2062:     $r->print('<br /><b>'.&mt('Subject').':</b> '.$content{'subject'}.
 2063: 	      ($folder ne 'sent'?'<br /><b>'.&mt('From').':</b> '.
 2064: 	      &Apache::loncommon::aboutmewrapper(
 2065: 						 &Apache::loncommon::plainname($content{'sendername'},$content{'senderdomain'}),
 2066: 						 $content{'sendername'},$content{'senderdomain'}).' ('.
 2067: 	      $content{'sendername'}.' at '.
 2068: 	      $content{'senderdomain'}.') ':'<br /><b>'.&mt('To').':</b> '.
 2069:               $tolist).
 2070: 	      ($content{'courseid'}?'<br /><b>'.&mt($crstype).':</b> '.$courseinfo{'description'}.
 2071: 	       ($content{'coursesec'}?' ('.&mt('Section').': '.$content{'coursesec'}.')':''):'').
 2072: 	      '<br /><b>'.&mt('Time').':</b> '.$content{'time'});
 2073:     if ($baseurl) {
 2074:         if (defined($content{'courseid'}) && defined($env{'request.course.id'})) {
 2075:             if ($content{'courseid'} eq $env{'request.course.id'}) {
 2076:                 my $symblink;
 2077:                 my $showsymb = &Apache::lonenc::check_decrypt($symb);
 2078:                 my $showurl = &Apache::lonenc::check_decrypt($baseurl);
 2079:                 my $encrypturl = &Apache::lonnet::EXT('resource.0.encrypturl',
 2080:                               $showsymb,$env{'user.domain'},$env{'user.name'});
 2081:                 if ($symb) {
 2082:                     if ($encrypturl =~ /^yes$/i && !$env{'request.role.adv'}) {
 2083:                         $showsymb = &Apache::lonenc::check_encrypt($symb);
 2084:                     }
 2085:                     $symblink = '?symb='.$showsymb;
 2086:                 }
 2087:                 if ($encrypturl =~ /^yes$/i && !$env{'request.role.adv'}) {
 2088:                     $showurl = $baseurl;
 2089:                 }
 2090:                 $r->print('<br /><b>'.&mt('Refers to').':</b> <a href="'.$showurl.$symblink.'">'.$restitle.'</a>');
 2091:                 $refers_to = 1;
 2092:             }
 2093:         }
 2094:         if (!$refers_to) {
 2095:             if ($baseurl =~ m-^/enc/-) {
 2096:                 if (defined($content{'courseid'})) {
 2097:                     if (!$env{'request.course.id'}) {
 2098:                         my $unencurl =
 2099:                            &Apache::lonenc::unencrypted($baseurl,
 2100:                                                         $content{'courseid'});
 2101:                         if ($unencurl ne '') {
 2102:                             if (&Apache::lonnet::allowed('bre',$unencurl)) {
 2103:                                 $r->print('<br /><b>'.&mt('Refers to').
 2104:                                           ':</b> <a href="'.$unencurl.'">'.
 2105:                                           $restitle.'</a>');
 2106:                             }
 2107:                         }
 2108:                     }
 2109:                 }
 2110:             } else {
 2111:                 if (&Apache::lonnet::allowed('bre',$baseurl)) {
 2112:                     $r->print('<br /><b>'.&mt('Refers to').
 2113:                               ':</b> <a href="'.$baseurl.
 2114:                               '">'.$restitle.'</a>');
 2115:                 }
 2116:             }
 2117:         }
 2118:     }
 2119:     $r->print('<p><pre>'.
 2120: 	      &Apache::lontexconvert::msgtexconverted($content{'message'},1).
 2121: 	      '</pre><hr />'.&displayresource(%content).'</p>');
 2122:     return;
 2123: }
 2124: 
 2125: # =========================================================== Show the citation
 2126: 
 2127: sub displayresource {
 2128:     my %content=@_;
 2129: #
 2130: # If the recipient is in the same course that the message was sent from and
 2131: # has sufficient privileges, show "all details," else show citation
 2132: #
 2133:     if (($env{'request.course.id'} eq $content{'courseid'})
 2134:      && (&Apache::lonnet::allowed('vgr',$content{'courseid'}))) {
 2135:         my $symb;
 2136:         if (defined($content{'symb'})) {
 2137:             $symb = $content{'symb'};
 2138:         } else { 
 2139: 	    $symb=&Apache::lonnet::symbread($content{'baseurl'});
 2140:         }
 2141: # Could not get a symb, give up
 2142: 	unless ($symb) { return $content{'citation'}; }
 2143: # Have a symb, can render
 2144: 	return '<h2>'.&mt('Current attempts of student (if applicable)').'</h2>'.
 2145: 	    &Apache::loncommon::get_previous_attempt($symb,
 2146: 						     $content{'sendername'},
 2147: 						     $content{'senderdomain'},
 2148: 						     $content{'courseid'}).
 2149: 	    '<hr /><h2>'.&mt('Current screen output (if applicable)').'</h2>'.
 2150: 	    &Apache::loncommon::get_student_view($symb,
 2151: 						 $content{'sendername'},
 2152: 						 $content{'senderdomain'},
 2153: 						 $content{'courseid'}).
 2154: 	    '<h2>'.&mt('Correct Answer(s) (if applicable)').'</h2>'.
 2155: 	    &Apache::loncommon::get_student_answers($symb,
 2156: 						    $content{'sendername'},
 2157: 						    $content{'senderdomain'},
 2158: 						    $content{'courseid'});
 2159:     } elsif ($env{'user.adv'}) {
 2160: 	return $content{'citation'};
 2161:     }
 2162:     return '';
 2163: }
 2164: 
 2165: # ================================================================== The Header
 2166: 
 2167: sub header {
 2168:     my ($r,$title,$baseurl)=@_;
 2169:     
 2170:     my $extra = &Apache::loncommon::studentbrowser_javascript();
 2171:     if ($baseurl) {
 2172: 	$extra .= "<base href=\"".&Apache::lonnet::absolute_url()."/$baseurl\" />";
 2173:     }
 2174:     $r->print(&Apache::loncommon::start_page('Communication and Messages',
 2175:  					$extra));
 2176:     $r->print(&Apache::lonhtmlcommon::breadcrumbs
 2177:      		(($title?$title:'Communication and Messages')));
 2178: }
 2179: 
 2180: # ---------------------------------------------------------------- Print header
 2181: 
 2182: sub printheader {
 2183:     my ($r,$url,$desc,$title,$baseurl)=@_;
 2184:     &Apache::lonhtmlcommon::add_breadcrumb
 2185: 	({href=>$url,
 2186: 	  text=>$desc});
 2187:     &header($r,$title,$baseurl);
 2188: }
 2189: 
 2190: # ------------------------------------------------------------ Store the comment
 2191: 
 2192: sub storecomment {
 2193:     my ($r)=@_;
 2194:     my $msgtxt=&Apache::lonfeedback::clear_out_html($env{'form.message'});
 2195:     my $cleanmsgtxt='';
 2196:     foreach my $line (split(/[\n\r]/,$msgtxt)) {
 2197: 	unless ($line=~/^\s*(\>|\&gt\;)/) {
 2198: 	    $cleanmsgtxt.=$line."\n";
 2199: 	}
 2200:     }
 2201:     my $key=&escape($env{'form.baseurl'}).'___'.time;
 2202:     &Apache::lonnet::put('nohist_stored_comments',{ $key => $cleanmsgtxt });
 2203: }
 2204: 
 2205: sub storedcommentlisting {
 2206:     my ($r)=@_;
 2207:     my %msgs=&Apache::lonnet::dump('nohist_stored_comments',undef,undef,
 2208:        '^'.&escape(&escape($env{'form.showcommentbaseurl'})));
 2209:     $r->print(&Apache::loncommon::start_page('Stored Comment Listing',undef,
 2210: 					     {'onlybody' => 1}));
 2211:     if ((keys %msgs)[0]=~/^error\:/) {
 2212: 	$r->print(&mt('No stored comments yet.'));
 2213:     } else {
 2214: 	my $found=0;
 2215: 	foreach my $key (sort(keys(%msgs))) {
 2216: 	    $r->print("\n".$msgs{$key}."<hr />");
 2217: 	    $found=1;
 2218: 	}
 2219: 	unless ($found) {
 2220: 	    $r->print(&mt('No stored comments yet for this resource.'));
 2221: 	}
 2222:     }
 2223: }
 2224: 
 2225: # ---------------------------------------------------------------- Send an email
 2226: 
 2227: sub sendoffmail {
 2228:     my ($r,$folder)=@_;
 2229:     my $suffix=&Apache::lonmsg::foldersuffix($folder);
 2230:     my $sendstatus='';
 2231:     my %specialmsg_status;
 2232:     my $numspecial = 0;
 2233:     my ($cdom,$cnum,$group);
 2234:     if (exists($env{'form.group'})) {
 2235:         $group = $env{'form.group'};
 2236:     }
 2237:     if (exists($env{'request.course.id'})) {
 2238:         $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
 2239:         $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
 2240:     }
 2241:     if ($env{'form.send'}) {
 2242:         if (!$env{'form.multiforward'}) { 
 2243:             if ($group eq '') {
 2244: 	        &printheader($r,'','Messages being sent.');
 2245:             } else {
 2246:                 $r->print(&groupmail_header('sending',$group));
 2247:             }
 2248:         }
 2249: 	$r->rflush();
 2250: 	my %content=();
 2251: 	undef %content;
 2252: 	if ($env{'form.forwid'}) {
 2253: 	    my $msgid=$env{'form.forwid'};
 2254: 	    my %message=&Apache::lonnet::get('nohist_email'.$suffix,[$msgid]);
 2255: 	    %content=&Apache::lonmsg::unpackagemsg($message{$msgid},1);
 2256: 	    &statuschange($msgid,'forwarded',$folder);
 2257: 	    $env{'form.message'}.="\n\n-- Forwarded message --\n\n".
 2258: 		$content{'message'};
 2259: 	}
 2260: 	if ($env{'form.replyid'}) {
 2261: 	    my $msgid=$env{'form.replyid'};
 2262: 	    my %message=&Apache::lonnet::get('nohist_email'.$suffix,[$msgid]);
 2263: 	    %content=&Apache::lonmsg::unpackagemsg($message{$msgid},1);
 2264: 	    &statuschange($msgid,'replied',$folder);
 2265: 	}
 2266: 
 2267: 	my @to =
 2268: 	    &Apache::loncommon::get_env_multiple('form.selectedusers_forminput');
 2269: 	my $mode = $env{'form.sendmode'};
 2270: 
 2271: 	my %toaddr;
 2272: 	if (@to) {
 2273: 	    foreach my $dest (@to) {
 2274: 		my ($user,$domain) = split(/:/, $dest);
 2275: 		if (($user ne '') && ($domain ne '')) {
 2276: 		    my $address = $user.":".$domain; # How the code below expects it.
 2277: 		    $toaddr{$address} = '';
 2278: 		}
 2279: 	    }
 2280: 	}
 2281: 
 2282: 	if ($env{'form.sendmode'} eq 'group') {
 2283: 	     foreach my $address (keys(%env)) {
 2284: 	 	if ($address=~/^form\.send\_to\_\&\&\&[^\&]*\&\&\&\_(.+)$/) {
 2285: 	 	    $toaddr{$1}='';
 2286: 	 	}
 2287: 	    }
 2288: 	} elsif ($env{'form.sendmode'} eq 'upload') {
 2289: 	    foreach my $line (split(/[\n\r\f]+/,$env{'form.upfile'})) {
 2290:                 my ($rec,$txt) = ($line =~ /^([^:]+:[^:]+):(.*)$/);
 2291: 		if ($txt) {
 2292:                     $rec =~ s/^\s+//;
 2293:                     $rec =~ s/\s+$//;
 2294: 		    $toaddr{$rec}.=$txt."\n";
 2295: 		}
 2296: 	    }
 2297: 	} else {
 2298: 	    if (($env{'form.recuname'} ne '') && ($env{'form.recdomain'} ne '')) {
 2299: 		$toaddr{$env{'form.recuname'}.':'.$env{'form.recdomain'}}='';
 2300: 	    }
 2301: 	}
 2302: 	if ($env{'form.additionalrec'}) {
 2303: 	    foreach my $rec (split(/\s*,\s*/,$env{'form.additionalrec'})) {
 2304: 		my ($auname,$audom)=split(/:/,$rec);
 2305: 		if (($auname ne "") && ($audom ne "")) {
 2306: 		    $toaddr{$auname.':'.$audom}='';
 2307: 		}
 2308: 	    }
 2309: 	}
 2310: 
 2311:         my $savemsg;
 2312:         my $msgtype;
 2313:         my %sentmessage;
 2314:         my $msgsubj=&Apache::lonfeedback::clear_out_html($env{'form.subject'},
 2315: 							 undef,1);
 2316:         if ((($env{'form.critmsg'}) || ($env{'form.sendbck'})) &&
 2317:             (&Apache::lonnet::allowed('srm',$env{'request.course.id'})
 2318: 	     || &Apache::lonnet::allowed('srm',$env{'request.course.id'}.
 2319: 					 '/'.$env{'request.course.sec'})
 2320: 	     )) {
 2321:             $savemsg=&Apache::lonfeedback::clear_out_html($env{'form.message'},1);
 2322:             $msgtype = 'critical';
 2323:         } else {
 2324:             $savemsg=&Apache::lonfeedback::clear_out_html($env{'form.message'});
 2325:         }
 2326: 	
 2327: 	foreach my $address (sort(keys(%toaddr))) {
 2328: 	    my ($recuname,$recdomain)=split(/\:/,$address);
 2329:             my $msgtxt = $savemsg;
 2330: 	    if ($toaddr{$address}) { $msgtxt.='<hr />'.$toaddr{$address}; }
 2331: 	    my @thismsg;
 2332: 	    if ($msgtype eq 'critical') {
 2333: 		$r->print(&mt('Sending critical message').' '.
 2334:                               $recuname.':'.$recdomain.': ');
 2335: 		@thismsg=
 2336: 		    &Apache::lonmsg::user_crit_msg($recuname,$recdomain,
 2337: 						   $msgsubj,$msgtxt,
 2338: 						   $env{'form.sendbck'},
 2339: 						   $env{'form.permanent'},
 2340: 						   \$sentmessage{$address});
 2341: 	    } else {
 2342: 		$r->print(&mt('Sending').' '.$recuname.':'.$recdomain.': ');
 2343: 		@thismsg=
 2344: 		    &Apache::lonmsg::user_normal_msg($recuname,$recdomain,
 2345: 						     $msgsubj,$msgtxt,
 2346: 						     $content{'citation'},
 2347: 						     undef,undef,
 2348: 						     $env{'form.permanent'},
 2349: 						     \$sentmessage{$address});
 2350:             }
 2351: 	    if (($env{'request.course.id'}) && 
 2352:                 (($msgtype eq 'critical') || 
 2353:                  ($env{'form.sendmode'} eq 'group') ||
 2354:                  ($env{'form.courserecord'}))) {
 2355: 	        $specialmsg_status{$recuname.':'.$recdomain} =
 2356: 		    join(' ',@thismsg);
 2357: 		foreach my $result (@thismsg) {
 2358: 		    if ($result eq 'ok' || $result eq 'con_delayed') {
 2359: 			$numspecial++;
 2360: 		    }
 2361: 		}
 2362: 	    }
 2363: 	    $sendstatus.=' '.join(' ',@thismsg);
 2364: 	}
 2365:         if (($env{'request.course.id'}) && 
 2366:             (($env{'form.sendmode'} eq 'group') ||
 2367:              ($env{'form.courserecord'}) ||
 2368:              ($msgtype eq 'critical'))) {
 2369:             my $subj_prefix;
 2370:             if ($msgtype eq 'critical') {
 2371:                 $subj_prefix = 'Critical.';
 2372:             } elsif ($env{'form.sendmode'} eq 'group') {
 2373:                 $subj_prefix = 'Broadcast.';
 2374:             } else {
 2375:                 $subj_prefix = 'Archive';
 2376:             }
 2377:             my ($specialmsgid,$specialresult);
 2378:             my $course_str = &escape('['.$cnum.':'.$cdom.']');
 2379: 
 2380:             if ($numspecial) {
 2381:                 $specialresult = &Apache::lonmsg::user_normal_msg_raw($cnum,$cdom,$subj_prefix.
 2382:                     ' '.$course_str,$savemsg,undef,undef,undef,
 2383:                     undef,undef,\$specialmsgid);
 2384:                 $specialmsgid = &unescape($specialmsgid);
 2385:             }
 2386:             if ($specialresult eq 'ok') {
 2387:                 my $record_sent;
 2388:                 my @recusers;
 2389:                 my @recudoms;
 2390:                 my ($stamp,$crssubj,$msgname,$msgdom,$msgcount,$context,$pid) =
 2391: 		    split(/\:/,&unescape($specialmsgid));
 2392: 
 2393:                 foreach my $recipient (sort(keys(%toaddr))) {
 2394:                     if ($specialmsg_status{$recipient} =~ /\s*(ok|con_delayed)\s*/) {
 2395:                         my $usersubj = $subj_prefix.'['.$recipient.']';
 2396:                         my $usermsgid = 
 2397: 			    &Apache::lonmsg::buildmsgid($stamp,$usersubj,
 2398: 							$msgname,$msgdom,
 2399: 							$msgcount,$context,
 2400: 							$pid);
 2401:                         &Apache::lonmsg::user_normal_msg_raw($cnum,$cdom,$subj_prefix.
 2402:                                              ' ['.$recipient.']',$msgsubj,undef,
 2403:                         undef,undef,undef,$usermsgid,undef,undef,$specialmsgid);
 2404:                         my ($uname,$udom) = split(/:/,$recipient);
 2405:                         push(@recusers,$uname);
 2406:                         push(@recudoms,$udom);
 2407:                     }
 2408:                 }
 2409:                 if (@recusers) {
 2410:                     my $specialmessage;
 2411:                     my $sentsubj = 
 2412: 			$subj_prefix.' ('.$numspecial.' sent) '.$msgsubj;
 2413:                     $sentsubj = &HTML::Entities::encode($sentsubj,'<>&"');
 2414:                     my $sentmsgid = 
 2415: 			&Apache::lonmsg::buildmsgid($stamp,$sentsubj,$msgname,
 2416: 						    $msgdom,$msgcount,$context,
 2417: 						    $pid);
 2418:                     ($specialmsgid,$specialmessage) = &Apache::lonmsg::packagemsg($msgsubj,$savemsg,
 2419:                             undef,undef,undef,\@recusers,\@recudoms,$sentmsgid);
 2420:                     $record_sent = &Apache::lonmsg::store_sent_mail($specialmsgid,$specialmessage);
 2421:                 }
 2422:             } else {
 2423:                 &Apache::lonnet::logthis('Failed to create record of critical message or broadcast in '.$env{'course.'.$env{'request.course.id'}.'.num'}.' at '.$env{'course.'.$env{'request.course.id'}.'.domain'}.' - no msgid generated');
 2424:             }
 2425:         }
 2426:     } else {
 2427: 	&printheader($r,'','No messages sent.'); 
 2428:     }
 2429:     if (!$env{'form.multiforward'}) { 
 2430:         if ($sendstatus=~/^(\s*(?:ok|con_delayed)\s*)*$/) {
 2431: 	    $r->print('<br /><span class="LC_success">'.&mt('Completed.').
 2432:                       '</span>');
 2433: 	    if ($env{'form.displayedcrit'}) {
 2434: 	        &discrit($r);
 2435:             }
 2436:             if ($group ne '') {
 2437:                 $r->print(&groupmail_sent($group,$cdom,$cnum)); 
 2438: 	    } else {
 2439: 	        &Apache::loncommunicate::menu($r);
 2440: 	    }
 2441:         } else {
 2442: 	    $r->print('<p><span class="LC_error">'.&mt('Could not deliver message').'</span> '.
 2443: 		  &mt('Please use the browser "Back" button and correct the recipient addresses '."($sendstatus)").'</p>');
 2444:         }
 2445:     }
 2446:     return $sendstatus;
 2447: }
 2448: 
 2449: # ===================================================================== Handler
 2450: 
 2451: sub handler {
 2452:     my $r=shift;
 2453: 
 2454: # ----------------------------------------------------------- Set document type
 2455:     
 2456:     &Apache::loncommon::content_type($r,'text/html');
 2457:     $r->send_http_header;
 2458:     
 2459:     return OK if $r->header_only;
 2460:     
 2461: # --------------------------- Get query string for limited number of parameters
 2462:     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
 2463:         ['display','replyto','forward','markread','markdel','markunread',
 2464:          'sendreply','compose','sendmail','critical','recname','recdom',
 2465:          'recordftf','sortedby','block','folder','startdis','interdis',
 2466: 	 'showcommentbaseurl','dismode','group','subject','text','ref',
 2467:          'msgstatus']);
 2468:     $sqs='&sortedby='.$env{'form.sortedby'};
 2469: 
 2470: # ------------------------------------------------------ They checked for email
 2471:     unless ($env{'form.block'}) {
 2472:         &Apache::lonnet::put('email_status',{'recnewemail'=>0});
 2473:     }
 2474: 
 2475: # ----------------------------------------------------------------- Breadcrumbs
 2476: 
 2477:     &Apache::lonhtmlcommon::clear_breadcrumbs();
 2478:     &Apache::lonhtmlcommon::add_breadcrumb
 2479:         ({href=>"/adm/communicate",
 2480:           text=>"Communication/Messages",
 2481:           faq=>12,bug=>'Communication Tools',});
 2482: 
 2483: # ------------------------------------------------------------------ Get Folder
 2484: 
 2485:     my $folder=$env{'form.folder'};
 2486:     unless ($folder) { 
 2487: 	$folder=''; 
 2488:     } else {
 2489: 	$sqs.='&folder='.&escape($folder);
 2490:     }
 2491: # ------------------------------------------------------------ Get Display Mode
 2492: 
 2493:     my $dismode=$env{'form.dismode'};
 2494:     unless ($dismode) { 
 2495: 	$dismode=''; 
 2496:     } else {
 2497: 	$sqs.='&amp;dismode='.&escape($dismode);
 2498:     }
 2499: 
 2500: # --------------------------------------------------------------------- Display
 2501:     my $msgstatus = $env{'form.msgstatus'};
 2502:     $startdis=$env{'form.startdis'};
 2503:     if ($startdis ne '') {
 2504:         $startdis--;
 2505:     }
 2506:     unless ($startdis) { $startdis=0; }
 2507: 
 2508:     if ($env{'form.firstview'}) {
 2509: 	$startdis=0;
 2510:     }
 2511:     if ($env{'form.lastview'}) {
 2512: 	$startdis=-1;
 2513:     }
 2514:     if ($env{'form.prevview'}) {
 2515: 	$startdis--;
 2516:     }
 2517:     if ($env{'form.nextview'}) {
 2518: 	$startdis++;
 2519:     }
 2520:     my $postedstartdis=$startdis+1;
 2521:     $sqs.='&startdis='.$postedstartdis;
 2522: 
 2523: # --------------------------------------------------------------- Render Output
 2524: 
 2525:     if ($env{'form.display'}) {
 2526: 	&displaymessage($r,$env{'form.display'},$folder,$msgstatus);
 2527:     } elsif ($env{'form.replyto'}) {
 2528: 	&compout($r,'',$env{'form.replyto'},undef,undef,$folder,$dismode);
 2529:     } elsif ($env{'form.confirm'}) {
 2530: 	&printheader($r,'','Confirmed Receipt');
 2531: 	my $replying = 0;
 2532: 	foreach my $envkey (keys(%env)) {
 2533: 	    if ($envkey=~/^form\.rec\_(.*)$/) {
 2534: 		$r->print('<b>'.&mt('Confirming Receipt').':</b> '.
 2535: 			  &Apache::lonmsg::user_crit_received($1).'<br>');
 2536: 	    }
 2537: 	    if ($envkey=~/^form\.reprec\_(.*)$/) {
 2538: 		my $msgid=$1;
 2539: 		$r->print('<b>'.&mt('Confirming Receipt').':</b> '.
 2540: 			  &Apache::lonmsg::user_crit_received($msgid).'<br>');
 2541: 		&compout($r,'','','',$msgid);
 2542: 		$replying = 1;
 2543: 	    }
 2544: 	}
 2545: 	if (!$replying) {
 2546: 	    &discrit($r);
 2547: 	}
 2548:     } elsif ($env{'form.critical'}) {
 2549: 	&printheader($r,'','Displaying Critical Messages');
 2550: 	&discrit($r);
 2551:     } elsif ($env{'form.forward'}) {
 2552: 	&compout($r,$env{'form.forward'},undef,undef,undef,$folder);
 2553:     } elsif ($env{'form.markdel'}) {
 2554: 	&printheader($r,'','Deleted Message');
 2555: 	my ($result,$msg) = 
 2556: 	    &statuschange($env{'form.markdel'},'deleted',$folder);
 2557: 	if (!$result) {
 2558: 	    $r->print('<p class="LC_error">'.
 2559: 		      &mt('Failed to delete the message.').'</p>'.
 2560: 		      '<p class="LC_error">'.$msg."</p>\n");
 2561: 	}
 2562: 	&Apache::loncommunicate::menu($r);
 2563: 	&disall($r,($folder?$folder:$dismode),$msgstatus);
 2564:     } elsif ($env{'form.markedaction'} eq 'markedforward') {
 2565:         my $total = 0;
 2566:         my @to_forward = &Apache::loncommon::get_env_multiple('form.delmark');
 2567:         foreach my $msgid (@to_forward) {
 2568:             &statuschange(&unescape($msgid),'forwarded',$folder);
 2569:             $total ++;
 2570:         }
 2571:         if ($total > 0) {
 2572:             &compout($r,undef,undef,undef,undef,$folder,$dismode,$total);
 2573:         }
 2574:     } elsif ($env{'form.markedaction'} eq 'markedread') {
 2575:         my $total = 0;
 2576:         my @to_markread = &Apache::loncommon::get_env_multiple('form.delmark');
 2577:         foreach my $msgid (@to_markread) {
 2578:             &statuschange(&unescape($msgid),'read',$folder);
 2579:             $total ++;
 2580:         }
 2581:         &printheader($r,'','Marked Messages Read');
 2582:         $r->print(&mt('Marked [_1] message(s) read',$total).'<p>');
 2583:         &Apache::loncommunicate::menu($r);
 2584:         &disall($r,($folder?$folder:$dismode),$msgstatus);
 2585:     } elsif ($env{'form.markedaction'} eq 'markedunread') {
 2586:         my $total = 0;
 2587:         my @to_markunread = &Apache::loncommon::get_env_multiple('form.delmark');
 2588:         foreach my $msgid (@to_markunread) {
 2589:             &statuschange(&unescape($msgid),'new',$folder);
 2590:             $total ++;
 2591:         }
 2592:         &printheader($r,'','Marked Messages Unread');
 2593:         $r->print(&mt('Marked [_1] message(s) unread',$total).'<p>');
 2594:         &Apache::loncommunicate::menu($r);
 2595:         &disall($r,($folder?$folder:$dismode),$msgstatus);
 2596:     } elsif ($env{'form.markedaction'} eq 'markedmove') {
 2597:         my $destfolder = $env{'form.movetofolder'};
 2598:         my %gotfolders = &Apache::lonmsg::get_user_folders();
 2599:         &printheader($r,'','Moved Messages');
 2600:         if (!defined($gotfolders{$destfolder})) {
 2601:             $r->print(&mt('Destination folder [_1] is not a valid folder',
 2602:                       $destfolder));
 2603:         } else {
 2604: 	    my ($total,$failed,@failed_msg)=(0,0);
 2605:             my @to_move = &Apache::loncommon::get_env_multiple('form.delmark');
 2606:             foreach my $msgid (@to_move) {
 2607: 	        my ($result,$msg) = &movemsg(&unescape($msgid),$folder,
 2608: 			                     $env{'form.movetofolder'});
 2609: 	        if ($result) {
 2610: 		    $total++;
 2611: 	        } else {
 2612: 		    $failed++;
 2613: 		    push(@failed_msg,$msg);
 2614: 	        }
 2615: 	    }
 2616: 	    if ($failed) {
 2617: 	        $r->print('<p class="LC_error">
 2618:                           '.&mt('Failed to move [_1] message(s)',$failed).
 2619: 		      '</p>');
 2620: 	        $r->print('<p class="LC_error">'.
 2621: 	   	          join("</p>\n<p class=\"LC_error\">",@failed_msg).
 2622: 		          "</p>\n");
 2623: 	    }
 2624: 	    $r->print(&mt('Moved [_1] message(s)',$total).'<p>');
 2625:         }
 2626: 	&Apache::loncommunicate::menu($r);
 2627: 	&disall($r,($folder?$folder:$dismode),$msgstatus);
 2628:     } elsif ($env{'form.markedaction'} eq 'markeddel') {
 2629: 	my ($total,$failed,@failed_msg)=(0,0);
 2630:         my @to_delete = &Apache::loncommon::get_env_multiple('form.delmark');
 2631:         foreach my $msgid (@to_delete) {
 2632: 	    my ($result,$msg) = &statuschange(&unescape($msgid),'deleted', 
 2633: 				              $folder);
 2634: 	    if ($result) {
 2635: 	        $total++;
 2636: 	    } else {
 2637: 	        $failed++;
 2638: 		push(@failed_msg,$msg);
 2639: 	    }
 2640: 	}
 2641: 	&printheader($r,'','Deleted Messages');
 2642: 	if ($failed) {
 2643: 	    $r->print('<p class="LC_error">
 2644:                           '.&mt('Failed to delete [_1] message(s)',$failed).
 2645: 		      '</p>');
 2646: 	    $r->print('<p class="LC_error">'.
 2647: 		      join("</p>\n<p class=\"LC_error\">",@failed_msg).
 2648: 		      "</p>\n");
 2649: 	}
 2650: 	$r->print(&mt('Deleted [_1] message(s)',$total).'<p>');
 2651: 	&Apache::loncommunicate::menu($r);
 2652: 	&disall($r,($folder?$folder:$dismode),$msgstatus);
 2653:     } elsif ($env{'form.markunread'}) {
 2654: 	&printheader($r,'','Marked Message as Unread');
 2655: 	&statuschange($env{'form.markunread'},'new');
 2656: 	&Apache::loncommunicate::menu($r);
 2657: 	&disall($r,($folder?$folder:$dismode),$msgstatus);
 2658:     } elsif ($env{'form.compose'}) {
 2659: 	&compout($r,'','',$env{'form.compose'});
 2660:     } elsif ($env{'form.recordftf'}) {
 2661: 	&facetoface($r,$env{'form.recordftf'});
 2662:     } elsif ($env{'form.block'}) {
 2663:         &examblock($r,$env{'form.block'});
 2664:     } elsif ($env{'form.sendmail'}) {
 2665:         if ($env{'form.multiforward'}) {
 2666:             &printheader($r,'','Messages being sent.');
 2667:             my $fixed_subj = $env{'form.subject'};
 2668:             my $suffix=&Apache::lonmsg::foldersuffix($folder);
 2669:             my (%sendresult,%forwardok,%forwardfail,$fwdcount);
 2670:             my @to_forward = &Apache::loncommon::get_env_multiple('form.delmark');
 2671:             foreach my $item (@to_forward) {
 2672:                 my $msgid=&unescape($item);
 2673:                 my %message=&Apache::lonnet::get('nohist_email'.$suffix,[$msgid]);
 2674:                 my %content=&Apache::lonmsg::unpackagemsg($message{$msgid},1);
 2675:                 if ($env{'form.showorigsubj'}) {
 2676:                     $env{'form.subject'} = $fixed_subj.$content{'subject'};
 2677:                 } else {
 2678:                     $env{'form.subject'} = '';
 2679:                 }
 2680:                 my $uname = $content{'sendername'};
 2681:                 my $udom = $content{'senderdomain'};
 2682:                 &statuschange($msgid,'forwarded',$folder);
 2683:                 if ($env{'form.showorigsender'}) {
 2684:                     $env{'form.message'} = $env{'form.msgheader'}.' '.
 2685:                         &Apache::loncommon::plainname($uname,$udom).' ('.
 2686:                                            $uname.':'.$udom.')';
 2687:                 }
 2688:                 $env{'form.message'} .= "\n\n-- Forwarded message --\n\n".
 2689:                                         $content{'message'};
 2690:                 $fwdcount ++;
 2691:                 $r->print($fwdcount.': '); 
 2692:                 $sendresult{$msgid} = &sendoffmail($r,$folder);
 2693:                 $r->print('<br />');
 2694:             }
 2695:             foreach my $key (keys(%sendresult)) {
 2696:                 if ($sendresult{$key} =~/^(\s*(?:ok|con_delayed)\s*)*$/) {
 2697:                     $forwardok{$key} = $sendresult{$key};
 2698:                 } else {
 2699:                     $forwardfail{$key} = $sendresult{$key}; 
 2700:                 }
 2701:             }
 2702:             if (keys(%forwardok) > 0) {
 2703:                 my $count = keys(%forwardok);
 2704:                 $r->print('<br /><span class="LC_success">'.
 2705:                           &mt('[quant,_1,message] forwarded.',$count).
 2706:                           '</span>');
 2707:             }
 2708:             if (keys(%forwardfail) > 0) {
 2709:                 my $count = keys(%forwardfail);
 2710:                 $r->print('<p><span class="LC_error">'.
 2711:                           &mt('Could not forward [quant,_1,message].',$count).
 2712:                           '</span> ');
 2713:                 foreach my $key (keys(%forwardfail)) {
 2714:                     $r->print(&mt('Could not deliver forwarded message.').'</span> '.
 2715:                               &mt('The recipient addresses may need to be corrected').' ('.$forwardfail{$key}.').<br /><br />');
 2716:                 }
 2717:             }
 2718:             &Apache::loncommunicate::menu($r);
 2719:         } else {
 2720: 	    &sendoffmail($r,$folder);
 2721:         }
 2722: 	if ($env{'form.storebasecomment'}) {
 2723: 	    &storecomment($r);
 2724:         }
 2725: 	if (($env{'form.rsspost'}) && ($env{'request.course.id'})) {
 2726: 	        &Apache::lonrss::addentry($env{'course.'.$env{'request.course.id'}.'.num'},
 2727: 				      $env{'course.'.$env{'request.course.id'}.'.domain'},
 2728: 				      'Course_Announcements',
 2729: 				      $env{'form.subject'},
 2730: 				      $env{'form.message'},'/adm/communicate','public');
 2731: 	}
 2732: 	if ((!exists($env{'form.group'})) && (!$env{'form.displayedcrit'})) {
 2733: 	    &disall($r,($folder?$folder:$dismode),$msgstatus);
 2734: 	}
 2735:     } elsif ($env{'form.newfolder'}) {
 2736: 	&printheader($r,'','New Folder');
 2737:         my $showfolder = $env{'form.newfolder'};
 2738: 	my ($makeresult,$warning) = &makefolder($env{'form.newfolder'});
 2739:         if ($makeresult eq 'ok') {
 2740:             $r->print(&mt('Mail folder "[_1]" created.',$showfolder).'<br />');
 2741:         } else {
 2742:             $r->print(&mt('Creation failed.').' '.$makeresult.'<br />'.
 2743:                       $warning);
 2744:             $showfolder = $folder;
 2745:         }
 2746:         &Apache::loncommunicate::menu($r);
 2747: 	&disall($r,$showfolder,$msgstatus);
 2748:     } elsif ($env{'form.showcommentbaseurl'}) {
 2749: 	&storedcommentlisting($r);
 2750:     } elsif ($env{'form.folderaction'} eq 'delete') {
 2751:         &printheader($r,'','Deleted Folder');
 2752:         my $showfolder = '';
 2753:         my $delresult = &deletefolder($folder);
 2754:         if ($delresult eq 'ok') {
 2755:             $r->print(&mt('Mail folder "[_1]" deleted.',$folder).'<br />');
 2756:             $env{'form.folder'} = '';
 2757:         } else {
 2758:             $r->print(&mt('Deletion failed.').' '.$delresult.'<br />');
 2759:             $showfolder = $folder;
 2760:         }
 2761:         &Apache::loncommunicate::menu($r);
 2762:         &disall($r,$showfolder,$msgstatus);
 2763:     } elsif ($env{'form.folderaction'} eq 'rename') {
 2764:         &printheader($r,'','Renamed Folder');
 2765:         my $showfolder = $env{'form.renamed'};
 2766:         my $renresult = &renamefolder($folder);
 2767:         if ($renresult eq 'ok') {
 2768:             $r->print(&mt('Mail folder "[_1]" renamed "[_2]".',$folder,$showfolder).'<br />');
 2769:         } else {
 2770:             $r->print(&mt('Renaming failed.').' '.$renresult.'<br />');
 2771:             $showfolder = $folder;
 2772:         }
 2773:         &Apache::loncommunicate::menu($r);
 2774:         &disall($r,$showfolder,$msgstatus);
 2775:     } else {
 2776: 	&printheader($r,'','Display All Messages');
 2777: 	&Apache::loncommunicate::menu($r);
 2778: 	&disall($r,($folder?$folder:$dismode),$msgstatus);
 2779:     }
 2780:     $r->print(&Apache::loncommon::end_page());
 2781:     return OK;
 2782: }
 2783: # ================================================= Main program, reset counter
 2784: 
 2785: =pod
 2786: 
 2787: =cut
 2788: 
 2789: 1; 
 2790: 
 2791: __END__
 2792: 

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