NAME

Apache::AutoIndex - Perl replacment for mod_autoindex and mod_dir Apache module

SYNOPSIS

PerlModule Apache::Icon
PerlModule Apache::AutoIndex
PerlTransHandler Apache::AutoIndex::transhandler
PerlHandler Apache::AutoIndex

DESCRIPTION

This module can replace completely mod_dir and mod_autoindex standard directory handling modules shipped with apache. It can currently live right on top of those modules, but I suggest simply making a new httpd without these modules compiled-in.

To start using it on your site right away, simply preload Apache::Icon and Apache::AutoIndex either with:

PerlModule Apache::Icon
PerlModule Apache::AutoIndex

in your httpd.conf file:

  use Apache::Icon ();
  use Apache::AutoIndex;

in your require.pl file.

Then it's simply adding

PerlTransHandler Apache::Autoindex::transhandler
PerlHandler Apache::AutoIndex 

somewhere in your httpd.conf but outside any Location/Directory containers.

VIRTUAL HOSTS

If used in a server using virtual hosts, since mod_perl doesn't have configuration merging routine for virtual hosts, you'll have to put the PerlHandler and PerlTransHandler directives in each and every <VHOST></VHOST> section you wish to use Apache::AutoIndex with.

DIRECTIVES

It uses all of the Configuration Directives defined by mod_dir and mod_autoindex.

Since the documentation about all those directives can be found on the apache website at:

http://www.apache.org/docs/mod/mod_autoindex.html 
http://www.apache.org/docs/mod/mod_dir.html

I will only list modification that might have occured in this perl version.

SUPPORTED DIRECTIVES

• AddDescription

• DirectoryIndex

• FancyIndexing - should use IndexOptions FancyIndexing since 1.3.2

• IndexOptions - All directives are currently supported. And a few were added

• HeaderName - It can now accept a list of files instead of just one

• ReadmeName - It can now accept a list of files instead of just one

• IndexIgnore

• IndexOrderDefault

NEW DIRECTIVES

• IndexOptions

  Thumbnails - Icons for images are small thumbnails. Defaults to false.

  ShowPermissions - prints file permissions. Defaults to false.

• PerlSetVar AutoIndexDebug [0|1]

  If set to 1, the listing displayed will print usefull (well, to me) debugging information appended to the bottom. The default is 0.

UNSUPPORTED DIRECTIVES

• - Hopefully none :-)

TODO

Generation of thumbnails with Apache::Magik instead of simply linking on the actual image. And some sort of caching of thumbnails also.

Find new things to add...

SEE ALSO

perl(1), Apache(3), Apache::Icon(3).

SUPPORT

Please send any questions or comments to the Apache modperl mailing list <modperl@apache.org> or to me at <gozer@ectoplasm.dyndns.com>

NOTES

This code was made possible by :

• Doug MacEachern <dougm@pobox.com> Creator of Apache::Icon, and of course, mod_perl.

• Rob McCool who produced the final mod_autoindex.c I copied, hrm.., well, translated to perl.

• The mod_perl mailing-list at <modperl@apache.org> for all your mod_perl related problems.

AUTHOR

Philippe M. Chiasson <gozer@ectoplasm.dyndns.com>

COPYRIGHT

Copyright (c) 1999 Philippe M. Chiasson. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm Apache::AutoIndex

perl -MCPAN -e shell
install Apache::AutoIndex