[LON-CAPA-cvs] cvs: doc /help course.manual.texxml /loncapafiles loncapafiles.lpml loncom/html/adm/help/png pref.png loncom/html/adm/help/tex Prefs_Forwarding.tex Prefs_Messages.tex Prefs_Notification.tex loncom/interface lonpreferences.pm

raeburn lon-capa-cvs-allow@mail.lon-capa.org
Mon, 21 Jan 2008 04:30:49 -0000


This is a MIME encoded message

--raeburn1200889849
Content-Type: text/plain

raeburn		Sun Jan 20 23:30:49 2008 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Prefs_Messages.tex Prefs_Notification.tex 
    /loncom/html/adm/help/png	pref.png 

  Modified files:              
    /loncom/interface	lonpreferences.pm 
    /loncom/html/adm/help/tex	Prefs_Forwarding.tex 
    /doc/help	course.manual.texxml 
    /doc/loncapafiles	loncapafiles.lpml 
  Log:
  - Modify Message Forwarding and Message Notification preferences screen to clarify the distinction between internal forwarding and external notification email.
  - Add a blue help icon for this item to Preferences Menu page
  - Update documentation for Message Forwarding and Message Notification preference.
  - Add two new help files and the "Pref" icon to loncapafiles.lpml
  - Update course coordinator manual with new Messages preferences documentation
  
  
--raeburn1200889849
Content-Type: text/plain
Content-Disposition: attachment; filename="raeburn-20080120233049.txt"

Index: loncom/interface/lonpreferences.pm
diff -u loncom/interface/lonpreferences.pm:1.112 loncom/interface/lonpreferences.pm:1.113
--- loncom/interface/lonpreferences.pm:1.112	Sun Jan 20 17:38:06 2008
+++ loncom/interface/lonpreferences.pm	Sun Jan 20 23:30:05 2008
@@ -1,7 +1,7 @@
 # The LearningOnline Network
 # Preferences
 #
-# $Id: lonpreferences.pm,v 1.112 2008/01/20 22:38:06 raeburn Exp $
+# $Id: lonpreferences.pm,v 1.113 2008/01/21 04:30:05 raeburn Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -624,6 +624,7 @@
                                           crit  => 'Critical only',
                                           reg   => 'Non-critical only',
                                           foad  => 'Forwarding Address(es)',
+                                          noti  => 'Notification E-mail Address(es)', 
                                           foad_exmpl => 'e.g. <tt>userA:domain1,userB:domain2,...</tt>',
                                           mnot  => 'Email Address(es) which should be notified about new LON-CAPA messages', # old: 'Message Notification Email Address(es)',
                                           mnot_exmpl => 'e.g. <tt>joe@doe.com</tt>',
@@ -633,10 +634,9 @@
                                           toen => "To enter multiple addresses, enter one address at a time, click 'Change' and then add the next one", 
                                           prme => 'Back to preferences menu',
                                         );
-    my $forwardingHelp = Apache::loncommon::help_open_topic("Prefs_Forwarding",
-							    &mt("What are forwarding and notification addresses?"));
-    my $criticalMessageHelp = Apache::loncommon::help_open_topic("Course_Critical_Message",
-								 &mt("What are critical messages?"));
+    my $forwardingHelp = &Apache::loncommon::help_open_topic("Prefs_Forwarding");
+    my $notificationHelp = &Apache::loncommon::help_open_topic("Prefs_Notification");
+    my $criticalMessageHelp = &Apache::loncommon::help_open_topic("Course_Critical_Message");
     my @allow_html = split(/,/,$userenv{'notifywithhtml'});
     my %allnot = &get_notifications(\%userenv);
     my $validatescript = &Apache::lonhtmlcommon::javascript_valid_email();
@@ -699,12 +699,12 @@
     $r->print(<<ENDMSG);
 $jscript
 $message
-$forwardingHelp
+<h3>$lt{'foad'} $forwardingHelp</h3>
 <form name="prefs" action="/adm/preferences" method="post">
 <input type="hidden" name="action" value="verify_and_change_msgforward" />
 $lt{'foad'} ($lt{'foad_exmpl'}):
-<input type="text" size="40" value="$msgforward" name="msgforward" /><hr />
-$criticalMessageHelp
+<input type="text" size="40" value="$msgforward" name="msgforward" /><br />
+<h3>$lt{'noti'} $notificationHelp</h3>
 $lt{'mnot'} ($lt{'mnot_exmpl'}):<br />
 ENDMSG
     my @sortforwards = sort (keys(%allnot));
@@ -713,7 +713,8 @@
                  '<th>&nbsp;</th>'.
                  '<th>'.&mt('Action').'</th>'.
                  '<th>'.&mt('Notification address').'</th><th>'.
-                 &mt('Types of message for which notification is sent').'</th><th>'.
+                 &mt('Types of message for which notification is sent').
+                 $criticalMessageHelp.'</th><th>'.
                  &mt('Excerpt retains HTML tags in message').'</th>'.
                  &Apache::loncommon::end_data_table_header_row();
     my $num = 0;
