version 1.64, 2007/01/17 18:05:57
|
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 980 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 1050 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 1136 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 2028 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 2269 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 2354 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 2716 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 2746 sub handler {
|
Line 2749 sub handler {
|
|
|
=pod |
=pod |
|
|
=back |
|
|
|
=cut |
=cut |
|
|
1; |
1; |