1: # The LearningOnline Network
2: # Syllabus
3: #
4: # $Id: lonsyllabus.pm,v 1.63 2008/01/16 17:13:57 bisitz 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 $start_page =
114: &Apache::loncommon::start_page("Syllabus", $rss_link,
115: {'function' => $forcestudent,
116: 'domain' => $cdom,
117: 'force_register' =>
118: $env{'form.register'},});
119:
120: $r->print($start_page.'<h1>'.$courseenv{'description'}.'</h1><h3>'.
121: &Apache::lonnet::domain($cdom,'description').'</h3>');
122: } else {
123: $r->print('\noindent{\large\textbf{'.$courseenv{'description'}.'}}\\\\\\\\\textbf{'.
124: &Apache::lonnet::domain($cdom,'description').'}\\\\');
125: }
126: # -------------------------------------------------------------- Announcements?
127: my $day = &Apache::lonannounce::showday(time,2,
128: &Apache::lonannounce::readcalendar($cdom.'_'.$cnum));
129: if ($target ne 'tex') {
130: $r->print($day. &Apache::lonrss::advertisefeeds($cnum,$cdom,$forceedit));
131: } else {
132: $r->print(&Apache::lonxml::xmlparse($r,'tex',$day));
133: }
134:
135: # -------------------------------------------------------- Get course personnel
136: my %coursepersonnel=&Apache::lonnet::get_course_adv_roles($cdom.'/'.$cnum);
137: if ($target ne 'tex') {
138: $r->print(&Apache::loncommon::start_data_table());
139: } else {
140: $r->print('\begin{tabular}{|p{0.45\textwidth}|p{0.45\textwidth}|}\hline');
141: }
142: foreach my $element (sort keys %coursepersonnel) {
143: if ($target ne 'tex') {
144: $r->print(&Apache::loncommon::start_data_table_row().
145: '<td>'.$element.'</td><td>');
146: } else {
147: $r->print(' '.&Apache::lonxml::xmlparse($r,'tex',$element).' & ');
148: }
149: foreach (split(/\,/,$coursepersonnel{$element})) {
150: my ($puname,$pudom)=split(/\:/,$_);
151: if ($target ne 'tex') {
152: $r->print(' '.&Apache::loncommon::aboutmewrapper(
153: &Apache::loncommon::plainname($puname,
154: $pudom),$puname,$pudom));
155: } else {
156: $r->print(' '.&Apache::loncommon::plainname($puname,
157: $pudom).' ');
158: }
159: }
160: if ($target ne 'tex') {
161: $r->print('</td>'.&Apache::loncommon::end_data_table_row());
162: } else {
163: $r->print('\\\\ \hline');
164: }
165: }
166: if ($target ne 'tex') {
167: $r->print(&Apache::loncommon::end_data_table());
168: } else {
169: $r->print('\end{tabular}\\\\');
170: }
171: # ---------------------------------------------------------- Load syllabus info
172: my %syllabus=&Apache::lonnet::dump('syllabus',$cdom,$cnum);
173: my $allowed=0;
174: my $privileged=0;
175:
176: # This handler might be called anonymously ...
177: # ----------------------------------------------------- Only if not public call
178: if ($env{'user.environment'}) {
179: # does this user have privileges to post, etc?
180: if ($env{'request.course.id'}
181: && $cdom eq $env{'course.'.$env{'request.course.id'}.'.domain'}
182: && $cnum eq $env{'course.'.$env{'request.course.id'}.'.num'}) {
183: $allowed=&Apache::lonnet::allowed('mdc',$env{'request.course.id'});
184: $privileged=$allowed;
185: if (($syllabus{'uploaded.lastmodified'}) && (!$forceedit)) {
186: $forcestudent='student';
187: }
188: if ($forcestudent or $target eq 'tex') { $allowed=0; }
189: }
190: if ($allowed) {
191: $r->print('<p>'.
192: &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')
193: .' <tt>http://'.
194: &Apache::lonnet::hostname($homeserver).$r->uri.'</tt>'.
195: &Apache::loncommon::help_open_topic('Syllabus_ExtLink').'</p>'.
196: '<p>'.&mt('You can specify an external URL as Syllabus in the [_1].','<a href="/adm/parmset?action=crsenv">'.&mt('Course Parameters').'</a>').'</p>'.
197: '<p><a href="'.$r->uri.'?forcestudent=1"><font size="+1">'.
198: &mt('Show Public View').'</font></a>'.
199: &Apache::loncommon::help_open_topic('Uploaded_Templates_PublicView').
200: '</p>');
201: } elsif ($privileged) {
202: if ($target ne 'tex') {
203: $r->print('<p><a href="'.$r->uri.'?forceedit=1"><font size="+1">'.
204: &mt('Edit').'</font></a>');
205: }
206: }
207: if (($allowed) && ($env{'form.storesyl'})) {
208: foreach my $syl_field (keys(%syllabusfields)) {
209: my $field=$env{'form.'.$syl_field};
210: chomp($field);
211: $field=~s/\s+$//s;
212: $field=~s/^\s+//s;
213: $field=~s/\<br\s*\/*\>$//s;
214: $field=&Apache::lonfeedback::clear_out_html($field,1);
215: $syllabus{$syl_field}=$field;
216: if ($syl_field eq 'lll_includeurl') { # clean up included URLs
217: my $field='';
218: foreach my $value (split(/\n/,$syllabus{$syl_field})) {
219: my $url=$value;
220: # get rid of leading and trailing spaces
221: $url=~s/^\s+//;
222: $url=~s/\s+$//;
223: if ($url=~m|^http://([^/]+)/(.+)$|) {
224: my $host = $1;
225: my $remainder=$2;
226: # remove the hostname from internal URLs
227: my $hostname = &Apache::lonnet::hostname($host);
228: my %all_hostnames = &Apache::lonnet::all_hostnames();
229: foreach my $possible_host (keys(%all_hostnames)) {
230: if ($possible_host =~ /\Q$hostname\E/i) {
231: $url=$remainder;
232: }
233: }
234: }
235: # norm internal URLs
236: unless ($url=~/^http\:/) {
237: $url=&Apache::lonnet::clutter($url);
238: }
239: # re-assemble field
240: if ($url) {
241: $field.=$url."\n";
242: }
243: }
244: $syllabus{$syl_field}=$field;
245: }
246: }
247: $syllabus{'uploaded.domain'}=$env{'user.domain'};
248: $syllabus{'uploaded.name'}=$env{'user.name'};
249: $syllabus{'uploaded.lastmodified'}=time;
250: &Apache::lonnet::put('syllabus',\%syllabus,$cdom,$cnum);
251: }
252: }
253: # ---------------------------------------------------------------- Get syllabus
254: if (($syllabus{'uploaded.lastmodified'}) || ($allowed)) {
255: my $lastmod=$syllabus{'uploaded.lastmodified'};
256: $lastmod=($lastmod?&Apache::lonlocal::locallocaltime($lastmod):&mt('never'));
257: my $who = &Apache::loncommon::aboutmewrapper(
258: &Apache::loncommon::plainname($syllabus{'uploaded.name'},
259: $syllabus{'uploaded.domain'}),$syllabus{'uploaded.name'},
260: $syllabus{'uploaded.domain'});
261: if ($target ne 'tex') {
262: $r->print('<table><tr><td>'.&mt('Last updated').':</td><td>'.
263: $lastmod.'</td><td>'.
264: ($who ? &mt('by').' '.$who
265: : '' ).
266: '</td></tr></table><p>');
267: } else {
268: $r->print('\\\\ '.&mt('Last updated').': '.$lastmod.' '.
269: ($who? &mt('by').'\\\\ '.
270: &Apache::loncommon::plainname($syllabus{'uploaded.name'},$syllabus{'uploaded.domain'})
271: :'')
272: .'\\\\');
273: }
274: if ($allowed) {
275: $r->print('<form method="post">'.
276: '<input type="hidden" name="forceedit" value="edit" />');
277: }
278: my @htmlids=();
279: foreach my $field (sort(keys(%syllabusfields))) {
280: if (($syllabus{$field}=~/\w/) || ($allowed)) {
281: my $message=$syllabus{$field};
282: if ($field eq 'lll_includeurl') { # this is the "included" field
283: my $urls=$message;
284: $message='';
285: foreach my $filelink (split(/\n/,$urls)) {
286: my $output='';
287: # embed style?
288: my ($curfext)=($filelink=~/\.([^\.]+)$/);
289: my $embstyle=&Apache::loncommon::fileembstyle($curfext);
290: if (($embstyle eq 'ssi') || ($curfext=~/\/$/)) {
291: # make ssi call and remove everything but the body contents
292: $output=&Apache::lonnet::ssi_body($filelink);
293: } elsif ($embstyle eq 'img') {
294: # embed as an image
295: $output='<img src="'.$filelink.'" />';
296: }
297: if ($target ne 'tex') {
298: $message.='<p>'.$output.'</p>';
299: } else {
300: $message.=' '.&Apache::lonxml::xmlparse($r,'tex','<p>'.$output.'</p>').' ';
301: }
302: }
303: if ($allowed) {
304: $r->print('<h3>'.$syllabusfields{$field}.
305: &Apache::loncommon::help_open_topic('Syllabus_URLs').'</h3>'.
306: '<p><a href="'.$r->uri.'?forcestudent=1"><font size="+1">'.&mt('Show Public View').'</font></a>'.
307: &Apache::loncommon::help_open_topic('Uploaded_Templates_PublicView').'</p>');
308: } else {
309: $r->print($message);
310: }
311: } else {
312: &Apache::lonfeedback::newline_to_br(\$message);
313: $message =~s|(https*://[^\s]+)|<a href="$1"><tt>$1</tt></a>|g;
314: if ($allowed) {
315: $message=&Apache::lonspeller::markeduptext($message);
316: }
317: $message=&Apache::lontexconvert::msgtexconverted($message);
318: if ($target ne 'tex') {
319: $r->print('<h3>'.$syllabusfields{$field}.'</h3><blockquote>'.
320: $message.'</blockquote>');
321: } else {
322: $r->print('\\\\\textbf{'.$syllabusfields{$field}.'}\\\\'.
323: &Apache::lonxml::xmlparse($r,'tex',$message).'\\\\');
324: }
325: push(@htmlids,$field);
326: }
327: if ($allowed) {
328: $r->print('<br /><textarea cols="80" rows="12" name="'.$field.'" id="'.$field.'">'.
329: &HTML::Entities::encode($syllabus{$field},'"&<>').
330: '</textarea> <input type="submit" name="storesyl" value="'.&mt('Save').'" />');
331: }
332: }
333: }
334: if ($allowed) {
335: $r->print('</form>'.
336: &Apache::lonhtmlcommon::htmlareaselectactive(@htmlids));
337: }
338: if ($target ne 'tex') {$r->print('</p>');} else {$r->print('\\\\');}
339: } else {
340: if ($target ne 'tex') {$r->print('<p>');} else {$r->print('\par ');}
341: $r->print(&mt('No syllabus information provided.'));
342: if ($target ne 'tex') {$r->print('</p>');}
343: }
344: if ($target ne 'tex') {
345: $r->print(&Apache::loncommon::end_page());
346: } else {
347: $r->print('\end{document}');
348: }
349: return OK;
350: }
351:
352: 1;
353: __END__
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>