File:  [LON-CAPA] / loncom / interface / lonsyllabus.pm
Revision 1.67: download - view: text, annotated - select for diffs
Mon Aug 25 14:50:01 2008 UTC (15 years, 9 months ago) by raeburn
Branches: MAIN
CVS tags: version_2_7_X, version_2_7_1, version_2_7_0, HEAD
- Move closing paren to the correct location.

    1: # The LearningOnline Network
    2: # Syllabus
    3: #
    4: # $Id: lonsyllabus.pm,v 1.67 2008/08/25 14:50:01 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: package Apache::lonsyllabus;
   30: 
   31: use strict;
   32: use Apache::Constants qw(:common);
   33: use Apache::loncommon;
   34: use Apache::lonnet;
   35: use Apache::lontexconvert;
   36: use Apache::lonfeedback;
   37: use Apache::lonannounce;
   38: use Apache::lonlocal;
   39: use Apache::lonhtmlcommon;
   40: use Apache::lonspeller();
   41: use HTML::Entities();
   42: 
   43: sub handler {
   44:     my $r = shift;
   45:     &Apache::loncommon::content_type($r,'text/html');
   46:     $r->send_http_header;
   47:     return OK if $r->header_only;
   48: 
   49:     my $target=$env{'form.grade_target'};
   50: # --------------------------------------------------- Get course info from URL
   51:     my (undef,undef,$cdom,$cnum)=split(/\//,$r->uri);
   52: # ------------------------------------------------------------ Get query string
   53:     &Apache::loncommon::get_unprocessed_cgi
   54:                         ($ENV{'QUERY_STRING'},['forcestudent','register','forceedit','wrapperdisplay']);
   55: # ----------------------------------------------------- Is this even a course?
   56:     my $homeserver=&Apache::lonnet::homeserver($cnum,$cdom);
   57:     if ($homeserver eq 'no_host') {
   58:         &Apache::loncommon::content_type($r,'text/html');
   59:         $r->send_http_header;
   60:       	&Apache::loncommon::simple_error_page($r,'No syllabus available',
   61: 					      'No syllabus available');
   62:         return OK;
   63:     }
   64: # ------------------------------------- There is such a course, get environment
   65:     my %courseenv=&Apache::lonnet::dump('environment',$cdom,$cnum);
   66: 
   67: # ------------------------------------------------------------ Print the screen
   68: 
   69:     if ($target eq 'tex') {
   70: 	$r->print(&Apache::lonprintout::print_latex_header($env{'form.latex_type'}));
   71:     } 
   72: # -------------------------------------------------- Let's see who handles this
   73:     my $externalsyllabus=$courseenv{'externalsyllabus'};
   74: 
   75:     if ($externalsyllabus=~/\w/) {
   76: 	
   77:        if ($env{'form.wrapperdisplay'} eq 'menu') {
   78: 	   $r->print(&Apache::lonwrapper::simple_menu());
   79:        } else {	    
   80: 	   $r->print(&Apache::lonwrapper::wrapper("/public/$cdom/$cnum/syllabus?wrapperdisplay=menu",
   81: 						   $externalsyllabus));
   82:        }
   83:        return OK;
   84:      } 
   85: 
   86: # ------------------------------ The buck stops here: internal syllabus display
   87: # --------------------------------------------------------- The syllabus fields
   88:     my %syllabusfields=&Apache::lonlocal::texthash(
   89:        'aaa_instructorinfo' => 'Instructor Information',
   90:        'bbb_description'    => 'Course Description',
   91:        'ccc_prereq'         => 'Prerequisites',
   92:        'cdc_classhours'     => 'Class Hours',
   93:        'ddd_officehours'    => 'Office Hours',
   94:        'eee_helproom'       => 'Helproom Hours',
   95:        'efe_projectinfo'    => 'Project Information',
   96:        'fff_examinfo'       => 'Exam Information',
   97:        'fgf_deadlines'      => 'Deadlines',
   98:        'ggg_grading'        => 'Grading Information',
   99:        'hhh_readings'       => 'Readings',
  100:        'iii_coursepack'     => 'Coursepack',
  101:        'jjj_weblinks'       => 'Web Links',
  102:        'kkk_textbook'       => 'Textbook',
  103:        'lll_includeurl'     => 'URLs To Include in Syllabus');
  104: # --------------------------------------------------------------- Force Student
  105:     my $forcestudent='';
  106:     if ($env{'form.forcestudent'}) { $forcestudent='student'; };
  107:     my $forceedit='';
  108:     if ($env{'form.forceedit'}) { $forceedit='edit'; }
  109:        
  110: # ----------------------------------------------------------------- Make header 
  111:     if ($target ne 'tex') {
  112: 	my $rss_link = &Apache::lonrss::rss_link($cnum,$cdom);
  113:         my $js;
  114:         if ($env{'form.backto'} eq 'coursecatalog') {
  115:             $js .= <<"ENDSCRIPT";
  116: 
  117: <script type="text/javascript">
  118: function ToCatalog(caller) {
  119:     numidx = getIndexByName('coursenum');
  120:     if (numidx > -1) {
  121:         if (caller != 'details') {
  122:             document.backtocat.elements[numidx].value = '';
  123:         }
  124:     }
  125:     document.backtocat.submit();
  126: }
  127: 
  128: function getIndexByName(item) {
  129:     for (var i=0;i<document.backtocat.elements.length;i++) {
  130:         if (document.backtocat.elements[i].name == item) {
  131:             return i;
  132:         }
  133:     }
  134:     return -1;
  135: }
  136: 
  137: </script>
  138: 
  139: ENDSCRIPT
  140:         }
  141: 	my $start_page = 
  142: 	    &Apache::loncommon::start_page("Syllabus", $rss_link.$js,
  143: 					   {'function'       => $forcestudent,
  144: 					    'domain'         => $cdom,
  145: 					    'force_register' =>
  146: 						$env{'form.register'},});
  147: 
  148: 	$r->print($start_page);
  149:         if ($env{'form.backto'} eq 'coursecatalog') {
  150:             &Apache::lonhtmlcommon::clear_breadcrumbs();
  151:             &Apache::lonhtmlcommon::add_breadcrumb
  152:              ({href=>"javascript:ToCatalog()",
  153:                text=>"Course Catalog"});
  154:             if ($env{'form.coursenum'} ne '') {
  155:                 &Apache::lonhtmlcommon::add_breadcrumb
  156:                   ({href=>"javascript:ToCatalog('details')",
  157:                    text=>"Course details"});
  158:             }
  159:             &Apache::lonhtmlcommon::add_breadcrumb
  160:               ({href=>$r->uri,
  161:                text=>"Course syllabus"});
  162:             $r->print(&Apache::lonhtmlcommon::breadcrumbs());
  163:         }
  164:         $r->print('<h1>'.$courseenv{'description'}.'</h1><h3>'.
  165: 		  &Apache::lonnet::domain($cdom,'description').'</h3>');
  166:     } else {
  167: 	$r->print('\noindent{\large\textbf{'.$courseenv{'description'}.'}}\\\\\\\\\textbf{'.
  168: 		  &Apache::lonnet::domain($cdom,'description').'}\\\\');
  169:     }
  170: # -------------------------------------------------------------- Announcements?
  171:     my $day = &Apache::lonannounce::showday(time,2,
  172: 			 &Apache::lonannounce::readcalendar($cdom.'_'.$cnum));
  173:     if ($target ne 'tex') {
  174: 	$r->print($day. &Apache::lonrss::advertisefeeds($cnum,$cdom,$forceedit));
  175:     } else {
  176: 	$r->print(&Apache::lonxml::xmlparse($r,'tex',$day));
  177:     }
  178: 
  179: # -------------------------------------------------------- Get course personnel
  180:     my %coursepersonnel=&Apache::lonnet::get_course_adv_roles($cdom.'/'.$cnum);
  181:     if ($target ne 'tex') {
  182: 	$r->print(&Apache::loncommon::start_data_table());
  183:     } else {
  184: 	$r->print('\begin{tabular}{|p{0.45\textwidth}|p{0.45\textwidth}|}\hline');
  185:     }
  186:     foreach my $element (sort keys %coursepersonnel) {
  187: 	if ($target ne 'tex') {
  188: 	    $r->print(&Apache::loncommon::start_data_table_row().
  189: 		      '<td>'.$element.'</td><td>');
  190: 	} else {
  191: 	    $r->print(' '.&Apache::lonxml::xmlparse($r,'tex',$element).' & '); 
  192: 	}
  193:         foreach (split(/\,/,$coursepersonnel{$element})) {
  194: 	    my ($puname,$pudom)=split(/\:/,$_);
  195: 	    if ($target ne 'tex') {
  196:                 my $courseperson = &Apache::loncommon::plainname($puname,$pudom);
  197:                 if (($env{'user.name'} eq '') || ($env{'user.name'} eq 'public') ||
  198:                     ($env{'user.domain'} eq '') || ($env{'user.domain'} eq 'public')) {
  199: 		    $r->print(' '.$courseperson);
  200:                 } else {
  201:                     $r->print(' '.&Apache::loncommon::aboutmewrapper($courseperson,
  202:                               $puname,$pudom));
  203:                 }
  204: 	    } else {
  205: 		$r->print(' '.&Apache::loncommon::plainname($puname,
  206:                               $pudom).' ');
  207: 	    }
  208: 	}
  209: 	if ($target ne 'tex') {
  210: 	    $r->print('</td>'.&Apache::loncommon::end_data_table_row());
  211: 	} else {
  212: 	    $r->print('\\\\ \hline');
  213: 	}
  214:     }
  215:     if ($target ne 'tex') {
  216: 	$r->print(&Apache::loncommon::end_data_table());
  217:     } else {
  218: 	$r->print('\end{tabular}\\\\');
  219:     }
  220: # ---------------------------------------------------------- Load syllabus info
  221:     my %syllabus=&Apache::lonnet::dump('syllabus',$cdom,$cnum);
  222:     my $allowed=0;
  223:     my $privileged=0;
  224: 
  225: # This handler might be called anonymously ...
  226: # ----------------------------------------------------- Only if not public call
  227:     if ($env{'user.environment'}) {
  228: # does this user have privileges to post, etc?
  229:        if ($env{'request.course.id'}
  230: 	   && $cdom eq $env{'course.'.$env{'request.course.id'}.'.domain'}
  231: 	   && $cnum eq $env{'course.'.$env{'request.course.id'}.'.num'}) {
  232:           $allowed=&Apache::lonnet::allowed('mdc',$env{'request.course.id'});
  233: 	  $privileged=$allowed;
  234: 	  if (($syllabus{'uploaded.lastmodified'}) && (!$forceedit)) {
  235: 	      $forcestudent='student';
  236: 	  }
  237:           if ($forcestudent or $target eq 'tex') { $allowed=0; }
  238:        }
  239:        if ($allowed) {
  240:           $r->print('<p>'.
  241: &Apache::loncommon::help_open_topic('Uploaded_Templates_TextBoxes',&mt('Help with filling in text boxes')).'</p><p>'.&mt('This syllabus can be publicly viewed at')
  242: 		    .' <tt>http://'.
  243: 		    &Apache::lonnet::hostname($homeserver).$r->uri.'</tt>'.
  244:                &Apache::loncommon::help_open_topic('Syllabus_ExtLink').'</p>'.
  245:           '<p>'.&mt('You can specify an external URL as Syllabus in the [_1].','<a href="/adm/parmset?action=crsenv">'.&mt('Course Parameters').'</a>').'</p>'.
  246: 	  '<p><a href="'.$r->uri.'?forcestudent=1"><font size="+1">'.
  247: &mt('Show Public View').'</font></a>'.
  248:           &Apache::loncommon::help_open_topic('Uploaded_Templates_PublicView').
  249:           '</p>');
  250:       } elsif ($privileged) {
  251: 	  if ($target ne 'tex') {
  252: 	      $r->print('<p><a href="'.$r->uri.'?forceedit=1"><font size="+1">'.
  253: 			&mt('Edit').'</font></a>'); 
  254: 	  }
  255:       }
  256:        if (($allowed) && ($env{'form.storesyl'})) {
  257: 	   foreach my $syl_field (keys(%syllabusfields)) {
  258:                my $field=$env{'form.'.$syl_field};
  259: 	       chomp($field);
  260:                $field=~s/\s+$//s;
  261: 	       $field=~s/^\s+//s;
  262: 	       $field=~s/\<br\s*\/*\>$//s;
  263: 	       $field=&Apache::lonfeedback::clear_out_html($field,1);
  264: 	       $syllabus{$syl_field}=$field;
  265:                if ($syl_field eq 'lll_includeurl') { # clean up included URLs
  266:                   my $field='';
  267: 	          foreach my $value (split(/\n/,$syllabus{$syl_field})) {
  268: 		      my $url=$value;
  269: # get rid of leading and trailing spaces
  270:                       $url=~s/^\s+//;
  271:                       $url=~s/\s+$//;
  272:                       if ($url=~m|^http://([^/]+)/(.+)$|) {
  273: 			  my $host = $1;
  274:                           my $remainder=$2;
  275: # remove the hostname from internal URLs
  276: 			  my $hostname = &Apache::lonnet::hostname($host);
  277: 			  my %all_hostnames = &Apache::lonnet::all_hostnames();
  278: 		          foreach my $possible_host (keys(%all_hostnames)) {
  279:                               if ($possible_host =~ /\Q$hostname\E/i) {
  280: 			         $url=$remainder;
  281: 			      }
  282: 		          }
  283: 		      }
  284: # norm internal URLs
  285:                       unless ($url=~/^http\:/) {
  286: 		          $url=&Apache::lonnet::clutter($url);
  287:                       }
  288: # re-assemble field
  289:                       if ($url) {
  290: 		          $field.=$url."\n";
  291:                       }
  292: 		  }
  293:                   $syllabus{$syl_field}=$field;
  294: 	      }
  295:            }
  296:            $syllabus{'uploaded.domain'}=$env{'user.domain'};
  297:            $syllabus{'uploaded.name'}=$env{'user.name'};
  298:            $syllabus{'uploaded.lastmodified'}=time;
  299:            &Apache::lonnet::put('syllabus',\%syllabus,$cdom,$cnum);
  300:        }
  301:     }
  302: # ---------------------------------------------------------------- Get syllabus
  303:     if (($syllabus{'uploaded.lastmodified'}) || ($allowed)) {
  304:        my $lastmod=$syllabus{'uploaded.lastmodified'};
  305:        $lastmod=($lastmod?&Apache::lonlocal::locallocaltime($lastmod):&mt('never'));
  306:        my $who = &Apache::loncommon::aboutmewrapper(
  307:                     &Apache::loncommon::plainname($syllabus{'uploaded.name'},
  308:                      $syllabus{'uploaded.domain'}),$syllabus{'uploaded.name'},
  309:                      $syllabus{'uploaded.domain'});
  310:        if ($target ne 'tex') {
  311: 	   $r->print('<table><tr><td>'.&mt('Last updated').':</td><td>'.
  312: 		     $lastmod.'</td><td>'.
  313: 		     ($who ? &mt('by').' '.$who
  314:                            : '' ).
  315: 		     '</td></tr></table><p>');
  316:        } else {
  317: 	   $r->print('\\\\ '.&mt('Last updated').': '.$lastmod.' '.
  318: 		     ($who? &mt('by').'\\\\ '.
  319: 		            &Apache::loncommon::plainname($syllabus{'uploaded.name'},$syllabus{'uploaded.domain'})
  320: 		          :'')
  321: 		     .'\\\\');
  322:        }
  323:        if ($allowed) {
  324: 	   $r->print('<form method="post">'.
  325: 		     '<input type="hidden" name="forceedit" value="edit" />');
  326:        }
  327:        my @htmlids=();
  328:        foreach my $field (sort(keys(%syllabusfields))) {
  329: 	   if (($syllabus{$field}=~/\w/) || ($allowed)) {
  330: 	       my $message=$syllabus{$field};
  331: 	       if ($field eq 'lll_includeurl') { # this is the "included" field
  332: 		   my $urls=$message;
  333: 		   $message='';
  334: 		   foreach my $filelink (split(/\n/,$urls)) {
  335: 		       my $output='';
  336: # embed style?
  337: 		       my ($curfext)=($filelink=~/\.([^\.]+)$/);
  338: 		       my $embstyle=&Apache::loncommon::fileembstyle($curfext);
  339: 		       if (($embstyle eq 'ssi') || ($curfext=~/\/$/)) {
  340: # make ssi call and remove everything but the body contents
  341: 			   $output=&Apache::lonnet::ssi_body($filelink);
  342: 		       } elsif ($embstyle eq 'img') {
  343: # embed as an image
  344: 			   $output='<img src="'.$filelink.'" />';
  345: 		       }
  346: 		       if ($target ne 'tex') {
  347: 			   $message.='<p>'.$output.'</p>';
  348: 		       } else {
  349: 			   $message.=' '.&Apache::lonxml::xmlparse($r,'tex','<p>'.$output.'</p>').' ';
  350: 		       }      
  351: 		   }
  352: 		   if ($allowed) {
  353: 		       $r->print('<h3>'.$syllabusfields{$field}.
  354: 				 &Apache::loncommon::help_open_topic('Syllabus_URLs').'</h3>'.
  355: 				 '<p><a href="'.$r->uri.'?forcestudent=1"><font size="+1">'.&mt('Show Public View').'</font></a>'.
  356: 				 &Apache::loncommon::help_open_topic('Uploaded_Templates_PublicView').'</p>');
  357: 		   } else {
  358: 		       $r->print($message);
  359: 		   } 
  360: 	       } else {
  361: 		   &Apache::lonfeedback::newline_to_br(\$message);
  362: 		   $message =~s|(https*://[^\s]+)|<a href="$1"><tt>$1</tt></a>|g;
  363: 		   if ($allowed) {
  364: 		       $message=&Apache::lonspeller::markeduptext($message);
  365: 		   }
  366: 		   $message=&Apache::lontexconvert::msgtexconverted($message);
  367: 		   if ($target ne 'tex') {
  368: 		       $r->print('<h3>'.$syllabusfields{$field}.'</h3><blockquote>'.
  369: 				 $message.'</blockquote>');
  370: 		   } else {
  371: 		       $r->print('\\\\\textbf{'.$syllabusfields{$field}.'}\\\\'.
  372: 				 &Apache::lonxml::xmlparse($r,'tex',$message).'\\\\');
  373: 		   }
  374: 		   push(@htmlids,$field);
  375: 	       }
  376: 	       if ($allowed) {
  377: 		   $r->print('<br /><textarea cols="80" rows="12" name="'.$field.'" id="'.$field.'">'.
  378: 			     &HTML::Entities::encode($syllabus{$field},'"&<>').
  379: 			     '</textarea> <input type="submit" name="storesyl" value="'.&mt('Save').'" />');
  380: 	       }
  381: 	   }
  382:        }
  383:        if ($allowed) {
  384: 	   $r->print('</form>'.
  385: 		     &Apache::lonhtmlcommon::htmlareaselectactive(@htmlids));
  386:        }
  387:        if ($target ne 'tex') {$r->print('</p>');} else {$r->print('\\\\');}
  388:     } else {
  389: 	if ($target ne 'tex') {$r->print('<p>');} else {$r->print('\par ');} 
  390: 	$r->print(&mt('No syllabus information provided.'));
  391: 	if ($target ne 'tex') {$r->print('</p>');}
  392:     }
  393:     if ($target ne 'tex') {
  394:         if ($env{'form.backto'} eq 'coursecatalog') {
  395:             $r->print('<form name="backtocat" method="post" action="/adm/coursecatalog">'.
  396:                       &Apache::lonhtmlcommon::echo_form_input(['backto','courseid']).
  397:                       '</form>');
  398:         }
  399: 	$r->print(&Apache::loncommon::end_page());
  400:     } else {
  401: 	$r->print('\end{document}');
  402:     }
  403:     return OK;
  404: } 
  405: 
  406: 1;
  407: __END__

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