1: # The LearningOnline Network with CAPA
2: # Construction Space Directory Lister
3: #
4: # $Id: lonpubdir.pm,v 1.63 2004/08/20 16:29:15 www 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:
30: package Apache::lonpubdir;
31:
32: use strict;
33: use Apache::File;
34: use File::Copy;
35: use Apache::Constants qw(:common :http :methods);
36: use Apache::loncacc;
37: use Apache::loncommon();
38: use Apache::lonhtmlcommon();
39: use Apache::lonlocal;
40: use Apache::lonmsg;
41:
42: sub handler {
43:
44: my $r=shift;
45:
46: my $fn;
47:
48:
49:
50: $fn = getEffectiveUrl($r);
51:
52: # Validate access to the construction space and get username@domain.
53:
54: my $uname;
55: my $udom;
56:
57: ($uname,$udom)=
58: &Apache::loncacc::constructaccess(
59: $fn,$r->dir_config('lonDefDomain'));
60: unless (($uname) && ($udom)) {
61: $r->log_reason($uname.' at '.$udom.
62: ' trying to list directory '.$ENV{'form.filename'}.
63: ' ('.$fn.') - not authorized',
64: $r->filename);
65: return HTTP_NOT_ACCEPTABLE;
66: }
67:
68: # Remove trailing / from directory name.
69:
70: $fn=~s/\/$//;
71:
72: unless ($fn) {
73: $r->log_reason($ENV{'user.name'}.' at '.$ENV{'user.domain'}.
74: ' trying to list empty directory', $r->filename);
75: return HTTP_NOT_FOUND;
76: }
77:
78: # ----------------------------------------------------------- Start page output
79:
80: my $thisdisfn=$fn;
81: $thisdisfn=~s/^\/home\/$uname\/public_html//; # subdirectory part of
82: # construction space.
83: my $docroot=$r->dir_config('lonDocRoot'); # Apache londocument root.
84:
85: my $resdir=$docroot.'/res/'.$udom.'/'.$uname.$thisdisfn; # Resource directory
86: my $targetdir=$udom.'/'.$uname.$thisdisfn; # Publiction target directory.
87: my $linkdir='/priv/'.$uname.$thisdisfn; # Full URL name of constr space.
88:
89: my %bombs=&Apache::lonmsg::all_url_author_res_msg($uname,$udom);
90:
91: &startpage($r, $uname, $udom, $thisdisfn); # Put out the start of page.
92:
93: # Start off the directory table.
94:
95: $r->print('<table border="0" cellspacing="2" cellpadding="2">'.
96: '<tr><th> </th><th>'.&mt('Actions').'</th><th>'.&mt('Name').'</th><th>'.
97: &mt('Title').'</th>'.
98: '<th>'.&mt('Status').'</th><th>'.&mt('Last Modified').
99: '</th></tr>');
100:
101: my $filename;
102: my $dirptr=16384; # Mask indicating a directory in stat.cmode.
103:
104: opendir(DIR,$fn);
105: my @files=sort {uc($a) cmp uc($b)} (readdir(DIR));
106: foreach my $filename (@files) {
107: my ($cdev,$cino,$cmode,$cnlink,
108: $cuid,$cgid,$crdev,$csize,
109: $catime,$cmtime,$cctime,
110: $cblksize,$cblocks)=stat($fn.'/'.$filename);
111:
112: my $extension='';
113: if ($filename=~/\.(\w+)$/) { $extension=$1; }
114: if ($cmode&$dirptr) {
115: putdirectory($r, $thisdisfn, $linkdir, $filename, $cmtime,$targetdir,\%bombs);
116: } elsif (&Apache::loncommon::fileembstyle($extension) ne 'hdn') {
117: putresource($r, $uname, $filename, $thisdisfn, $resdir,
118: $targetdir, $linkdir, $cmtime,\%bombs);
119: } else {
120: # "hidden" extension and not a directory, so hide it away.
121: }
122: }
123: closedir(DIR);
124:
125: $r->print('</table></body></html>');
126: return OK;
127: }
128: #
129: # Gets the effective URL of the request and returns it:
130: # $effn = getEffectiveUrl($r);
131: # $r - The Apache Request object.
132: sub getEffectiveUrl {
133: my $r = shift;
134: my $fn;
135:
136: if ($ENV{'form.filename'}) { # If a form filename is defined.
137: $fn=$ENV{'form.filename'};
138: #
139: # Replace the ~username of the URL with /home/username/public_html
140: # so that we don't have to worry about ~ expansion internally.
141: #
142: $fn=~s/^http\:\/\/[^\/]+\///;
143: $fn=~s/^\///;
144: $fn=~s/\~(\w+)/\/home\/$1\/public_html/;
145:
146: # Remove trailing / strings (?)
147:
148: $fn=~s/\/[^\/]+$//;
149: } else {
150: # If no form is defined, use request filename.
151: $fn = $r->filename();
152: my $lonDocRoot=$r->dir_config('lonDocRoot');
153: if ( $fn =~ /$lonDocRoot/ ) {
154: #internal authentication, needs fixup.
155: $fn = $r->uri(); # non users do not get the full path request
156: # through SCRIPT_FILENAME
157: $fn=~s|^/~(\w+)|/home/$1/public_html|;
158: }
159: }
160: $fn=~s/\/+/\//g;
161: return $fn;
162: }
163: #
164: # Output the header of the page. This includes:
165: # - The HTML header
166: # - The H1/H3 stuff which includes the directory.
167: #
168: # startpage($r, $uame, $udom, $thisdisfn);
169: # $r - The apache request object.
170: # $uname - User name.
171: # $udom - Domain name the user is logged in under.
172: # $thisdisfn - Displayable version of the filename.
173:
174: sub startpage {
175: my ($r, $uname, $udom, $thisdisfn) = @_;
176:
177: &Apache::loncommon::content_type($r,'text/html');
178: $r->send_http_header;
179:
180: $r->print('<html><head><title>LON-CAPA Construction Space</title></head>');
181:
182: $r->print(&Apache::loncommon::bodytag(undef,undef,undef,1));
183: my $pubdirscript=(<<ENDPUBDIRSCRIPT);
184: <script>
185: // Store directory location for menu bar to find
186:
187: parent.lastknownpriv='/~$uname/$thisdisfn/';
188:
189: // Confirmation dialogues
190:
191: function pubdir(theform) {
192: if (confirm('Publish complete directory?')) {
193: theform.submit();
194: }
195: }
196: function pubrecdir(theform) {
197: if (confirm('Publish directory and all subdirectories?')) {
198: theform.pubrec.value='1';
199: theform.submit();
200: }
201: }
202: </script>
203: ENDPUBDIRSCRIPT
204:
205: $r->print('<h2>'.&mt('Construction Space Directory').'</h2>'.
206: '<script type="text/javascript">top.document.title = \''.
207: $thisdisfn.'/ - LON-CAPA Construction Space\';</script>'.
208: $pubdirscript.
209: '<form method="post" action="/adm/publish" target="_parent">'.
210: '<table><tr><td><input type="hidden" name="filename" value="/~'.
211: $uname.$thisdisfn.'/" />'.
212: '<input type="button" onClick="pubdir(this.form);" value="'.
213: &mt('Publish Directory').'" />'.
214: '<input type="hidden" name="pubrec" value="" />'.
215: '<input type="button" onClick="pubrecdir(this.form);" value="'.
216: &mt('Publish Directory and Sub Directories').'" /></td><td>'.
217: '<input type="button" onClick="window.location='."'/~".
218: $uname.$thisdisfn."/default.meta'".'" value="'.
219: &mt('Edit Directory Catalog Information').'" /></td></tr><tr><td><input type="checkbox" name="forcerepub" /> '.&mt('Force publication of unmodified files').'.</td><td> </td></tr></table></form>');
220:
221: if (($uname ne $ENV{'user.name'}) || ($udom ne $ENV{'user.domain'})) {
222: $r->print('<h3>'.&mt('Co-Author').': '.$uname.' at '.$udom.
223: '</h3>');
224: }
225: my $formaction='/priv/'.$uname.'/'.$thisdisfn.'/';
226: $formaction=~s/\/+/\//g;
227: $r->print('<form name="dirs" method="post" action="'.$formaction
228: .'" target="_top">'.
229: &Apache::lonhtmlcommon::crumbs($uname.'/'.$thisdisfn.'/','_top','/priv').
230: &Apache::lonhtmlcommon::select_recent('construct','recent',
231: 'this.form.action=this.form.recent.value;this.form.submit()').
232: '</form>');
233: &Apache::lonhtmlcommon::store_recent('construct',$formaction,$formaction);
234: }
235:
236: #
237: # Get the title string or "[untitled]" if the file has no title metadata:
238: # Without the latter substitution, it's impossible to examine metadata for
239: # untitled resources. Resources may be legitimately untitled, to prevent
240: # searches from locating them.
241: #
242: # $str = getTitleString($fullname);
243: # $fullname - Fully qualified filename to check.
244: #
245: sub getTitleString {
246: my $fullname = shift;
247: my $title = &Apache::lonnet::metadata($fullname, 'title');
248:
249: unless ($title) {
250: $title = "[".&mt('untitled')."]";
251: }
252: return $title;
253: }
254:
255: sub getCopyRightString {
256: my $fullname = shift;
257: return &Apache::lonnet::metadata($fullname, 'copyright');
258: }
259:
260: sub getSourceRightString {
261: my $fullname = shift;
262: return &Apache::lonnet::metadata($fullname, 'sourceavail');
263: }
264: #
265: # Put out a directory table row:
266: # putdirectory(r, base, here, dirname, modtime)
267: # r - Apache request object.
268: # reqfile - File in request.
269: # here - Where we are in directory tree.
270: # dirname - Name of directory special file.
271: # modtime - Encoded modification time.
272: #
273: sub putdirectory {
274: my ($r, $reqfile, $here, $dirname, $modtime, $resdir, $bombs) = @_;
275:
276: # construct the display filename: the directory name unless ..:
277:
278: my $disfilename = $dirname;
279: if ($dirname eq '..') {
280: $disfilename = '<i>'.&mt('Parent Directory').'</i>';
281: }
282: unless (( ($dirname eq '..') && ($reqfile eq '')) ||
283: ($dirname eq '.')) {
284: my $kaputt=0;
285: foreach (keys %{$bombs}) {
286: if ($_=~m:^\Q$resdir\E/\Q$disfilename\E/:) { $kaputt=1; last; }
287: }
288: %Apache::lonpublisher::metadatafields=();
289: %Apache::lonpublisher::metadatakeys=();
290: my $construct=$here;
291: $construct=~s:^/priv/(\w+)$:/home/$1/public_html:;
292: &Apache::lonpublisher::metaeval(&Apache::lonnet::getfile(
293: $construct.'/'.$dirname.'/default.meta'
294: ));
295: $r->print('<tr bgcolor="#CCCCFF">'.
296: '<td><img src="'.
297: $Apache::lonnet::perlvar{'lonIconsURL'}.'/folder_closed.gif" /></td>'.
298: '<td>'.&mt('Go to ...').'</td>'.
299: '<td><font face="arial"><a href="'.$here.'/'.$dirname.'/" target="_top">'.
300: $disfilename.'</a></font></td>'.
301: '<td colspan="2">'.($kaputt?&Apache::lonhtmlcommon::authorbombs($resdir.'/'.$disfilename.'/'):'').$Apache::lonpublisher::metadatafields{'title'}.' <i>'.
302: $Apache::lonpublisher::metadatafields{'subject'}.'</i> '.
303: $Apache::lonpublisher::metadatafields{'keywords'}.'</td>'.
304: '<td>'.&Apache::lonlocal::locallocaltime($modtime).'</td>'.
305: "</tr>\n");
306: }
307: return OK;
308: }
309: #
310: # Put a table row for a file resource.
311: #
312: sub putresource {
313: my ($r, $uname, $filename, $thisdisfn,
314: $resdir, $targetdir, $linkdir,
315: $cmtime,$bombs) = @_;
316:
317: my $status=&mt('Unpublished');
318: my $bgcolor='#FFAA99';
319: my $title=' ';
320: my $publish_button=&mt('Publish');
321: my $action_buttons=
322: '<br /><a target="_top" href="/adm/cfile?action=delete&filename=/~'.
323: $uname.'/'.$thisdisfn.'/'.$filename.'">'.
324: &mt('Delete').'</a>';
325: if (-e $resdir.'/'.$filename) {
326: my ($rdev,$rino,$rmode,$rnlink,
327: $ruid,$rgid,$rrdev,$rsize,
328: $ratime,$rmtime,$rctime,
329: $rblksize,$rblocks)=stat($resdir.'/'.$filename);
330: $publish_button=&mt('Re-Publish');
331: if ($rmtime>=$cmtime) {
332: $status=&mt('Published').'<br />'.
333: &mt(&getCopyRightString($targetdir.'/'.$filename)).' '.
334: &mt(&getSourceRightString($targetdir.'/'.$filename));
335: $bgcolor='#CCFF88';
336: if (&Apache::lonnet::metadata($targetdir.'/'.$filename,'obsolete')) {
337: $status=&mt('Obsolete');
338: $bgcolor='#AAAAAA';
339: } else {
340: $action_buttons='';
341: }
342: $title='<a href="/res/'.$targetdir.'/'.$filename.
343: '.meta" target=cat>'.
344: &getTitleString($targetdir.'/'.$filename).'</a>';
345: } else {
346: $status=&mt('Modified').'<br />'.
347: &mt(&getCopyRightString($targetdir.'/'.$filename)).' '.
348: &mt(&getSourceRightString($targetdir.'/'.$filename));
349: $bgcolor='#FFFF77';
350: $action_buttons='';
351: $title='<a href="/res/'.$targetdir.'/'.$filename.'.meta" target=cat>'.
352: &getTitleString($targetdir.'/'.$filename).'</a>';
353: if (&Apache::loncommon::fileembstyle(($filename=~/\.(\w+)$/)) eq 'ssi') {
354: $status.='<br /><a href="/adm/diff?filename=/~'.$uname.
355: $thisdisfn.'/'.$filename.
356: '&versiontwo=priv" target=cat>'.&mt('Diffs').'</a>';
357: }
358: }
359: $title.='<br /><a href="/~'.$uname.$thisdisfn.'/'.$filename.'.meta">'.
360: ($$bombs{$targetdir.'/'.$filename}?'<img src="/adm/lonMisc/bomb.gif" border="0" />':'Edit Metadata').'</a>';
361: $status.='<br><a href="/adm/retrieve?filename=/~'.$uname.
362: $thisdisfn.'/'.$filename.'" target="_top">'.&mt('Retrieve').'</a>';
363: }
364: my $editlink='';
365: my $editlink2='';
366: if ($filename=~/\.(xml|html|htm|xhtml|xhtm|sty)$/) {
367: $editlink=' <br />(<a href="'.$linkdir.'/'.$filename.'?forceedit=1" target="_top">'.&mt('Edit').'</a>)';
368: }
369: if ($filename=~/\.(problem|exam|quiz|assess|survey|form|library)$/) {
370: $editlink=' (<a href="'.$linkdir.'/'.$filename.'?forceedit=1" target="_top">'.&mt('EditXML').'</a>)';
371: $editlink2=' <br />(<a href="'.$linkdir.'/'.$filename.'?forceColoredit=1" target="_top">'.&mt('Edit').'</a>)';
372: }
373: if ($filename=~/\.(zip|tar|bz2|gz|tar.gz|tar.bz2|tgz)$/) {
374: $editlink=' (<a target="_parent" href="/adm/cfile?decompress=/~'.
375: $uname.$thisdisfn.'/'.$filename.'">'.&mt('Decompress').'</a>)';
376: }
377: $r->print('<tr bgcolor="'.$bgcolor.'">'.
378: '<td>'.($filename=~/[\#\~]$/?' ':
379: '<img src="'.&Apache::loncommon::icon($filename).'" /></td>').
380: '<td><a target="_parent" href="/adm/publish?filename=/~'.
381: $uname.$thisdisfn.'/'.$filename.'">'.$publish_button.'</a>'.
382: $action_buttons.
383: '</td>'.
384: '<td><font face="arial">'.
385: '<a href="'.$linkdir.'/'.$filename.'" target="_top">'.
386: $filename.'</a></font>'.$editlink2.$editlink.
387: '</td>'.
388: '<td>'.$title.'</td>'.
389: '<td>'.$status.'</td>'.
390: '<td>'.&Apache::lonlocal::locallocaltime($cmtime).'</td>'.
391: "</tr>\n");
392: return OK;
393: }
394: #
395: # Categorize files in the directory.
396: # For each file in a list of files in a file directory,
397: # the file categorized as one of:
398: # - directory
399: # - sequence
400: # - problem
401: # - Other resource.
402: #
403: # For each file the modification date is determined as well.
404: # Returned is a list of sublists:
405: # (directories, sequences, problems, other)
406: # each of the sublists contains entries of the following form (sorted by
407: # filename):
408: # (filename, typecode, lastmodtime)
409: #
410: # $list = CategorizeFiles($location, $files)
411: # $location - Directory in which the files live (relative to our
412: # execution.
413: # $files - list of files.
414: #
415: sub CategorizeFiles {
416: my $location = shift;
417: my $files = shift;
418: }
419:
420: 1;
421: __END__
422:
423: =head1 NAME
424:
425: Apache::lonpubdir - Construction space directory lister
426:
427: =head1 SYNOPSIS
428:
429: Invoked (for various locations) by /etc/httpd/conf/srm.conf:
430:
431: <LocationMatch "^/\~.*/$">
432: PerlAccessHandler Apache::loncacc
433: SetHandler perl-script
434: PerlHandler Apache::lonpubdir
435: ErrorDocument 403 /adm/login
436: ErrorDocument 404 /adm/notfound.html
437: ErrorDocument 406 /adm/unauthorized.html
438: ErrorDocument 500 /adm/errorhandler
439: </LocationMatch>
440:
441: <Location /adm/pubdir>
442: PerlAccessHandler Apache::lonacc
443: SetHandler perl-script
444: PerlHandler Apache::lonpubdir
445: ErrorDocument 403 /adm/login
446: ErrorDocument 404 /adm/notfound.html
447: ErrorDocument 406 /adm/unauthorized.html
448: ErrorDocument 500 /adm/errorhandler
449: </Location>
450:
451: =head1 INTRODUCTION
452:
453: This module publishes a directory of files.
454:
455: This is part of the LearningOnline Network with CAPA project
456: described at http://www.lon-capa.org.
457:
458: =head1 HANDLER SUBROUTINE
459:
460: This routine is called by Apache and mod_perl.
461:
462: =over 4
463:
464: =item *
465:
466: read in information
467:
468: =item *
469:
470: start page output
471:
472: =item *
473:
474: run through list of files and attempt to publish unhidden files
475:
476: =back
477:
478: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>