@@ -796,7 +797,7 @@
     $num ++;
     $r->print($output);
     $r->print(qq|
-<hr />
+<br /><hr />
 <input type="hidden" name="numnotify" value="$num" />
 <input type="button" value="$lt{'chg'}" onclick="javascript:validate()" />
 <input type="button" value="$lt{'prme'}" onclick="location.href='/adm/preferences'" />
@@ -1667,16 +1668,17 @@
     push (@Options,({ action   => 'changemsgforward',
                       linktext => 'Change Message Forwarding and Notification Email Addresses',
                       href     => '/adm/preferences',
-                      help     => 'Prefs_Forwarding',
+                      help     => 'Prefs_Messages',
                       breadcrumb => 
                           { href => '/adm/preferences?action=changemsgforward',
-                            text => 'Change Message Forwarding'},
+                            text => 'Change Message Forwarding/Notification'},
                       subroutine => \&msgforwardchanger,
                       },
                     { action => 'verify_and_change_msgforward',
+                      help   => 'Prefs_Messages',
                       breadcrumb => 
                           { href => '/adm/preferences?action=changemsgforward',
-                            text => 'Change Message Forwarding'},
+                            text => 'Change Message Forwarding/Notification'},
                       printmenu => 'no',
                       subroutine => \&verify_and_change_msgforward }));
     my $aboutmeaction=
Index: loncom/html/adm/help/tex/Prefs_Forwarding.tex
diff -u loncom/html/adm/help/tex/Prefs_Forwarding.tex:1.11 loncom/html/adm/help/tex/Prefs_Forwarding.tex:1.12
--- loncom/html/adm/help/tex/Prefs_Forwarding.tex:1.11	Tue Aug  7 17:29:16 2007
+++ loncom/html/adm/help/tex/Prefs_Forwarding.tex	Sun Jan 20 23:30:17 2008
@@ -1,29 +1,19 @@
 \label{Prefs_Forwarding}
-\textbf{Forwarding Multiple LON-CAPA accounts}
-
-If you have multiple LON-CAPA accounts and wish to receive all communication in one account, set LON-CAPA to forward these for you.
-
-LON-CAPA can also send new message notifications to your conventional
-email accounts. You can choose to forward only
-critical messages within LON-CAPA, or to forward to any email account.
-
-To forward messages and notifications, do the following:
-
-\begin{enumerate} 
-
-\item Select \textbf{PREF} on the Remote Control or Main Menu. 
-\item At the \textbf{Change Preferences} screen, click the 
-  \underbar{Change Message Forwarding and Notification Addresses} link.
-\item Type your desired forward address or addresses into the text field
-  labeled \textbf{New Forwarding Address(es)}. This should be one or
-  more LON-CAPA addresses, like ``user:domain'', separated by commas.
-\item Type your desired forward address or addresses into the text field
-   labeled \textbf{New Message Notification Email Address(es)}. This
-   should be one or more Internet email addresses, like
-   ``user@example.com'', separated by commas. 
-\item Type your desired forward address or addresses into the text field labeled \textbf{New Critical Message Notification Email Address(es)}. This
-   should be one or more Internet email addresses, like
-   ``user@example.com'', separated by commas. 
-\item Click the \fbox{Change} button.
-
-\end{enumerate}
+\textbf{Message Forwarding for Users with Multiple LON-CAPA accounts}
+
+If you have multiple LON-CAPA accounts and wish to receive all communication in one account, set LON-CAPA to forward messages sent to your other accounts to the single account where you wish to receive your aggregated messages. You can forward messages to more than one account.
+
+To forward messages do the following:
+
+\begin{enumerate}
+\item Click "Set my user Preferences" (\includegraphics[width=0.01\paperwidth]{pref}
+\textbf{PREF}) on the Main Menu, or the remote control (if used).
+
+\item At the \textbf{Change Preferences} screen, click the
+  \underbar{Change Message Forwarding and Notification Addresses} link.
+\item Type your desired forward address in the text field
+  labeled \textbf{New Forwarding Address(es)}. This should be one or
+  more LON-CAPA addresses, like ``user:domain'', separated by commas.
+\item Click the \fbox{Change} button.
+
+\end{enumerate}
Index: doc/help/course.manual.texxml
diff -u doc/help/course.manual.texxml:1.19 doc/help/course.manual.texxml:1.20
--- doc/help/course.manual.texxml:1.19	Tue Jan  1 21:03:29 2008
+++ doc/help/course.manual.texxml	Sun Jan 20 23:30:38 2008
@@ -28,8 +28,8 @@
 	<subsection name="Nickname and Anonymous Discussion Screen Name">
 		<file name="Prefs_Screen_Name_Nickname.tex" />
 		</subsection>
-	<subsection name="Message forwarding and notification address">
-		<file name="Prefs_Forwarding.tex" />
+	<subsection name="Message forwarding and email notification addresses">
+		<file name="Prefs_Messages.tex" />
 		</subsection>
 	<subsection name="The 'About Me' Personal Information Screen">
 		<file name="Prefs_About_Me.tex" />
