File:  [LON-CAPA] / loncom / publisher / lonpubdir.pm
Revision 1.58: download - view: text, annotated - select for diffs
Thu Jan 15 20:22:47 2004 UTC (20 years, 4 months ago) by www
Branches: MAIN
CVS tags: HEAD
Even better handling of bombs.

    1: # The LearningOnline Network with CAPA
    2: # Construction Space Directory Lister
    3: #
    4: # $Id: lonpubdir.pm,v 1.58 2004/01/15 20:22:47 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>&nbsp;</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>&nbsp;</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:     $r->print(
  226:        &Apache::lonhtmlcommon::crumbs($uname.'/'.$thisdisfn.'/','_top','/priv').'<br />');
  227: }
  228: 
  229: #
  230: #   Get the title string or "[untitled]" if the file has no title metadata:
  231: #   Without the latter substitution, it's impossible to examine metadata for
  232: #   untitled resources.  Resources may be legitimately untitled, to prevent
  233: #   searches from locating them.
  234: #
  235: #   $str = getTitleString($fullname);
  236: #       $fullname - Fully qualified filename to check.
  237: #
  238: sub getTitleString {
  239:     my $fullname = shift;
  240:     my $title    = &Apache::lonnet::metadata($fullname, 'title');
  241: 
  242:     unless ($title) {
  243: 	$title = "[".&mt('untitled')."]";
  244:     }
  245:     return $title;
  246: }
  247: 
  248: sub getCopyRightString {
  249:     my $fullname = shift;
  250:     return &Apache::lonnet::metadata($fullname, 'copyright');
  251: }
  252: #
  253: #  Put out a directory table row:
  254: #    putdirectory(r, base, here, dirname, modtime)
  255: #      r       - Apache request object.
  256: #      reqfile - File in request.
  257: #      here    - Where we are in directory tree.
  258: #      dirname - Name of directory special file.
  259: #      modtime - Encoded modification time.
  260: # 
  261: sub putdirectory {
  262:     my ($r, $reqfile, $here, $dirname, $modtime, $resdir, $bombs) = @_;
  263:   
  264:     # construct the display filename: the directory name unless ..:
  265:     
  266:     my $disfilename = $dirname;
  267:     if ($dirname eq '..') {
  268: 	$disfilename = '<i>'.&mt('Parent Directory').'</i>';
  269:     }
  270:     unless (( ($dirname eq '..') && ($reqfile eq '')) ||
  271: 	    ($dirname eq '.')) {
  272: 	my $kaputt=0;
  273: 	foreach (keys %{$bombs}) {
  274: 	    if ($_=~m:^\Q$resdir\E/\Q$disfilename\E/:) { $kaputt=1; last; }
  275: 	}
  276: 	%Apache::lonpublisher::metadatafields=();
  277: 	%Apache::lonpublisher::metadatakeys=();
  278: 	my $construct=$here;
  279: 	$construct=~s:^/priv/(\w+)$:/home/$1/public_html:;
  280: 	&Apache::lonpublisher::metaeval(&Apache::lonnet::getfile(
  281:        				 $construct.'/'.$dirname.'/default.meta'
  282: 								 ));
  283: 	$r->print('<tr bgcolor="#CCCCFF">'.
  284: 		  '<td><img src="'.
  285: 		  $Apache::lonnet::perlvar{'lonIconsURL'}.'/folder_closed.gif" /></td>'.
  286: 		  '<td>'.&mt('Go to ...').'</td>'.
  287: 		  '<td><font face="arial"><a href="'.$here.'/'.$dirname.'/" target="_top">'.
  288: 		  $disfilename.'</a></font></td>'.
  289: 		        '<td colspan="2">'.($kaputt?&Apache::lonhtmlcommon::authorbombs($resdir.'/'.$disfilename.'/'):'').$Apache::lonpublisher::metadatafields{'title'}.' <i>'.
  290: 		  $Apache::lonpublisher::metadatafields{'subject'}.'</i> '.
  291: 		  $Apache::lonpublisher::metadatafields{'keywords'}.'</td>'.
  292: 		  '<td>'.&Apache::lonlocal::locallocaltime($modtime).'</td>'.
  293: 		  "</tr>\n");
  294:     }	
  295:     return OK;
  296: }
  297: #
  298: #   Put a table row for a file resource.
  299: #
  300: sub putresource {
  301:     my ($r, $uname, $filename, $thisdisfn, 
  302: 	$resdir, $targetdir, $linkdir,
  303: 	$cmtime,$bombs) = @_;
  304: 
  305:     my $status=&mt('Unpublished');
  306:     my $bgcolor='#FFAA99';
  307:     my $title='&nbsp;';
  308:     if (-e $resdir.'/'.$filename) {
  309: 	my ($rdev,$rino,$rmode,$rnlink,
  310: 	    $ruid,$rgid,$rrdev,$rsize,
  311: 	    $ratime,$rmtime,$rctime,
  312: 	    $rblksize,$rblocks)=stat($resdir.'/'.$filename);
  313: 	if ($rmtime>=$cmtime) {
  314: 	    $status=&mt('Published').'<br />'.
  315: 		&mt(&getCopyRightString($targetdir.'/'.$filename));
  316:             $bgcolor='#CCFF88';
  317: 	    if (&Apache::lonnet::metadata($targetdir.'/'.$filename,'obsolete')) {
  318: 		$status=&mt('Obsolete');
  319:                 $bgcolor='#AAAAAA';
  320: 	    }
  321: 	    $title='<a href="/res/'.$targetdir.'/'.$filename.
  322: 		'.meta" target=cat>'.
  323: 		&getTitleString($targetdir.'/'.$filename).'</a>';
  324: 	} else {
  325: 	    $status=&mt('Modified').'<br />'.
  326: 		&mt(&getCopyRightString($targetdir.'/'.$filename));
  327:             $bgcolor='#FFFF77';
  328: 	    $title='<a href="/res/'.$targetdir.'/'.$filename.'.meta" target=cat>'.
  329: 		&getTitleString($targetdir.'/'.$filename).'</a>';
  330: 	    if (&Apache::loncommon::fileembstyle(($filename=~/\.(\w+)$/)) eq 'ssi') {
  331: 		$status.='<br /><a href="/adm/diff?filename=/~'.$uname.
  332: 		    $thisdisfn.'/'.$filename.
  333: 		    '&versiontwo=priv" target=cat>'.&mt('Diffs').'</a>';
  334: 	    }
  335: 	}
  336: 	$title.='<br /><a href="/~'.$uname.$thisdisfn.'/'.$filename.'.meta">'. 
  337: 	    ($$bombs{$targetdir.'/'.$filename}?'<img src="/adm/lonMisc/bomb.gif" border="0" />':'Edit Metadata').'</a>';
  338: 	$status.='<br><a href="/adm/retrieve?filename=/~'.$uname.
  339: 	    $thisdisfn.'/'.$filename.'" target=cat>'.&mt('Retrieve').'</a>';
  340:     }
  341:     my $editlink='';
  342:     my $editlink2='';
  343:     if ($filename=~/\.(xml|html|htm|xhtml|xhtm|sty)$/) {
  344: 	$editlink=' <br />(<a href="'.$linkdir.'/'.$filename.'?forceedit=1" target="_top">'.&mt('Edit').'</a>)';
  345:     }
  346:     if ($filename=~/\.(problem|exam|quiz|assess|survey|form|library)$/) {
  347: 	$editlink=' (<a href="'.$linkdir.'/'.$filename.'?forceedit=1" target="_top">'.&mt('EditXML').'</a>)';
  348: 	$editlink2=' <br />(<a href="'.$linkdir.'/'.$filename.'?forceColoredit=1" target="_top">'.&mt('Edit').'</a>)';
  349:     }
  350:     if ($filename=~/\.(zip|tar|bz2|gz|tar.gz|tar.bz2|tgz)$/) {
  351: 	$editlink=' (<a target="_parent" href="/adm/cfile?decompress=/~'.
  352: 	      $uname.$thisdisfn.'/'.$filename.'">'.&mt('Decompress').'</a>)';
  353:     }
  354:     $r->print('<tr bgcolor="'.$bgcolor.'">'.
  355: 	      '<td>'.($filename=~/[\#\~]$/?'&nbsp;':
  356: 		      '<img src="'.&Apache::loncommon::icon($filename).'" /></td>').
  357: 	      '<td><a target="_parent" href="/adm/publish?filename=/~'.
  358: 	      $uname.$thisdisfn.'/'.$filename.'">'.&mt('Publish').'</a>'.
  359: 	      '</td>'.
  360: 	      '<td><font face="arial">'.
  361: 	      '<a href="'.$linkdir.'/'.$filename.'" target="_top">'.
  362:                $filename.'</a></font>'.$editlink2.$editlink.
  363: 	      '</td>'.
  364: 	      '<td>'.$title.'</td>'.
  365: 	      '<td>'.$status.'</td>'.
  366: 	      '<td>'.&Apache::lonlocal::locallocaltime($cmtime).'</td>'.
  367: 	      "</tr>\n");
  368:     return OK;
  369: }
  370: #
  371: #   Categorize files in the directory.
  372: #   For each file in a list of files in a file directory, 
  373: #   the  file categorized as one of:
  374: #    - directory  
  375: #    - sequence
  376: #    - problem 
  377: #    - Other resource.
  378: #
  379: #   For each file the modification date is determined as well.
  380: #   Returned is a list of sublists:
  381: #    (directories, sequences, problems, other)
  382: #   each of the sublists contains entries of the following form (sorted by
  383: #   filename):
  384: #     (filename, typecode, lastmodtime)
  385: #
  386: #   $list = CategorizeFiles($location, $files)
  387: #       $location   - Directory in which the files live (relative to our
  388: #                     execution.
  389: #       $files      - list of files.
  390: #
  391: sub CategorizeFiles {
  392:     my $location = shift;
  393:     my $files    = shift;
  394: }
  395: 
  396: 1;
  397: __END__
  398: 
  399: =head1 NAME
  400: 
  401: Apache::lonpubdir - Construction space directory lister
  402: 
  403: =head1 SYNOPSIS
  404: 
  405: Invoked (for various locations) by /etc/httpd/conf/srm.conf:
  406: 
  407:  <LocationMatch "^/\~.*/$">
  408:  PerlAccessHandler       Apache::loncacc
  409:  SetHandler perl-script
  410:  PerlHandler Apache::lonpubdir
  411:  ErrorDocument     403 /adm/login
  412:  ErrorDocument     404 /adm/notfound.html
  413:  ErrorDocument     406 /adm/unauthorized.html
  414:  ErrorDocument	  500 /adm/errorhandler
  415:  </LocationMatch>
  416: 
  417:  <Location /adm/pubdir>
  418:  PerlAccessHandler       Apache::lonacc
  419:  SetHandler perl-script
  420:  PerlHandler Apache::lonpubdir
  421:  ErrorDocument     403 /adm/login
  422:  ErrorDocument     404 /adm/notfound.html
  423:  ErrorDocument     406 /adm/unauthorized.html
  424:  ErrorDocument	  500 /adm/errorhandler
  425:  </Location>
  426: 
  427: =head1 INTRODUCTION
  428: 
  429: This module publishes a directory of files.
  430: 
  431: This is part of the LearningOnline Network with CAPA project
  432: described at http://www.lon-capa.org.
  433: 
  434: =head1 HANDLER SUBROUTINE
  435: 
  436: This routine is called by Apache and mod_perl.
  437: 
  438: =over 4
  439: 
  440: =item *
  441: 
  442: read in information
  443: 
  444: =item *
  445: 
  446: start page output
  447: 
  448: =item *
  449: 
  450: run through list of files and attempt to publish unhidden files
  451: 
  452: =back
  453: 
  454: =cut

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