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