1: # The LearningOnline Network with CAPA
2: # (Publication Handler
3: #
4: # $Id: lonpubdir.pm,v 1.25 2002/06/04 13:13:38 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: # (TeX Content Handler
30: #
31: # YEAR=2000
32: # 05/29/00,05/30,10/11 Gerd Kortemeyer)
33: #
34: # 11/28,11/29,11/30,12/01,12/02,12/04,12/23 Gerd Kortemeyer
35: # YEAR=2001
36: # 03/23 Guy Albertelli
37: # 03/24,03/29 Gerd Kortemeyer)
38: # 03/31,04/03,05/09,06/23,08/18,08/20 Gerd Kortemeyer
39: # 12/15 Scott Harrison
40: # 12/28 Gerd Kortemeyer
41: #
42: ###
43:
44: package Apache::lonpubdir;
45:
46: use strict;
47: use Apache::File;
48: use File::Copy;
49: use Apache::Constants qw(:common :http :methods);
50: use Apache::loncacc;
51: use Apache::loncommon();
52:
53: sub handler {
54:
55: my $r=shift;
56:
57: my $fn;
58:
59:
60:
61: $fn = getEffectiveUrl($r);
62:
63: # Validate access to the construction space and get username@domain.
64:
65: my $uname;
66: my $udom;
67:
68: ($uname,$udom)=
69: &Apache::loncacc::constructaccess(
70: $fn,$r->dir_config('lonDefDomain'));
71: unless (($uname) && ($udom)) {
72: $r->log_reason($uname.' at '.$udom.
73: ' trying to publish file '.$ENV{'form.filename'}.
74: ' ('.$fn.') - not authorized',
75: $r->filename);
76: return HTTP_NOT_ACCEPTABLE;
77: }
78:
79: # Remove trailing / from direcgtory name.
80:
81: $fn=~s/\/$//;
82:
83: unless ($fn) {
84: $r->log_reason($ENV{'user.name'}.' at '.$ENV{'user.domain'}.
85: ' trying to list empty directory', $r->filename);
86: return HTTP_NOT_FOUND;
87: }
88:
89: # ----------------------------------------------------------- Start page output
90:
91: my $thisdisfn=$fn;
92: $thisdisfn=~s/^\/home\/$uname\/public_html//; # subdirectory part of
93: # construction space.
94: my $docroot=$r->dir_config('lonDocRoot'); # Apache londocument root.
95:
96: my $resdir=$docroot.'/res/'.$udom.'/'.$uname.$thisdisfn; # Resource directory
97: my $targetdir=$udom.'/'.$uname.$thisdisfn; # Publiction target directory.
98: my $linkdir='/priv/'.$uname.$thisdisfn; # Full URL name of constr space.
99:
100:
101:
102: startpage($r, $uname, $udom, $thisdisfn); # Put out the start of page.
103:
104: # Start off the diretory table.
105:
106: $r->print('<table border=2>'.
107: '<tr><th>Actions</th><th>Name</th><th>Title</th>'.
108: '<th>Status</th><th>Last Modified</th></tr>');
109:
110: my $filename;
111: my $dirptr=16384; # Mask indicating a directory in stat.cmode.
112:
113: opendir(DIR,$fn);
114: my @files=sort(readdir(DIR));
115: foreach my $filename (@files) {
116: my ($cdev,$cino,$cmode,$cnlink,
117: $cuid,$cgid,$crdev,$csize,
118: $catime,$cmtime,$cctime,
119: $cblksize,$cblocks)=stat($fn.'/'.$filename);
120:
121: my $extension='';
122: if ($filename=~/\.(\w+)$/) { $extension=$1; }
123: if ($cmode&$dirptr) {
124: putdirectory($r, $thisdisfn, $linkdir, $filename, $cmtime);
125: } elsif (&Apache::loncommon::fileembstyle($extension) ne 'hdn') {
126: putresource($r, $uname, $filename, $thisdisfn, $resdir,
127: $targetdir, $linkdir, $cmtime);
128: } else {
129: # "hidden" extension and not a directory, so hide it away.
130: }
131: }
132: closedir(DIR);
133:
134: $r->print('</table></body></html>');
135: return OK;
136: }
137: #
138: # Gets the effective URL of the request and returns it:
139: # $effn = getEffectiveUrl($r);
140: # $r - The Apache Request object.
141: sub getEffectiveUrl {
142: my $r = shift;
143: my $fn;
144:
145: if ($ENV{'form.filename'}) { # If a form filename is defined.
146: $fn=$ENV{'form.filename'};
147: #
148: # Replace the ~username of the URL with /home/username/public_html
149: # so that we don't have to worry about ~ expansion internally.
150: #
151: $fn=~s/^http\:\/\/[^\/]+\/\~(\w+)/\/home\/$1\/public_html/;
152:
153: # Remove trailing / strings (?)
154:
155: $fn=~s/\/[^\/]+$//;
156: } else {
157: # If no form is defined, use request filename.
158: $fn = $r->filename();
159: my $lonDocRoot=$r->dir_config('lonDocRoot');
160: if ( $fn =~ /$lonDocRoot/ ) {
161: #internal authentication, needs fixup.
162: $fn = $r->uri(); # non users do not get the full path request
163: # through SCRIPT_FILENAME
164: $fn=~s|^/~(\w+)|/home/$1/public_html|;
165: }
166: }
167: return $fn;
168: }
169: #
170: # Output the header of the page. This includes:
171: # - The HTML header
172: # - The H1/H3 stuff which includes the directory.
173: #
174: # startpage($r, $uame, $udom, $thisdisfn);
175: # $r - The apache request object.
176: # $uname - User name.
177: # $udom - Domain name the user is logged in under.
178: # $thisdisfn - Displayable version of the filename.
179: sub startpage {
180: my ($r, $uname, $udom, $thisdisfn) = @_;
181:
182: $r->content_type('text/html');
183: $r->send_http_header;
184:
185: $r->print('<html><head><title>LON-CAPA Construction Space</title></head>');
186:
187: $r->print('<body bgcolor="#FFFFFF"><img align=right '.
188: 'src=/adm/lonIcons/lonlogos.gif>');
189:
190: $r->print('<h1>Construction Space Directory <tt>'.
191: $thisdisfn.'/</tt></h1>');
192:
193: if (($uname ne $ENV{'user.name'}) || ($udom ne $ENV{'user.domain'})) {
194: $r->print('<h3>Co-Author: '.$uname.' at '.$udom.
195: '</h3>');
196: }
197: }
198:
199: #
200: # Get the title string or "[untitled]" if the file has no title metadata:
201: # Without the latter substitution, it's impossible to examine metadata for
202: # untitled resources. Resources may be legitimately untitled, to prevent
203: # searches from locating them.
204: #
205: # $str = getTitleString($fullname);
206: # $fullname - Fully qualified filename to check.
207: #
208: sub getTitleString {
209: my $fullname = shift;
210: my $title = &Apache::lonnet::metadata($fullname, 'title');
211:
212: unless ($title) {
213: $title = "[untitled]";
214: }
215: return $title;
216: }
217:
218:
219: #
220: # Put out a directory table row:
221: # putdirectory(r, base, here, dirname, modtime)
222: # r - Apache request object.
223: # reqfile - File in request.
224: # here - Where we are in directory tree.
225: # dirname - Name of directory special file.
226: # modtime - Encoded modification time.
227: #
228: sub putdirectory {
229: my ($r, $reqfile, $here, $dirname, $modtime) = @_;
230:
231: # construct the display filename: the directory name unless ..:
232:
233: my $disfilename = $dirname;
234: if ($dirname eq '..') {
235: $disfilename = '<i>Parent Directory</i>';
236: }
237: unless (( ($dirname eq '..') && ($reqfile eq '')) ||
238: ($dirname eq '.')) {
239: $r->print('<tr bgcolor="#CCCCFF">'.
240: '<td>Go to ...</td>'.
241: '<td><a href="'.$here.'/'.$dirname.'/" target="_top">'.
242: $disfilename.'</a></td>'.
243: '<td> </td>'.
244: '<td> </td>'.
245: '<td>'.localtime($modtime).'</td>'.
246: "</tr>\n");
247: }
248: return OK;
249: }
250: #
251: # Put a table row for a file resource.
252: #
253: sub putresource {
254: my ($r, $uname, $filename, $thisdisfn,
255: $resdir, $targetdir, $linkdir,
256: $cmtime) = @_;
257:
258: my $status='Unpublished';
259: my $bgcolor='#FFCCCC';
260: my $title=' ';
261: if (-e $resdir.'/'.$filename) {
262: my ($rdev,$rino,$rmode,$rnlink,
263: $ruid,$rgid,$rrdev,$rsize,
264: $ratime,$rmtime,$rctime,
265: $rblksize,$rblocks)=stat($resdir.'/'.$filename);
266: if ($rmtime>=$cmtime) {
267: $status='Published';
268: $bgcolor='#CCFFCC';
269: $title='<a href="/res/'.$targetdir.'/'.$filename.
270: '.meta" target=cat>'.
271: getTitleString($targetdir.'/'.$filename, 'title').'</a>';
272: } else {
273: $status='Modified';
274: $bgcolor='#FFFFCC';
275: $title='<a href="/res/'.$targetdir.'/'.$filename.'.meta" target=cat>'.
276: getTitleString($targetdir.'/'.$filename,'title').'</a>';
277: if (&Apache::loncommon::fileembstyle(($filename=~/\.(\w+)$/)) eq 'ssi') {
278: $status.='<br><a href="/adm/diff?filename=/~'.$uname.
279: $thisdisfn.'/'.$filename.
280: '&versionone=priv" target=cat>Diffs</a>';
281: }
282: }
283: $status.='<br><a href="/adm/retrieve?filename=/~'.$uname.
284: $thisdisfn.'/'.$filename.'" target=cat>Retrieve</a>';
285: }
286: $r->print('<tr bgcolor="'.$bgcolor.'">'.
287: '<td><a target="_parent" href="/adm/publish?filename=/~'.
288: $uname.$thisdisfn.'/'.$filename.'">'.'Publish</a>'.
289: '</td>'.
290: '<td>'.
291: '<a href="'.$linkdir.'/'.$filename.'" target="_top">'.
292: $filename.'</a>'.
293: '</td>'.
294: '<td>'.$title.'</td>'.
295: '<td>'.$status.'</td>'.
296: '<td>'.localtime($cmtime).'</td>'.
297: "</tr>\n");
298: return OK;
299: }
300: #
301: # Categorize files in the directory.
302: # For each file in a list of files in a file directory,
303: # the file categorized as one of:
304: # - directory
305: # - sequence
306: # - problem
307: # - Other resource.
308: #
309: # For each file the modification date is determined as well.
310: # Returned is a list of sublists:
311: # (directories, sequences, problems, other)
312: # each of the sublists contains entries of the following form (sorted by
313: # filename):
314: # (filename, typecode, lastmodtime)
315: #
316: # $list = CategorizeFiles($location, $files)
317: # $location - Directory in which the files live (relative to our
318: # execution.
319: # $files - list of files.
320: #
321: sub CategorizeFiles {
322: my $location = shift;
323: my $files = shift;
324: }
325:
326: 1;
327: __END__
328:
329: =head1 NAME
330:
331: Apache::lonpubdir - Publication Handler for Directories
332:
333: =head1 SYNOPSIS
334:
335: Invoked (for various locations) by /etc/httpd/conf/srm.conf:
336:
337: <LocationMatch "^/\~.*/$">
338: PerlAccessHandler Apache::loncacc
339: SetHandler perl-script
340: PerlHandler Apache::lonpubdir
341: ErrorDocument 403 /adm/login
342: ErrorDocument 404 /adm/notfound.html
343: ErrorDocument 406 /adm/unauthorized.html
344: ErrorDocument 500 /adm/errorhandler
345: </LocationMatch>
346:
347: <Location /adm/pubdir>
348: PerlAccessHandler Apache::lonacc
349: SetHandler perl-script
350: PerlHandler Apache::lonpubdir
351: ErrorDocument 403 /adm/login
352: ErrorDocument 404 /adm/notfound.html
353: ErrorDocument 406 /adm/unauthorized.html
354: ErrorDocument 500 /adm/errorhandler
355: </Location>
356:
357: =head1 INTRODUCTION
358:
359: This module publishes a directory of files.
360:
361: This is part of the LearningOnline Network with CAPA project
362: described at http://www.lon-capa.org.
363:
364: =head1 HANDLER SUBROUTINE
365:
366: This routine is called by Apache and mod_perl.
367:
368: =over 4
369:
370: =item *
371:
372: read in information
373:
374: =item *
375:
376: start page output
377:
378: =item *
379:
380: run through list of files and attempt to publish unhidden files
381:
382: =back
383:
384: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>