Index: doc/loncapafiles/loncapafiles.lpml
diff -u doc/loncapafiles/loncapafiles.lpml:1.567 doc/loncapafiles/loncapafiles.lpml:1.568
--- doc/loncapafiles/loncapafiles.lpml:1.567	Sun Dec 30 18:14:24 2007
+++ doc/loncapafiles/loncapafiles.lpml	Sun Jan 20 23:30:48 2008
@@ -2,7 +2,7 @@
  "http://lpml.sourceforge.net/DTD/lpml.dtd">
 <!-- loncapafiles.lpml -->
 
-<!-- $Id: loncapafiles.lpml,v 1.567 2007/12/30 23:14:24 raeburn Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.568 2008/01/21 04:30:48 raeburn Exp $ -->
 
 <!--
 
@@ -2267,6 +2267,7 @@
 numericalResponseVarInText.gif;
 optionResponseEditing.gif;
 optionResponseProblem.gif;
+pref.gif;
 publishMetadata.gif;
 radioResponse2.gif;
 radioResponseHint.gif;
@@ -2650,6 +2651,8 @@
 Prefs_About_Me.tex;
 Prefs_Forwarding.tex;
 Prefs_Language.tex;
+Prefs_Messages.tex;
+Prefs_Notification;
 Prefs_Screen_Name_Nickname.tex;
 Print_Library.tex;
 Print_Options.tex;

Index: loncom/html/adm/help/tex/Prefs_Messages.tex
+++ loncom/html/adm/help/tex/Prefs_Messages.tex
\label{Prefs_Messages}
\textbf{Automatically forward messages sent to one LON-CAPA account to another} 

If you have multiple LON-CAPA accounts and wish to receive all communication in one account, set LON-CAPA to forward messages sent to your other accounts to the single account where you wish to receive your aggregated messages. You can forward messages to more than one account.

To forward messages do the following:

\begin{enumerate}
\item Click "Set my user Preferences" (\includegraphics[width=0.01\paperwidth]{pref}
\textbf{PREF}) on the Main Menu, or the remote control (if used).

\item At the \textbf{Change Preferences} screen, click the
  \underbar{Change Message Forwarding and Notification Addresses} link.
\item Type your desired forward address in the text field
  labeled \textbf{New Forwarding Address(es)}. This should be one or
  more LON-CAPA addresses, like ``user:domain'', separated by commas.
\item Click the \fbox{Change} button.

\end{enumerate}

\textbf{Receive an e-mail message notifying you when a LON-CAPA message is sent to you}


LON-CAPA can also send new message notifications to your conventional
email accounts. You can choose the specific types of messages
which will cause notifications to be sent to the email addresses
you provide. The specific types of message  
are: critical messages, standard messages or any message. The notification email
will include an excerpt of the text contained in the body of the original LON-CAPA
message.

To receive notification email do the following:

\begin{enumerate} 

\item Click "Set my user Preferences" (\includegraphics[width=0.01\paperwidth]{pref}
\textbf{PREF}) on the Main Menu, or the remote control (if used).

\item At the \textbf{Change Preferences} screen, click the 
  \underbar{Change Message Forwarding and Notification Addresses} link.
\item In the ``Notification E-mail Address(es)'' section, check the checkbox labeled \textbf{Add new address}
\item Type a notification address into the text field
   labeled \textbf{Notification address}. This should be an Internet email
   address like ``user@example.com''.
\item Use the radio buttons to select which types of LON-CAPA message should
 cause a notification email to be sent to the specified address.
\item Choose whether you want any HTML tags contained in the original message body
 to be preserved in the excerpt included in the notification email.
\item Click the \fbox{Change} button.
\item Repeat this procedure to add more notification email addresses, one address at a time.  

\end{enumerate}

Index: loncom/html/adm/help/tex/Prefs_Notification.tex
+++ loncom/html/adm/help/tex/Prefs_Notification.tex
\label{Prefs_Notification}
\textbf{Receive an e-mail message notifying you when a LON-CAPA message is sent to you}

LON-CAPA can send new message notifications to your conventional
email accounts. You can choose the specific types of messages
which will cause notifications to be sent to the email addresses
you provide. The specific types of message
are: critical messages, standard messages or any message. The notification email
will include an excerpt of the text contained in the body of the original LON-CAPA
message.

To receive notification email do the following:

\begin{enumerate}

\item Click "Set my user Preferences" (\includegraphics[width=0.01\paperwidth]{pref}
\textbf{PREF}) on the Main Menu, or the remote control (if used).

\item At the \textbf{Change Preferences} screen, click the
  \underbar{Change Message Forwarding and Notification Addresses} link.
\item In the ``Notification E-mail Address(es)'' section, check the checkbox labeled \textbf{Add new address} 
\item Type a notification address into the text field
   labeled \textbf{Notification address}. This should be an Internet email
   address like ``user@example.com''.
\item Use the radio buttons to select which types of LON-CAPA message should
 cause a notification email to be sent to the specified address.
\item Choose whether you want any HTML tags contained in the original message body
 to be preserved in the excerpt included in the notification email.
\item Click the \fbox{Change} button.
\item Repeat this procedure to add more notification email addresses, one address at a time.

\end{enumerate}

--raeburn1200889849--