[system] / trunk / webwork2 / lib / WeBWorK / ContentGenerator / Instructor / SendMail.pm Repository:
ViewVC logotype

Annotation of /trunk/webwork2/lib/WeBWorK/ContentGenerator/Instructor/SendMail.pm

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3377 - (view) (download) (as text)

1 : sh002i 1663 ################################################################################
2 :     # WeBWorK Online Homework Delivery System
3 :     # Copyright © 2000-2003 The WeBWorK Project, http://openwebwork.sf.net/
4 : glarose 3377 # $CVSHeader$
5 : sh002i 1663 #
6 :     # This program is free software; you can redistribute it and/or modify it under
7 :     # the terms of either: (a) the GNU General Public License as published by the
8 :     # Free Software Foundation; either version 2, or (at your option) any later
9 :     # version, or (b) the "Artistic License" which comes with this package.
10 :     #
11 :     # This program is distributed in the hope that it will be useful, but WITHOUT
12 :     # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
13 :     # FOR A PARTICULAR PURPOSE. See either the GNU General Public License or the
14 :     # Artistic License for more details.
15 :     ################################################################################
16 :    
17 : gage 1368 package WeBWorK::ContentGenerator::Instructor::SendMail;
18 :     use base qw(WeBWorK::ContentGenerator::Instructor);
19 :    
20 :     =head1 NAME
21 :    
22 :     WeBWorK::ContentGenerator::Instructor::SendMail - Entry point for User-specific data editing
23 :    
24 :     =cut
25 :    
26 :     use strict;
27 :     use warnings;
28 :     use CGI qw();
29 : sh002i 1646 #use HTML::Entities;
30 : gage 1373 use Mail::Sender;
31 : gage 3329 use Text::Wrap qw(wrap);
32 : mschmitt 2203 use WeBWorK::HTML::ScrollingRecordList qw/scrollingRecordList/;
33 : mschmitt 2207 use WeBWorK::Utils::FilterRecords qw/filterRecords/;
34 : gage 1368
35 : gage 3041 #my $REFRESH_RESIZE_BUTTON = "Set preview to: "; # handle submit value idiocy
36 :     my $UPDATE_SETTINGS_BUTTON = "Update settings and refresh page"; # handle submit value idiocy
37 : gage 1368 sub initialize {
38 :     my ($self) = @_;
39 : gage 1928 my $r = $self->r;
40 :     my $db = $r->db;
41 :     my $ce = $r->ce;
42 :     my $authz = $r->authz;
43 :     my $user = $r->param('user');
44 : gage 1368
45 : mschmitt 2207 my @selected_filters;
46 :     if (defined ($r->param('classList!filter'))){ @selected_filters = $r->param('classList!filter');}
47 :     else {@selected_filters = ("all");}
48 :    
49 : toenail 2320
50 :     # Check permissions
51 :     return unless $authz->hasPermissions($user, "access_instructor_tools");
52 :     return unless $authz->hasPermissions($user, "send_mail");
53 :    
54 : gage 1369 #############################################################################################
55 :     # gather directory data
56 :     #############################################################################################
57 :     my $emailDirectory = $ce->{courseDirs}->{email};
58 :     my $scoringDirectory = $ce->{courseDirs}->{scoring};
59 :     my $templateDirectory = $ce->{courseDirs}->{templates};
60 : gage 1368
61 : mschmitt 2203 my $action = $r->param('action') ;
62 : gage 1369 my $openfilename = $r->param('openfilename');
63 :     my $savefilename = $r->param('savefilename');
64 : gage 1370
65 :    
66 :     #FIXME get these values from global course environment (see subroutines as well)
67 :     my $default_msg_file = 'default.msg';
68 :     my $old_default_msg_file = 'old_default.msg';
69 :    
70 : gage 1372
71 : dpvc 2388 # get user record
72 :     my $ur = $self->{db}->getUser($user);
73 :    
74 : gage 1370 # store data
75 : dpvc 2388 $self->{defaultFrom} = $ur->email_address . " (".$ur->first_name." ".$ur->last_name.")";
76 :     $self->{defaultReply} = $ur->email_address;
77 :     $self->{defaultSubject} = $self->r->urlpath->arg("courseID") . " notice";
78 :    
79 : gage 1370 $self->{rows} = (defined($r->param('rows'))) ? $r->param('rows') : $ce->{mail}->{editor_window_rows};
80 :     $self->{columns} = (defined($r->param('columns'))) ? $r->param('columns') : $ce->{mail}->{editor_window_columns};
81 :     $self->{default_msg_file} = $default_msg_file;
82 :     $self->{old_default_msg_file} = $old_default_msg_file;
83 : gage 1372 $self->{merge_file} = (defined($r->param('merge_file' ))) ? $r->param('merge_file') : 'None';
84 : gage 3041 #$self->{preview_user} = (defined($r->param('preview_user'))) ? $r->param('preview_user') : $user;
85 :     # an expermiment -- share the scrolling list for preivew and sendTo actions.
86 :     my @classList = (defined($r->param('classList'))) ? $r->param('classList') : ($user);
87 :     $self->{preview_user} = $classList[0] || $user;
88 : gage 1372
89 :     #############################################################################################
90 :     # gather database data
91 :     #############################################################################################
92 :     # FIXME this might be better done in body? We don't always need all of this data. or do we?
93 : gage 1773 my @users = $db->listUsers;
94 : mschmitt 2203 my @Users = $db->getUsers(@users);
95 : gage 1372 my @user_records = ();
96 : mschmitt 2203
97 :     ## Mark's code to prefilter userlist
98 :    
99 :    
100 :     my (@viewable_sections,@viewable_recitations);
101 :    
102 :     if (defined @{$ce->{viewable_sections}->{$user}})
103 :     {@viewable_sections = @{$ce->{viewable_sections}->{$user}};}
104 :     if (defined @{$ce->{viewable_recitations}->{$user}})
105 :     {@viewable_recitations = @{$ce->{viewable_recitations}->{$user}};}
106 :    
107 :     if (@viewable_sections or @viewable_recitations){
108 :     foreach my $student (@Users){
109 :     my $keep = 0;
110 :     foreach my $sec (@viewable_sections){
111 :     if ($student->section() eq $sec){$keep = 1;}
112 :     }
113 :     foreach my $rec (@viewable_recitations){
114 :     if ($student->recitation() eq $rec){$keep = 1;}
115 :     }
116 :     if ($keep) {push @user_records, $student;}
117 :     }
118 : gage 1667 }
119 : mschmitt 2203 else {@user_records = @Users;}
120 :    
121 :     ## End Mark's code
122 :    
123 :     # foreach my $userName (@users) {
124 :     # my $userRecord = $db->getUser($userName); # checked
125 :     # die "record for user $userName not found" unless $userRecord;
126 :     # push(@user_records, $userRecord);
127 :     # }
128 : gage 1720 ###########################
129 :     # Sort the users for presentation in the select list
130 :     ###########################
131 : mschmitt 2203 # if (defined $r->param("sort_by") ) {
132 :     # my $sort_method = $r->param("sort_by");
133 :     # if ($sort_method eq 'section') {
134 :     # @user_records = sort { (lc($a->section) cmp lc($b->section)) || (lc($a->last_name) cmp lc($b->last_name)) } @user_records;
135 :     # } elsif ($sort_method eq 'recitation') {
136 :     # @user_records = sort { (lc($a->recitation) cmp lc($b->recitation)) || (lc($a->last_name) cmp lc($b->last_name)) } @user_records;
137 :     # } elsif ($sort_method eq 'alphabetical') {
138 :     # @user_records = sort { (lc($a->last_name) cmp lc($b->last_name)) } @user_records;
139 :     # } elsif ($sort_method eq 'id' ) {
140 :     # @user_records = sort { $a->user_id cmp $b->user_id } @user_records;
141 :     # }
142 :     # } else {
143 :     # @user_records = sort { $a->user_id cmp $b->user_id } @user_records;
144 :     # }
145 : gage 1372
146 : gage 1720
147 :     # replace the user names by a sorted version.
148 :     @users = map {$_->user_id} @user_records;
149 : gage 1372 # store data
150 :     $self->{ra_users} = \@users;
151 :     $self->{ra_user_records} = \@user_records;
152 :    
153 :     #############################################################################################
154 :     # gather list of recipients
155 :     #############################################################################################
156 :     my @send_to = ();
157 :     #FIXME this (radio) is a lousy name
158 :     my $recipients = $r->param('radio');
159 : gage 1375 if (defined($recipients) and $recipients eq 'all_students') { #only active students #FIXME status check??
160 : mschmitt 2207
161 :     ## Add code so that only people who pass the current filters are added to our list of recipients.
162 :     # @user_records = filterRecords({filter=\@selected_filters},@user_records);
163 :     # I wasn't able to make this work
164 :     # I edited the selection button to make that clear.
165 :     #
166 :    
167 : gage 1372 foreach my $ur (@user_records) {
168 :     push(@send_to,$ur->user_id) if $ur->status eq 'C' and not($ur->user_id =~ /practice/);
169 :     }
170 : gage 1375 } elsif (defined($recipients) and $recipients eq 'studentID' ) {
171 : gage 1372 @send_to = $r->param('classList');
172 :     } else {
173 : gage 1375 # no recipients have been defined -- probably the first time on the page
174 : gage 1372 }
175 :     $self->{ra_send_to} = \@send_to;
176 : gage 1370 #################################################################
177 :     # Check the validity of the input file name
178 :     #################################################################
179 :     my $input_file = '';
180 :     #make sure an input message file was submitted and exists
181 :     #else use the default message
182 :     if ( defined($openfilename) ) {
183 :     if ( -e "${emailDirectory}/$openfilename") {
184 :     if ( -R "${emailDirectory}/$openfilename") {
185 :     $input_file = $openfilename;
186 : gage 1369 } else {
187 : toenail 2320 $self->addbadmessage(CGI::p(join("",
188 : gage 1370 "The file ${emailDirectory}/$openfilename is not readable by the webserver.",CGI::br(),
189 :     "Check that it's permissions are set correctly.",
190 : toenail 2320 )));
191 : gage 1369 }
192 :     } else {
193 : gage 1370 $input_file = $default_msg_file;
194 : toenail 2320 $self->addbadmessage(CGI::p(join("",
195 : gage 1370 "The file ${emailDirectory}/$openfilename cannot be found.",CGI::br(),
196 :     "Check whether it exists and whether the directory $emailDirectory can be read by the webserver.",CGI::br(),
197 :     "Using contents of the default message $default_msg_file instead.",
198 : toenail 2320 )));
199 : gage 1369 }
200 : gage 1370 } else {
201 : gage 1372 $input_file = $default_msg_file;
202 : gage 1370 }
203 : gage 1372 $self->{input_file} =$input_file;
204 : gage 1370
205 :     #################################################################
206 :     # Determine the file name to save message into
207 :     #################################################################
208 : gage 1371 my $output_file = 'FIXME no output file specified';
209 : gage 1370 if (defined($action) and $action eq 'Save as Default') {
210 :     $output_file = $default_msg_file;
211 : toenail 2084 } elsif ( defined($action) and ($action =~/save/i)) {
212 :     if (defined($savefilename) and $savefilename ) {
213 :     $output_file = $savefilename;
214 :     } else {
215 : toenail 2320 $self->addbadmessage(CGI::p("No filename was specified for saving! The message was not saved."));
216 : toenail 2084 }
217 : gage 1370 } elsif ( defined($input_file) ) {
218 :     $output_file = $input_file;
219 :     }
220 : gage 1953
221 : gage 1370 #################################################################
222 :     # Sanity check on save file name
223 :     #################################################################
224 :    
225 :     if ($output_file =~ /^[~.]/ || $output_file =~ /\.\./) {
226 : toenail 2320 $self->addbadmessage(CGI::p("For security reasons, you cannot specify a message file from a directory",
227 : toenail 2084 "higher than the email directory (you can't use ../blah/blah for example). ",
228 : toenail 2320 "Please specify a different file or move the needed file to the email directory",));
229 : toenail 2084 }
230 : gage 1371 unless ($output_file =~ m|\.msg$| ) {
231 : toenail 2320 $self->addbadmessage(CGI::p("Invalid file name.",
232 : gage 1371 "The file name \"$output_file\" does not have a \".msg\" extension",
233 :     "All email file names must end in the extension \".msg\"",
234 :     "choose a file name with a \".msg\" extension.",
235 : toenail 2320 "The message was not saved.",));
236 : gage 1371 }
237 : toenail 2084
238 : gage 1371 $self->{output_file} = $output_file; # this is ok. It will be put back in the text input box for re-editing.
239 : gage 1370
240 : toenail 2084
241 : gage 1370 #############################################################################################
242 :     # Determine input source
243 :     #############################################################################################
244 : mschmitt 2203 #warn "Action = $action";
245 :     my $input_source;
246 :     if ($action){
247 :     $input_source = ( defined( $r->param('body') ) and $action ne 'Open' ) ? 'form' : 'file';}
248 :     else { $input_source = ( defined($r->param('body')) ) ? 'form' : 'file';}
249 : gage 1953
250 : gage 1370 #############################################################################################
251 :     # Get inputs
252 :     #############################################################################################
253 :     my($from, $replyTo, $r_text, $subject);
254 :     if ($input_source eq 'file') {
255 : gage 1953
256 : gage 1370 ($from, $replyTo,$subject,$r_text) = $self->read_input_file("$emailDirectory/$input_file");
257 :    
258 : gage 1953
259 : gage 1370 } elsif ($input_source eq 'form') {
260 :     # read info from the form
261 :     # bail if there is no message body
262 : gage 1369
263 : gage 1370 $from = $r->param('from');
264 :     $replyTo = $r->param('replyTo');
265 :     $subject = $r->param('subject');
266 : gage 3329 my $body = $r->param('body');
267 : gage 1370 # Sanity check: body must contain non-white space
268 : toenail 2320 $self->addbadmessage(CGI::p('You didn\'t enter any message.')) unless ($r->param('body') =~ /\S/);
269 : gage 1370 $r_text = \$body;
270 : gage 1369
271 : gage 1370 }
272 :     # store data
273 :     $self->{from} = $from;
274 :     $self->{replyTo} = $replyTo;
275 :     $self->{subject} = $subject;
276 :     $self->{r_text} = $r_text;
277 :    
278 :    
279 : gage 1372
280 :     ###################################################################################
281 :     #Determine the appropriate script action from the buttons
282 :     ###################################################################################
283 :     # first time actions
284 :     # open new file
285 :     # open default file
286 :     # choose merge file actions
287 :     # chose merge button
288 :     # option actions
289 :     # 'reset rows'
290 :    
291 :     # save actions
292 :     # "save" button
293 :     # "save as" button
294 :     # "save as default" button
295 :     # preview actions
296 :     # 'preview' button
297 :     # email actions
298 :     # 'entire class'
299 :     # 'selected studentIDs'
300 :     # error actions (various)
301 :    
302 :    
303 : gage 1369 #############################################################################################
304 : gage 1370 # if no form is submitted, gather data needed to produce the mail form and return
305 : gage 1369 #############################################################################################
306 : gage 1372 my $to = $r->param('To');
307 :     my $script_action = '';
308 :    
309 :    
310 : gage 3041 if(not defined($action) or $action eq 'Open'
311 :     or $action eq $UPDATE_SETTINGS_BUTTON ){
312 : gage 1953
313 : gage 1369 return '';
314 :     }
315 :    
316 :    
317 :    
318 :    
319 :    
320 :     #############################################################################################
321 : gage 1370 # If form is submitted deal with filled out forms
322 : gage 1369 # and various actions resulting from different buttons
323 :     #############################################################################################
324 :    
325 : gage 1372
326 : gage 1370 if ($action eq 'Save' or $action eq 'Save as:' or $action eq 'Save as Default') {
327 :    
328 :     # warn "FIXME Saving files action = $action outputFileName=$output_file";
329 : gage 1369
330 : gage 1370 #################################################################
331 :     # construct message body
332 :     #################################################################
333 :     my $temp_body = ${ $r_text };
334 :     $temp_body =~ s/\r\n/\n/g;
335 :     $temp_body = join("",
336 :     "From: $from \nReply-To: $replyTo\n" ,
337 :     "Subject: $subject\n" ,
338 :     "Message: \n $temp_body");
339 :     # warn "FIXME from $from | subject $subject |reply $replyTo|msg $temp_body";
340 :     #################################################################
341 :     # overwrite protection
342 :     #################################################################
343 :     if ($action eq 'Save as:' and -e "$emailDirectory/$output_file") {
344 : toenail 2320 $self->addbadmessage(CGI::p("The file $emailDirectory/$output_file already exists and cannot be overwritten",
345 :     "The message was not saved"));
346 : toenail 2084 return;
347 : gage 1370 }
348 :    
349 :     #################################################################
350 :     # Back up existing file?
351 :     #################################################################
352 : gage 1371 if ($action eq 'Save as Default' and -e "$emailDirectory/$default_msg_file") {
353 :     rename("$emailDirectory/$default_msg_file","$emailDirectory/$old_default_msg_file") or
354 :     die "Can't rename $emailDirectory/$default_msg_file to $emailDirectory/$old_default_msg_file ",
355 :     "Check permissions for webserver on directory $emailDirectory. $!";
356 : toenail 2320 $self->addgoodmessage(CGI::p("Backup file <code>$emailDirectory/$old_default_msg_file</code> created." . CGI::br()));
357 : gage 1370 }
358 :     #################################################################
359 :     # Save the message
360 :     #################################################################
361 : toenail 2084 $self->saveProblem($temp_body, "${emailDirectory}/$output_file" ) unless ($output_file =~ /^[~.]/ || $output_file =~ /\.\./ || not $output_file =~ m|\.msg$|);
362 :     unless ( $self->{submit_message} or not -w "${emailDirectory}/$output_file" ) { # if there are no errors report success
363 : toenail 2320 $self->addgoodmessage(CGI::p("Message saved to file <code>${emailDirectory}/$output_file</code>."));
364 : gage 1953 }
365 :    
366 : gage 2050 } elsif ($action eq 'Preview message') {
367 : gage 1372 $self->{response} = 'preview';
368 : gage 1370
369 :     } elsif ($action eq 'Send Email') {
370 : gage 1373 $self->{response} = 'send_email';
371 : gage 3329
372 :     # check that recipients have been selected.
373 : gage 1373 my @recipients = @{$self->{ra_send_to}};
374 : toenail 2320 $self->addbadmessage(CGI::p("No recipients selected ")) unless @recipients;
375 : glarose 3377 # get merge file
376 : gage 1373 my $merge_file = ( defined($self->{merge_file}) ) ? $self->{merge_file} : 'None';
377 :     my $delimiter = ',';
378 : gage 1397 my $rh_merge_data = $self->read_scoring_file("$merge_file", "$delimiter");
379 : gage 1376 unless (ref($rh_merge_data) ) {
380 : toenail 2320 $self->addbadmessage(CGI::p("No merge data file"));
381 :     $self->addbadmessage(CGI::p("Can't read merge file $merge_file. No message sent"));
382 : gage 1376 return;
383 :     } ;
384 : glarose 3377
385 :    
386 :     foreach my $recipient (@recipients) {
387 :     #warn "FIXME sending email to $recipient";
388 :     my $ur = $self->{db}->getUser($recipient); #checked
389 :     die "record for user $recipient not found" unless $ur;
390 :     unless ($ur->email_address) {
391 :     $self->addbadmessage(CGI::p("user $recipient does not have an email address -- skipping"));
392 :     next;
393 :     }
394 :     my ($msg, $preview_header);
395 :     eval{ ($msg,$preview_header) = $self->process_message($ur,$rh_merge_data); };
396 :     $self->addbadmessage(CGI::p("There were errors in processing user $ur, merge file $merge_file. $@")) if $@;
397 :     my $mailer = Mail::Sender->new({
398 :     from => $from,
399 :     to => $ur->email_address,
400 :     smtp => $ce->{mail}->{smtpServer},
401 :     subject => $subject,
402 :     headers => "X-Remote-Host: ".$r->get_remote_host(),
403 :     });
404 :     unless (ref $mailer) {
405 :     $self->addbadmessage(CGI::p("Failed to create a mailer for user $recipient: $Mail::Sender::Error"));
406 :     next;
407 :     }
408 :     unless (ref $mailer->Open()) {
409 :     $self->addbadmessage(CGI::p("Failed to open the mailer for user $recipient: $Mail::Sender::Error"));
410 :     next;
411 :     }
412 :     my $MAIL = $mailer->GetHandle() or $self->addbadmessage(CGI::p("Couldn't get handle"));
413 :     print $MAIL $msg || $self->addbadmessage(CGI::p("Couldn't print to $MAIL"));
414 :     close $MAIL || $self->addbadmessage(CGI::p("Couldn't close $MAIL"));
415 :     #warn "FIXME mailed to ", $ur->email_address, "from $from subject $subject";
416 :    
417 :     }
418 : gage 1373
419 : gage 1370 } else {
420 : toenail 2320 $self->addbadmessage(CGI::p("Didn't recognize button $action"));
421 : gage 1370 }
422 : gage 1369
423 :    
424 : toenail 2084
425 : gage 1369 } #end initialize
426 :    
427 : gage 1368
428 :    
429 :    
430 : gage 1928
431 : gage 1368 sub body {
432 : gage 1928 my ($self) = @_;
433 :     my $r = $self->r;
434 :     my $urlpath = $r->urlpath;
435 : toenail 2320 my $authz = $r->authz;
436 : gage 1928 my $setID = $urlpath->arg("setID");
437 : gage 1372 my $response = (defined($self->{response}))? $self->{response} : '';
438 : toenail 2320 my $user = $r->param('user');
439 :    
440 :     # Check permissions
441 :     return CGI::div({class=>"ResultsWithError"}, CGI::p("You are not authorized to access instructor tools"))
442 :     unless $authz->hasPermissions($user, "access_instructor_tools");
443 :    
444 :     return CGI::div({class=>"ResultsWithError"}, CGI::p("You are not authorized to send mail to students"))
445 :     unless $authz->hasPermissions($user, "send_mail");
446 :    
447 : gage 1372 if ($response eq 'preview') {
448 :     $self->print_preview($setID);
449 : gage 1373 } elsif (($response eq 'send_email')){
450 : glarose 3377 $self->addgoodmessage(CGI::p("Email sent to ". scalar(@{$self->{ra_send_to}})." students."));
451 :     $self->{message} .= CGI::i("Email sent to ". scalar(@{$self->{ra_send_to}})." students.");
452 : gage 1372 $self->print_form($setID);
453 : gage 1375 } else {
454 :     $self->print_form($setID);
455 : gage 1372 }
456 :    
457 :     }
458 :     sub print_preview {
459 : gage 1928 my ($self) = @_;
460 :     my $r = $self->r;
461 :     my $urlpath = $r->urlpath;
462 :     my $setID = $urlpath->arg("setID");
463 :    
464 : gage 1372 # get preview user
465 : gage 1928 my $ur = $r->db->getUser($self->{preview_user}); #checked
466 : gage 1667 die "record for preview user ".$self->{preview_user}. " not found." unless $ur;
467 : gage 1372
468 :     # get merge file
469 :     my $merge_file = ( defined($self->{merge_file}) ) ? $self->{merge_file} : 'None';
470 :     my $delimiter = ',';
471 : gage 1397 my $rh_merge_data = $self->read_scoring_file("$merge_file", "$delimiter");
472 : gage 1372
473 :     my ($msg, $preview_header) = $self->process_message($ur,$rh_merge_data);
474 :    
475 :     my $recipients = join(" ",@{$self->{ra_send_to} });
476 : toenail 2084 my $errorMessage = defined($self->{submit_message}) ? CGI::i($self->{submit_message} ) : '' ;
477 : gage 1373 $msg = join("",
478 :     $errorMessage,
479 :     $preview_header,
480 :     "To: " , $ur->email_address,"\n",
481 :     "From: " , $self->{from} , "\n" ,
482 :     "Reply-To: " , $self->{replyTo} , "\n" ,
483 :     "Subject: " , $self->{subject} , "\n" ,"\n" ,
484 :     $msg , "\n"
485 :     );
486 : gage 1372
487 : gage 1373 return join("", '<pre>',$msg,"\n","\n",
488 : gage 1372 '</pre>',
489 :     CGI::p('Use browser back button to return from preview mode'),
490 :     CGI::h3('Emails to be sent to the following:'),
491 :     $recipients, "\n",
492 :    
493 :     );
494 :    
495 :     }
496 :     sub print_form {
497 : gage 1928 my ($self) = @_;
498 :     my $r = $self->r;
499 :     my $urlpath = $r->urlpath;
500 :     my $authz = $r->authz;
501 :     my $db = $r->db;
502 :     my $ce = $r->ce;
503 :     my $courseName = $urlpath->arg("courseID");
504 :     my $setID = $urlpath->arg("setID");
505 :     my $user = $r->param('user');
506 :    
507 : gage 1938 my $root = $ce->{webworkURLs}->{root};
508 :     my $sendMailPage = $urlpath->newFromModule($urlpath->module,courseID=>$courseName);
509 :     my $sendMailURL = $self->systemLink($sendMailPage, authen => 0);
510 : gage 1368
511 : toenail 2084 return CGI::em("You are not authorized to access the Instructor tools.") unless $authz->hasPermissions($user, "access_instructor_tools");
512 : gage 1368
513 :     my $userTemplate = $db->newUser;
514 :     my $permissionLevelTemplate = $db->newPermissionLevel;
515 :    
516 :     # This code will require changing if the permission and user tables ever have different keys.
517 : gage 3041 my @users = sort @{ $self->{ra_users} };
518 : gage 1372 my $ra_user_records = $self->{ra_user_records};
519 :     my %classlistLabels = ();# %$hr_classlistLabels;
520 :     foreach my $ur (@{ $ra_user_records }) {
521 : gage 1720 $classlistLabels{$ur->user_id} = $ur->user_id.': '.$ur->last_name. ', '. $ur->first_name.' -- '.$ur->section." / ".$ur->recitation;
522 : gage 1372 }
523 : gage 1368
524 : mschmitt 2203 ## Mark edit define scrolling list
525 :     my $scrolling_user_list = scrollingRecordList({
526 :     name => "classList", ## changed from classList to action
527 :     request => $r,
528 :     default_sort => "lnfn",
529 :     default_format => "lnfn_uid",
530 :     default_filters => ["all"],
531 :     size => 5,
532 :     multiple => 1,
533 : gage 3041 refresh_button_name =>'Update settings and refresh page',
534 : mschmitt 2203 }, @{$ra_user_records});
535 : gage 1368
536 :     ##############################################################################################################
537 :    
538 : gage 1372
539 : gage 1369 my $from = $self->{from};
540 :     my $subject = $self->{subject};
541 :     my $replyTo = $self->{replyTo};
542 :     my $columns = $self->{columns};
543 :     my $rows = $self->{rows};
544 : gage 1370 my $text = defined($self->{r_text}) ? ${ $self->{r_text} }: 'FIXME no text was produced by initialization!!';
545 :     my $input_file = $self->{input_file};
546 :     my $output_file = $self->{output_file};
547 : gage 1371 my @sorted_messages = $self->get_message_file_names;
548 :     my @sorted_merge_files = $self->get_merge_file_names;
549 :     my $merge_file = ( defined($self->{merge_file}) ) ? $self->{merge_file} : 'None';
550 : gage 1372 my $delimiter = ',';
551 : gage 1397 my $rh_merge_data = $self->read_scoring_file("$merge_file", "$delimiter");
552 : gage 1372 my @merge_keys = keys %$rh_merge_data;
553 :     my $preview_user = $self->{preview_user};
554 : gage 1667 my $preview_record = $db->getUser($preview_user); # checked
555 :     die "record for preview user ".$self->{preview_user}. " not found." unless $preview_record;
556 : gage 1372
557 : gage 1667
558 : gage 1372 #############################################################################################
559 :    
560 : gage 1938 print CGI::start_form({method=>"post", action=>$sendMailURL});
561 : gage 1372 print $self->hidden_authen_fields();
562 :     #############################################################################################
563 :     # begin upper table
564 :     #############################################################################################
565 :    
566 : gage 1368 print CGI::start_table({-border=>'2', -cellpadding=>'4'});
567 : gage 1720 print CGI::Tr({-align=>'left',-valign=>'top'},
568 : gage 1372 #############################################################################################
569 :     # first column
570 :     #############################################################################################
571 :    
572 : gage 3041 CGI::td(CGI::strong("Message file: "), $input_file,"\n",CGI::br(),
573 : gage 1371 CGI::submit(-name=>'action', -value=>'Open'), '&nbsp;&nbsp;&nbsp;&nbsp;',"\n",
574 :     CGI::popup_menu(-name=>'openfilename',
575 :     -values=>\@sorted_messages,
576 :     -default=>$input_file
577 : gage 3041 ),
578 :     "\n",CGI::br(),
579 :     CGI::strong("Save file to: "), $output_file,
580 :     "\n",CGI::br(),
581 :     CGI::strong('Merge file: '), $merge_file,
582 :     CGI::br(),
583 :     CGI::popup_menu(-name=>'merge_file',
584 :     -values=>\@sorted_merge_files,
585 :     -default=>$merge_file,
586 :     ), "\n",
587 :     "\n",
588 :     #CGI::hr(),
589 :     CGI::div({style=>"background-color: #CCCCCC"},
590 :     "\n", 'From:','&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;', CGI::textfield(-name=>"from", -size=>30, -value=>$from, -override=>1),
591 :     "\n", CGI::br(),'Reply-To: ', CGI::textfield(-name=>"replyTo", -size=>30, -value=>$replyTo, -override=>1),
592 :     "\n", CGI::br(),'Subject: ', CGI::br(), CGI::textarea(-name=>'subject', -default=>$subject, -rows=>3,-columns=>30, -override=>1),
593 :     ),
594 :     #CGI::hr(),
595 :     CGI::submit(-name=>'action', -value=>$UPDATE_SETTINGS_BUTTON),
596 :    
597 : gage 1370 ),
598 : gage 1372 #############################################################################################
599 :     # second column
600 :     #############################################################################################
601 : mschmitt 2203 # CGI::td({-align=>'left',style=>'font-size:smaller'},
602 :     #
603 :     # CGI::strong("Send to:"),
604 :     # CGI::radio_group(-name=>'radio', -values=>['all_students','studentID'],
605 : mschmitt 2207 # -labels=>{all_students=>'All students in course',studentID => 'Selected'},
606 : mschmitt 2203 # -default=>'studentID',
607 :     # -linebreak=>0
608 :     # ), CGI::br(),CGI::br(),
609 :     ## Edit by Mark to insert scrolling list
610 :     CGI::td({-style=>"width:33%"},CGI::strong("Send to:"),
611 :     CGI::radio_group(-name=>'radio', -values=>['all_students','studentID'],
612 : mschmitt 2207 -labels=>{all_students=>'All students in course',studentID => 'Selected students'},
613 : mschmitt 2203 -default=>'studentID', -linebreak=>0),
614 : gage 3041 CGI::br(),$scrolling_user_list,
615 :     CGI::i("Preview set to: "), $preview_record->last_name,
616 :     CGI::submit(-name=>'action', -value=>'preview',-label=>'Preview message'),'&nbsp;&nbsp;',
617 :     ),
618 :    
619 : mschmitt 2203 ## Edit here to insert filtering
620 :     ## be sure to fail GRACEFULLY!
621 :     #
622 :     #
623 :     # CGI::input({type=>'submit',value=>'Sort by',name=>'action'}),,
624 :     # CGI::radio_group(-name=>'sort_by', -values=>['id','alphabetical','section','recitation'],
625 :     # -labels=>{id=>'Login',alphabetical=>'Alph.',section => 'Sec.',recitation=>'Rec.'},
626 :     # -default=>defined($r->param("sort_by")) ? $r->param("sort_by") : 'id',
627 :     # -linebreak=>0
628 :     # ),
629 :     #
630 :     # CGI::br(),CGI::br(),
631 :     # CGI::popup_menu(-name=>'classList',
632 :     # -values=>\@users,
633 :     # -labels=>\%classlistLabels,
634 :     # -size => 10,
635 :     # -multiple => 1,
636 :     # -default=>$user
637 :     # ),
638 :     # ),
639 : gage 1720
640 : mschmitt 2203
641 : gage 1720
642 : mschmitt 2203
643 : gage 1372 #############################################################################################
644 :     # third column
645 :     #############################################################################################
646 : gage 1370 CGI::td({align=>'left'},
647 : gage 3041 # "<b>Merge file:</b> $merge_file", CGI::br(),
648 :     # CGI::submit(-name=>'action', -value=>'Set merge file to:'),CGI::br(),
649 :     # CGI::popup_menu(-name=>'merge_file',
650 :     # -values=>\@sorted_merge_files,
651 :     # -default=>$merge_file,
652 :     # ), "\n",
653 :     # CGI::hr(),
654 :     # CGI::b("Viewing email for: "), "$preview_user",CGI::br(),
655 :     # CGI::submit(-name=>'action', -value=>'resize', -label=>$REFRESH_RESIZE_BUTTON),'&nbsp;',
656 :     # CGI::popup_menu(-name=>'preview_user',
657 :     # -values=>\@users,
658 :     # #-labels=>\%classlistLabels,
659 :     # -default=>$preview_user,
660 :     # ),
661 :     # CGI::br(),
662 :     # CGI::submit(-name=>'action', -value=>'preview',-label=>'Preview message'),'&nbsp;&nbsp;',
663 :     #
664 :     # CGI::br(),
665 :     #
666 :     # CGI::hr(),
667 : gage 1370 " Rows: ", CGI::textfield(-name=>'rows', -size=>3, -value=>$rows),
668 :     " Columns: ", CGI::textfield(-name=>'columns', -size=>3, -value=>$columns),
669 : gage 3041 CGI::br(),
670 :     # CGI::i('Press any action button to update display'),CGI::br(),
671 : gage 1370 #show available macros
672 :     CGI::popup_menu(
673 :     -name=>'dummyName',
674 :     -values=>['', '$SID', '$FN', '$LN', '$SECTION', '$RECITATION','$STATUS', '$EMAIL', '$LOGIN', '$COL[3]', '$COL[-1]'],
675 :     -labels=>{''=>'list of insertable macros',
676 :     '$SID'=>'$SID - Student ID',
677 :     '$FN'=>'$FN - First name',
678 :     '$LN'=>'$LN - Last name',
679 : gage 1372 '$SECTION'=>'$SECTION',
680 : gage 1370 '$RECITATION'=>'$RECITATION',
681 :     '$STATUS'=>'$STATUS - C, Audit, Drop, etc.',
682 :     '$EMAIL'=>'$EMAIL - Email address',
683 :     '$LOGIN'=>'$LOGIN - Login',
684 : gage 1372 '$COL[3]'=>'$COL[3] - 3rd col',
685 : gage 1370 '$COL[-1]'=>'$COL[-1] - Last column'
686 :     }
687 :     ), "\n",
688 :     ),
689 : gage 1368
690 : gage 1370 ); # end Tr
691 : gage 1372 print CGI::end_table();
692 :     #############################################################################################
693 :     # end upper table
694 :     #############################################################################################
695 :    
696 :     # show merge file
697 :     # print "<pre>",(map {$_ =~s/\s/\./g;$_} map {sprintf('%-8.8s',$_);} 0..8),"</pre>";
698 :     # print CGI::popup_menu(
699 :     # -name=>'dummyName2',
700 :     # -values=>\@merge_keys,
701 :     # -labels=>$rh_merge_data,
702 :     # -multiple=>1,
703 :     # -size =>2,
704 :     #
705 :     # ), "\n",CGI::br();
706 :     # warn "merge keys ", join( " ",@merge_keys);
707 :     #############################################################################################
708 :     # merge file fragment and message text area field
709 :     #############################################################################################
710 : gage 1373 my @tmp2;
711 : gage 1667 eval{ @tmp2= @{$rh_merge_data->{ $db->getUser($preview_user)->student_id } };}; # checked
712 : gage 1730 if ($@ and $merge_file ne 'None') {
713 : gage 1381 print "No merge data for $preview_user in merge file: &lt;$merge_file&gt;",CGI::br();
714 : gage 1373 } else {
715 : apizer 2786 print CGI::pre("",data_format(1..($#tmp2+1)),"<br>", data_format2(@tmp2));
716 : gage 1373 }
717 : gage 1368 #create a textbox with the subject and a textarea with the message
718 :     #print actual body of message
719 : gage 1369
720 : gage 1370 print "\n", CGI::p( $self->{message}) if defined($self->{message});
721 : gage 1369 print "\n", CGI::p( CGI::textarea(-name=>'body', -default=>$text, -rows=>$rows, -columns=>$columns, -override=>1));
722 : gage 1372
723 :     #############################################################################################
724 :     # action button table
725 :     #############################################################################################
726 : gage 1370 print CGI::table( { -border=>2,-cellpadding=>4},
727 :     CGI::Tr(
728 :     CGI::td( CGI::submit(-name=>'action', -value=>'Send Email') ), "\n",
729 :     CGI::td(CGI::submit(-name=>'action', -value=>'Save')," to $output_file"), " \n",
730 :     CGI::td(CGI::submit(-name=>'action', -value=>'Save as:'),
731 :     CGI::textfield(-name=>'savefilename', -size => 20, -value=> "$output_file", -override=>1)
732 :     ), "\n",
733 :     CGI::td(CGI::submit(-name=>'action', -value=>'Save as Default')),
734 :     )
735 :     );
736 : gage 1368
737 :     ##############################################################################################################
738 : gage 1369
739 :     print CGI::end_form();
740 : gage 1368 return "";
741 :     }
742 :    
743 : gage 1369 ##############################################################################
744 :     # Utility methods
745 :     ##############################################################################
746 : gage 1370 sub submission_error {
747 : gage 1369 my $self = shift;
748 : toenail 2084 my $msg = join( " ", @_);
749 : gage 1730 $self->{submitError} .= CGI::br().$msg;
750 : toenail 2084 return;
751 : gage 1369 }
752 :    
753 : gage 1370 sub saveProblem {
754 :     my $self = shift;
755 :     my ($body, $probFileName)= @_;
756 :     local(*PROBLEM);
757 :     open (PROBLEM, ">$probFileName") ||
758 : toenail 2320 $self->addbadmessage(CGI::p("Could not open $probFileName for writing.
759 :     Check that the permissions for this problem are 660 (-rw-rw----)"));
760 : toenail 2084 print PROBLEM $body if -w $probFileName;
761 : gage 1370 close PROBLEM;
762 :     chmod 0660, "$probFileName" ||
763 : toenail 2320 $self->addbadmessage(CGI::p("CAN'T CHANGE PERMISSIONS ON FILE $probFileName"));
764 : gage 1370 }
765 :    
766 :     sub read_input_file {
767 :     my $self = shift;
768 :     my $filePath = shift;
769 :     my ($text, @text);
770 :     my $header = '';
771 :     my ($subject, $from, $replyTo);
772 :     local(*FILE);
773 : gage 1371 if (-e "$filePath" and -r "$filePath") {
774 : toenail 2320 open FILE, "$filePath" || do { $self->addbadmessage(CGI::p("Can't open $filePath")); return};
775 : gage 1371 while ($header !~ s/Message:\s*$//m and not eof(FILE)) {
776 : gage 1370 $header .= <FILE>;
777 :     }
778 :     $text = join( '', <FILE>);
779 :     $text =~ s/^\s*//; # remove initial white space if any.
780 :     $header =~ /^From:\s(.*)$/m;
781 :     $from = $1 or $from = $self->{defaultFrom};
782 :    
783 :     $header =~ /^Reply-To:\s(.*)$/m;
784 :     $replyTo = $1 or $replyTo = $self->{defaultReply};
785 :    
786 :     $header =~ /^Subject:\s(.*)$/m;
787 :     $subject = $1;
788 :    
789 :     } else {
790 :     $from = $self->{defaultFrom};
791 :     $replyTo = $self->{defaultReply};
792 : gage 1371 $text = (-e "$filePath") ? "FIXME file $filePath can't be read" :"FIXME file $filePath doesn't exist";
793 : dpvc 2388 $subject = $self->{defaultSubject};
794 : gage 1370 }
795 :     return ($from, $replyTo, $subject, \$text);
796 :     }
797 : gage 1371
798 :    
799 : gage 1397 sub get_message_file_names {
800 :     my $self = shift;
801 :     return $self->read_dir($self->{ce}->{courseDirs}->{email}, '\\.msg$');
802 : gage 1371 }
803 : gage 1397 sub get_merge_file_names {
804 :     my $self = shift;
805 : gage 1730 return 'None', $self->read_dir($self->{ce}->{courseDirs}->{scoring}, '\\.csv$'); #FIXME ? check that only readable files are listed.
806 : gage 1371 }
807 : gage 1372
808 : gage 3329 sub mail_message_to_recipients {
809 :     my $self = shift;
810 :     my $subject = $self->{subject};
811 :     my $from = $self->{from};
812 :     my @recipients = @{$self->{ra_send_to}};
813 :     my $rh_merge_data = $self->{rh_merge_data};
814 :     my $merge_file = $self->{merge_file};
815 :     my $result_message = '';
816 :     my $failed_messages = 0;
817 :     foreach my $recipient (@recipients) {
818 :     # warn "FIXME sending email to $recipient";
819 :     my $error_messages = '';
820 :     my $ur = $self->{db}->getUser($recipient); #checked
821 :     unless ($ur) {
822 :     $error_messages .= "Record for user $recipient not found\n";
823 :     next;
824 :     }
825 :     unless ($ur->email_address) {
826 :     $error_messages .="User $recipient does not have an email address -- skipping\n";
827 :     next;
828 :     }
829 :     my ($msg, $preview_header);
830 :     eval{ ($msg,$preview_header) = $self->process_message($ur,$rh_merge_data); };
831 :     $error_messages .= "There were errors in processing user $ur, merge file $merge_file. \n$@\n" if $@;
832 :     my $mailer = Mail::Sender->new({
833 :     from => $from,
834 :     to => $ur->email_address,
835 :     smtp => $self->{smtpServer},
836 :     subject => $subject,
837 :     headers => "X-Remote-Host: ".$self->r->get_remote_host(),
838 :     });
839 :     unless (ref $mailer) {
840 :     $error_messages .= "Failed to create a mailer for user $recipient: $Mail::Sender::Error\n";
841 :     next;
842 :     }
843 :     unless (ref $mailer->Open()) {
844 :     $error_messages .= "Failed to open the mailer for user $recipient: $Mail::Sender::Error\n";
845 :     next;
846 :     }
847 :     my $MAIL = $mailer->GetHandle() || ($error_messages .= "Couldn't get mailer handle \n");
848 :     print $MAIL $msg || ($error_messages .= "Couldn't print to $MAIL");
849 :     close $MAIL || ($error_messages .= "Couldn't close $MAIL");
850 :     #warn "FIXME mailed to $recipient: ", $ur->email_address, " from $from subject $subject Errors: $error_messages";
851 :     $failed_messages++ if $error_messages;
852 :     $result_message .= $error_messages;
853 :     }
854 :     my $courseName = $self->r->urlpath->arg("courseID");
855 :     my $number_of_recipients = scalar(@recipients) - $failed_messages;
856 :     $result_message = <<EndText.$result_message;
857 :    
858 :     A message with the subject line
859 :     $subject
860 :     has been sent to
861 :     $number_of_recipients recipient(s) in the class $courseName.
862 :     There were $failed_messages message(s) that could not be delivered.
863 :    
864 :     EndText
865 : gage 1397
866 : gage 3329 }
867 :     sub email_notification {
868 :     my $self = shift;
869 :     my $result_message = shift;
870 :     # find info on mailer and sender
871 :     # use the defaultFrom address.
872 :    
873 :     # find info on instructor recipient and message
874 :     my $subject="WeBWorK email sent";
875 :    
876 :     my $mailing_errors = "";
877 :     # open MAIL handle
878 :     my $mailer = Mail::Sender->new({
879 :     from => $self->{defaultFrom},
880 :     to => $self->{defaultFrom},
881 :     smtp => $self->{smtpServer},
882 :     subject => $subject,
883 :     headers => "X-Remote-Host: ".$self->r->get_remote_host(),
884 :     });
885 :     unless (ref $mailer) {
886 :     $mailing_errors .= "Failed to create a mailer: $Mail::Sender::Error";
887 :     return "";
888 :     }
889 :     unless (ref $mailer->Open()) {
890 :     $mailing_errors .= "Failed to open the mailer: $Mail::Sender::Error";
891 :     return "";
892 :     }
893 :     my $MAIL = $mailer->GetHandle();
894 :     # print message
895 :     print $MAIL $result_message;
896 :     # clean up
897 :     close $MAIL;
898 :    
899 :     warn "instructor message sent to ", $self->{defaultFrom};
900 :    
901 :     }
902 : gage 1372 sub getRecord {
903 :     my $self = shift;
904 :     my $line = shift;
905 :     my $delimiter = shift;
906 :     $delimiter = ',' unless defined($delimiter);
907 :    
908 :     # Takes a delimited line as a parameter and returns an
909 :     # array. Note that all white space is removed. If the
910 :     # last field is empty, the last element of the returned
911 :     # array is also empty (unlike what the perl split command
912 :     # would return). E.G. @lineArray=&getRecord(\$delimitedLine).
913 :    
914 :     my(@lineArray);
915 : gage 2001 $line.="${delimiter}___"; # add final field which must be non-empty
916 :     @lineArray = split(/\s*${delimiter}\s*/,$line); # split line into fields
917 : gage 1372 $lineArray[0] =~s/^\s*//; # remove white space from first element
918 : gage 2001 pop @lineArray; # remove the last artificial field
919 : gage 1372 @lineArray;
920 :     }
921 :    
922 :     sub process_message {
923 :     my $self = shift;
924 :     my $ur = shift;
925 :     my $rh_merge_data = shift;
926 :     my $text = defined($self->{r_text}) ? ${ $self->{r_text} }:
927 : gage 1730 'FIXME no text was produced by initialization!!';
928 :     my $merge_file = ( defined($self->{merge_file}) ) ? $self->{merge_file} : 'None';
929 : gage 1372 #user macros that can be used in the email message
930 :     my $SID = $ur->student_id;
931 :     my $FN = $ur->first_name;
932 :     my $LN = $ur->last_name;
933 :     my $SECTION = $ur->section;
934 :     my $RECITATION = $ur->recitation;
935 :     my $STATUS = $ur->status;
936 :     my $EMAIL = $ur->email_address;
937 :     my $LOGIN = $ur->user_id;
938 : gage 1730
939 : gage 1372 # get record from merge file
940 :     # FIXME this is inefficient. The info should be cached
941 : gage 1373 my @COL = defined($rh_merge_data->{$SID}) ? @{$rh_merge_data->{$SID} } : ();
942 : gage 1730 if ($merge_file ne 'None' && not defined($rh_merge_data->{$SID}) ) {
943 : toenail 2320 $self->addbadmessage(CGI::p("No merge data for student id:$SID; name:$FN $LN; login:$LOGIN"));
944 : gage 1730 }
945 : apizer 2779 unshift(@COL,""); ## this makes COL[1] the first column
946 : gage 1372 my $endCol = @COL;
947 :     # for safety, only evaluate special variables
948 : gage 1373 my $msg = $text;
949 : apizer 2787 $msg =~ s/\$SID/$SID/ge;
950 :     $msg =~ s/\$LN/$LN/ge;
951 :     $msg =~ s/\$FN/$FN/ge;
952 :     $msg =~ s/\$STATUS/$STATUS/ge;
953 :     $msg =~ s/\$SECTION/$SECTION/ge;
954 :     $msg =~ s/\$RECITATION/$RECITATION/ge;
955 :     $msg =~ s/\$EMAIL/$EMAIL/ge;
956 :     $msg =~ s/\$LOGIN/$LOGIN/ge;
957 :     if (defined($COL[1])) { # prevents extraneous error messages.
958 :     $msg =~ s/\$COL\[(\-?\d+)\]/$COL[$1]/ge
959 :     }
960 :     else { # prevents extraneous $COL's in email message
961 :     $msg =~ s/\$COL\[(\-?\d+)\]//g
962 :     }
963 :    
964 : gage 1373 $msg =~ s/\r//g;
965 : apizer 2779
966 :     my @preview_COL = @COL;
967 :     shift @preview_COL; ## shift back for preview
968 :     my $preview_header = CGI::pre("",data_format(1..($#COL)),"<br>", data_format2(@preview_COL)).
969 : gage 1372 CGI::h3( "This sample mail would be sent to $EMAIL");
970 :    
971 :     return $msg, $preview_header;
972 :     }
973 : gage 1948
974 :    
975 :     # Ê sub data_format {
976 :     #
977 :     # Ê Ê Ê Ê Êmap {$_ =~s/\s/\./g;$_} Ê Ê map {sprintf('%-8.8s',$_);} Ê@_;
978 : gage 1372 sub data_format {
979 : gage 1948 map {"COL[$_]".'&nbsp;'x(3-length($_));} @_; # problems if $_ has length bigger than 4
980 : gage 1372 }
981 : gage 1947 sub data_format2 {
982 : gage 1948 map {$_ =~s/\s/&nbsp;/g;$_} map {sprintf('%-8.8s',$_);} @_;
983 : gage 1947 }
984 : gage 1368 1;

aubreyja at gmail dot com
ViewVC Help
Powered by ViewVC 1.0.9