version 1.59, 2006/12/24 22:13:19
|
version 1.69, 2007/04/22 02:25:36
|
Line 33 package Apache::lonmsgdisplay;
|
Line 33 package Apache::lonmsgdisplay;
|
|
|
=head1 NAME |
=head1 NAME |
|
|
Apache::lonmsg: supports internal messaging |
Apache::lonmsgdisplay: supports internal messaging |
|
|
=head1 SYNOPSIS |
=head1 SYNOPSIS |
|
|
lonmsg provides routines for sending messages, receiving messages, and |
lonmsgdisplay provides a handler to allow users to read, send, |
a handler to allow users to read, send, and delete messages. |
and delete messages, and to create and delete message folders, |
|
and to move messages between folders. |
|
|
=head1 OVERVIEW |
=head1 OVERVIEW |
|
|
Line 93 addresses on their B<PREF> screen, but g
|
Line 94 addresses on their B<PREF> screen, but g
|
are much more useful than traditional email can be made to be, even |
are much more useful than traditional email can be made to be, even |
with HTML support. |
with HTML support. |
|
|
Right now, this document will cover just how to send a message, since |
|
it is likely you will not need to programmatically read messages, |
|
since lonmsg already implements that functionality. |
|
|
|
The routines used to package messages and unpackage messages are not |
|
only used by lonmsg when creating/extracting messages for LON-CAPA's |
|
internal messaging system, but also by lonnotify.pm which is available |
|
for use by Domain Coordinators to broadcast standard e-mail to specified |
|
users in their domain. The XML packaging used in the two cases is very |
|
similar. The differences are the use of <recuser>$uname</recuser> and |
|
<recdomain>$udom</recdomain> in stored internal messages, compared |
|
with <recipient username="$uname:$udom">$email</recipient> in stored |
|
Domain Coordinator e-mail for the storage of information about |
|
recipients of the message/e-mail. |
|
|
|
=head1 FUNCTIONS |
|
|
|
=over 4 |
|
|
|
=cut |
=cut |
|
|
use strict; |
use strict; |
Line 119 use Apache::lonnet;
|
Line 101 use Apache::lonnet;
|
use HTML::TokeParser(); |
use HTML::TokeParser(); |
use Apache::Constants qw(:common); |
use Apache::Constants qw(:common); |
use Apache::loncommon(); |
use Apache::loncommon(); |
|
use Apache::lonhtmlcommon(); |
use Apache::lontexconvert(); |
use Apache::lontexconvert(); |
use HTML::Entities(); |
use HTML::Entities(); |
use Apache::lonlocal; |
use Apache::lonlocal; |
Line 924 sub disfolder {
|
Line 907 sub disfolder {
|
nome => 'No messages have been selected to apply ths action to.', |
nome => 'No messages have been selected to apply ths action to.', |
chec => 'Check the checkbox for at least one message.', |
chec => 'Check the checkbox for at least one message.', |
); |
); |
|
my $jscript = &Apache::loncommon::check_uncheck_jscript(); |
$r->print(<<ENDDISHEADER); |
$r->print(<<ENDDISHEADER); |
<script type="text/javascript"> |
<script type="text/javascript"> |
function checkall() { |
$jscript |
for (i=0; i<document.forms.disall.delmark.length; i++) { |
|
document.forms.disall.delmark[i].checked=true; |
|
} |
|
} |
|
|
|
function uncheckall() { |
|
for (i=0; i<document.forms.disall.delmark.length; i++) { |
|
document.forms.disall.delmark[i].checked=false; |
|
} |
|
} |
|
function checkfoldermove() { |
function checkfoldermove() { |
if (document.disall.checkedaction.options[document.disall.checkedaction.selectedIndex].value == 'markedmove') { |
if (document.disall.checkedaction.options[document.disall.checkedaction.selectedIndex].value == 'markedmove') { |
if (document.disall.movetofolder.options[document.disall.movetofolder.selectedIndex].value == "") { |
if (document.disall.movetofolder.options[document.disall.movetofolder.selectedIndex].value == "") { |
Line 956 sub disfolder {
|
Line 931 sub disfolder {
|
} |
} |
} |
} |
var checktotal = 0; |
var checktotal = 0; |
for (var i=0; i<document.forms.disall.delmark.length; i++) { |
if (document.forms.disall.delmark.length > 0) { |
if (document.forms.disall.delmark[i].checked) { |
for (var i=0; i<document.forms.disall.delmark.length; i++) { |
|
if (document.forms.disall.delmark[i].checked) { |
|
checktotal ++; |
|
} |
|
} |
|
} else { |
|
if (document.forms.disall.delmark.checked) { |
checktotal ++; |
checktotal ++; |
} |
} |
} |
} |
if (checktotal == 0) { |
if (checktotal == 0) { |
alert("$lt{'nome'}\\n$lt{'chec'}"); |
alert("$lt{'nome'}\\n$lt{'chec'}"); |
return; |
return; |
Line 982 ENDDISHEADER
|
Line 963 ENDDISHEADER
|
} else { |
} else { |
$r->print('<h2>'.&mt('There are no '.lc($statushash{$msgstatus}).' messages in this folder.').'</h2>'); |
$r->print('<h2>'.&mt('There are no '.lc($statushash{$msgstatus}).' messages in this folder.').'</h2>'); |
} |
} |
|
if ($numblocked > 0) { |
|
$r->print(&blocked_in_folder($numblocked,$startblock,$endblock, |
|
\%setters)); |
|
} |
return; |
return; |
} |
} |
my $interdis = $env{'form.interdis'}; |
my $interdis = $env{'form.interdis'}; |
Line 1052 ENDDISHEADER
|
Line 1037 ENDDISHEADER
|
} |
} |
my ($dis_name,$dis_domain) = ($fromname,$fromdomain); |
my ($dis_name,$dis_domain) = ($fromname,$fromdomain); |
if ($folder eq 'sent') { |
if ($folder eq 'sent') { |
if (defined($recv_name) && !defined($recv_domain)) { |
if (defined($recv_name) && defined($recv_domain)) { |
$dis_name = join('<br />',@{$recv_name}); |
if (ref($recv_name) eq 'ARRAY' && |
$dis_domain = join('<br />',@{$recv_domain}); |
ref($recv_domain) eq 'ARRAY') { |
|
$dis_name = join('<br />',@{$recv_name}); |
|
$dis_domain = join('<br />',@{$recv_domain}); |
|
} |
} else { |
} else { |
my $msg_id = &unescape($origID); |
my $msg_id = &unescape($origID); |
my %message = &Apache::lonnet::get('nohist_email'.$suffix, |
my %message = &Apache::lonnet::get('nohist_email'.$suffix, |
[$msg_id]); |
[$msg_id]); |
my %content = &Apache::lonmsg::unpackagemsg($message{$msg_id}); |
my %content = &Apache::lonmsg::unpackagemsg($message{$msg_id}); |
$dis_name = join('<br />',@{$content{'recuser'}}); |
if (ref($content{'recuser'}) eq 'ARRAY') { |
$dis_domain = join('<br />',@{$content{'recdomain'}}); |
$dis_name = join('<br />',@{$content{'recuser'}}); |
|
} |
|
if (ref($content{'recdomain'}) eq 'ARRAY') { |
|
$dis_domain = join('<br />',@{$content{'recdomain'}}); |
|
} |
} |
} |
} |
} |
my $localsenttime = &Apache::lonlocal::locallocaltime($sendtime); |
my $localsenttime = &Apache::lonlocal::locallocaltime($sendtime); |
Line 1072 ENDDISHEADER
|
Line 1064 ENDDISHEADER
|
' value="'.$origID.'" /></nobr></td>'); |
' value="'.$origID.'" /></nobr></td>'); |
foreach my $item ($localsenttime,$dis_name,$dis_domain,$shortsubj) { |
foreach my $item ($localsenttime,$dis_name,$dis_domain,$shortsubj) { |
$r->print('<td>'.(($status eq 'new')?'<b>':''). |
$r->print('<td>'.(($status eq 'new')?'<b>':''). |
'<a href="/adm/email?display='.$origID.$sqs.$fsqs.'">'. |
'<a href="/adm/email?display='.$origID.$sqs.'">'. |
$item.(($status eq 'new')?'</b>':'').'</td>'); |
$item.(($status eq 'new')?'</b>':'').'</td>'); |
} |
} |
my $showstatus; |
my $showstatus; |
Line 1097 ENDDISHEADER
|
Line 1089 ENDDISHEADER
|
$r->print('<table border="0" cellspacing="2" cellpadding="2"> |
$r->print('<table border="0" cellspacing="2" cellpadding="2"> |
<tr> |
<tr> |
<td>'. |
<td>'. |
'<input type="button" onclick="javascript:checkall()" value="'.&mt('Check All').'" /><br />'."\n". |
'<input type="button" onclick="javascript:checkAll(document.disall.delmark)" value="'.&mt('Check All').'" /><br />'."\n". |
'<input type="button" onclick="javascript:uncheckall()" value="'.&mt('Uncheck All').'" />'."\n". |
'<input type="button" onclick="javascript:uncheckAll(document.disall.delmark)" value="'.&mt('Uncheck All').'" />'."\n". |
'<input type="hidden" name="sortedby" value="'.$env{'form.sortedby'}.'" /></td><td> </td>'."\n". |
'<input type="hidden" name="sortedby" value="'.$env{'form.sortedby'}.'" /></td><td> </td>'."\n". |
'<td align="center"><b>'.&mt('Action').'</b><br />'."\n". |
'<td align="center"><b>'.&mt('Action').'</b><br />'."\n". |
' <select name="checkedaction" onchange="javascript:checkfoldermove()">'."\n"); |
' <select name="checkedaction" onchange="javascript:checkfoldermove()">'."\n"); |
Line 1138 ENDDISHEADER
|
Line 1130 ENDDISHEADER
|
my $postedstartdis=$startdis+1; |
my $postedstartdis=$startdis+1; |
$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>'); |
$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>'); |
if ($numblocked > 0) { |
if ($numblocked > 0) { |
my $beginblock = &Apache::lonlocal::locallocaltime($startblock); |
$r->print(&blocked_in_folder($numblocked,$startblock,$endblock, |
my $finishblock = &Apache::lonlocal::locallocaltime($endblock); |
\%setters)); |
$r->print('<br /><br />'. |
|
&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)); |
|
$r->print(&Apache::loncommon::build_block_table($startblock,$endblock, |
|
\%setters)); |
|
} |
} |
} |
} |
|
|
|
sub blocked_in_folder { |
|
my ($numblocked,$startblock,$endblock,$setters) = @_; |
|
my $beginblock = &Apache::lonlocal::locallocaltime($startblock); |
|
my $finishblock = &Apache::lonlocal::locallocaltime($endblock); |
|
my $output = '<br /><br />'. |
|
&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); |
|
$output .= &Apache::loncommon::build_block_table($startblock,$endblock, |
|
$setters); |
|
return $output; |
|
} |
|
|
# ============================================================== Compose output |
# ============================================================== Compose output |
|
|
sub compout { |
sub compout { |
Line 2030 sub displaymessage {
|
Line 2029 sub displaymessage {
|
if (defined($content{'baseurl'})) { |
if (defined($content{'baseurl'})) { |
$baseurl = &Apache::lonenc::check_encrypt($content{'baseurl'}); |
$baseurl = &Apache::lonenc::check_encrypt($content{'baseurl'}); |
} |
} |
|
$r->print(&Apache::loncommon::student_image_tag($content{'senderdomain'},$content{'sendername'})); |
$r->print('<br /><b>'.&mt('Subject').':</b> '.$content{'subject'}. |
$r->print('<br /><b>'.&mt('Subject').':</b> '.$content{'subject'}. |
($folder ne 'sent'?'<br /><b>'.&mt('From').':</b> '. |
($folder ne 'sent'?'<br /><b>'.&mt('From').':</b> '. |
&Apache::loncommon::aboutmewrapper( |
&Apache::loncommon::aboutmewrapper( |
Line 2045 sub displaymessage {
|
Line 2045 sub displaymessage {
|
if (defined($content{'courseid'}) && defined($env{'request.course.id'})) { |
if (defined($content{'courseid'}) && defined($env{'request.course.id'})) { |
if ($content{'courseid'} eq $env{'request.course.id'}) { |
if ($content{'courseid'} eq $env{'request.course.id'}) { |
my $symblink; |
my $symblink; |
|
my $showsymb = &Apache::lonenc::check_decrypt($symb); |
|
my $showurl = &Apache::lonenc::check_decrypt($baseurl); |
|
my $encrypturl = &Apache::lonnet::EXT('resource.0.encrypturl', |
|
$showsymb,$env{'user.domain'},$env{'user.name'}); |
if ($symb) { |
if ($symb) { |
&Apache::lonenc::check_decrypt(\$symb); |
if ($encrypturl =~ /^yes$/i && !$env{'request.role.adv'}) { |
$symblink = '?symb='.$symb; |
$showsymb = &Apache::lonenc::check_encrypt($symb); |
|
} |
|
$symblink = '?symb='.$showsymb; |
|
} |
|
if ($encrypturl =~ /^yes$/i && !$env{'request.role.adv'}) { |
|
$showurl = $baseurl; |
} |
} |
&Apache::lonenc::check_decrypt(\$baseurl); |
$r->print('<br /><b>'.&mt('Refers to').':</b> <a href="'.$showurl.$symblink.'">'.$restitle.'</a>'); |
$r->print('<br /><b>'.&mt('Refers to').':</b> <a href="'.$baseurl.$symblink.'">'.$restitle.'</a>'); |
|
$refers_to = 1; |
$refers_to = 1; |
} |
} |
} |
} |
if (!$refers_to) { |
if (!$refers_to) { |
if ($baseurl =~ m-^/enc/-) { |
if ($baseurl =~ m-^/enc/-) { |
if (defined($content{'courseid'})) { |
if (defined($content{'courseid'})) { |
my $unencurl = |
if (!$env{'request.course.id'}) { |
&Apache::lonenc::unencrypted($baseurl, |
my $unencurl = |
$content{'courseid'}); |
&Apache::lonenc::unencrypted($baseurl, |
if (defined($unencurl)) { |
$content{'courseid'}); |
if (&Apache::lonnet::allowed('bre',$unencurl)) { |
if ($unencurl ne '') { |
$r->print('<br /><b>'.&mt('Refers to'). |
if (&Apache::lonnet::allowed('bre',$unencurl)) { |
':</b> <a href="'.$unencurl.'">'.$restitle.'</a>'); |
$r->print('<br /><b>'.&mt('Refers to'). |
|
':</b> <a href="'.$unencurl.'">'. |
|
$restitle.'</a>'); |
|
} |
} |
} |
} |
} |
} |
} |
Line 2260 sub sendoffmail {
|
Line 2271 sub sendoffmail {
|
} |
} |
} |
} |
if ($env{'form.additionalrec'}) { |
if ($env{'form.additionalrec'}) { |
foreach my $rec (split(/\,/,$env{'form.additionalrec'})) { |
foreach my $rec (split(/\s*,\s*/,$env{'form.additionalrec'})) { |
my ($auname,$audom)=split(/:/,$rec); |
my ($auname,$audom)=split(/:/,$rec); |
if (($auname ne "") && ($audom ne "")) { |
if (($auname ne "") && ($audom ne "")) { |
$toaddr{$auname.':'.$audom}=''; |
$toaddr{$auname.':'.$audom}=''; |
Line 2289 sub sendoffmail {
|
Line 2300 sub sendoffmail {
|
my $msgtxt = $savemsg; |
my $msgtxt = $savemsg; |
if ($toaddr{$address}) { $msgtxt.='<hr />'.$toaddr{$address}; } |
if ($toaddr{$address}) { $msgtxt.='<hr />'.$toaddr{$address}; } |
my @thismsg; |
my @thismsg; |
if ((($env{'form.critmsg'}) || ($env{'form.sendbck'})) && |
if ($msgtype eq 'critical') { |
(&Apache::lonnet::allowed('srm',$env{'request.course.id'}) |
$r->print(&mt('Sending critical message').' '. |
|| &Apache::lonnet::allowed('srm',$env{'request.course.id'}. |
$recuname.':'.$recdomain.': '); |
'/'.$env{'request.course.sec'}))) { |
|
$r->print(&mt('Sending critical message').' '.$recuname.':'.$recdomain.': '); |
|
@thismsg= |
@thismsg= |
&Apache::lonmsg::user_crit_msg($recuname,$recdomain, |
&Apache::lonmsg::user_crit_msg($recuname,$recdomain, |
$msgsubj,$msgtxt, |
$msgsubj,$msgtxt, |
Line 2315 sub sendoffmail {
|
Line 2324 sub sendoffmail {
|
$specialmsg_status{$recuname.':'.$recdomain} = |
$specialmsg_status{$recuname.':'.$recdomain} = |
join(' ',@thismsg); |
join(' ',@thismsg); |
foreach my $result (@thismsg) { |
foreach my $result (@thismsg) { |
if ($result eq 'ok') { |
if ($result eq 'ok' || $result eq 'con_delayed') { |
$numspecial++; |
$numspecial++; |
} |
} |
} |
} |
Line 2347 sub sendoffmail {
|
Line 2356 sub sendoffmail {
|
split(/\:/,&unescape($specialmsgid)); |
split(/\:/,&unescape($specialmsgid)); |
|
|
foreach my $recipient (sort(keys(%toaddr))) { |
foreach my $recipient (sort(keys(%toaddr))) { |
if ($specialmsg_status{$recipient} eq 'ok') { |
if ($specialmsg_status{$recipient} =~ /\s*(ok|con_delayed)\s*/) { |
my $usersubj = $subj_prefix.'['.$recipient.']'; |
my $usersubj = $subj_prefix.'['.$recipient.']'; |
my $usermsgid = |
my $usermsgid = |
&Apache::lonmsg::buildmsgid($stamp,$usersubj, |
&Apache::lonmsg::buildmsgid($stamp,$usersubj, |
Line 2709 sub handler {
|
Line 2718 sub handler {
|
my $delresult = &deletefolder($folder); |
my $delresult = &deletefolder($folder); |
if ($delresult eq 'ok') { |
if ($delresult eq 'ok') { |
$r->print(&mt('Mail folder "[_1]" deleted.',$folder).'<br />'); |
$r->print(&mt('Mail folder "[_1]" deleted.',$folder).'<br />'); |
|
$env{'form.folder'} = ''; |
} else { |
} else { |
$r->print(&mt('Deletion failed.').' '.$delresult.'<br />'); |
$r->print(&mt('Deletion failed.').' '.$delresult.'<br />'); |
$showfolder = $folder; |
$showfolder = $folder; |
Line 2739 sub handler {
|
Line 2749 sub handler {
|
|
|
=pod |
=pod |
|
|
=back |
|
|
|
=cut |
=cut |
|
|
1; |
1; |