NAME Apache::RandomImage - Lightweight module to randomly display images from a directory. VERSION Version 0.3 SYNOPSIS Configure this module as a response handler to activate this module. The following examples will result in an image being randomly selected from the "images" directory. #mod_perl2 (PerlResponseHandler) <LocationMatch "^/(.+)/images/random-image"> SetHandler modperl PerlSetVar Suffixes "gif png jpg" PerlResponseHandler Apache::RandomImage </LocationMatch> #mod_perl1 (PerlHandler) <Location "/images/give-random"> SetHandler perl-script PerlSetVar Suffixes "gif png jpg tif jpeg" PerlHandler Apache::RandomImage </Location> DESCRIPTION Apache::RandomImage will randomly select an image from the dirname of the requested location. You need to specify a white-space separated list of Suffixes with *PerlSetVar*, otherwise the request will be declined. FUNCTIONS handler Apache response handler Imported constants OK See Apache::Constants or Apache2::Const documentation DECLINED See Apache::Constants or Apache2::Const documentation NOT_FOUND See Apache::Constants or Apache2::Const documentation SEE ALSO mod_perl Apache::RandomLocation AUTHOR Michael Kroell, "<pepl at cpan.org>" BUGS Please report any bugs or feature requests to "bug-locale-maketext-extract-plugin-xsl at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Locale-Maketext-Extract- Plugin-XSL>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. SUPPORT You can find documentation for this module with the perldoc command. perldoc Apache::RandomImage You can also look for information at: * RT: CPAN's request tracker <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Apache-RandomImage> * AnnoCPAN: Annotated CPAN documentation <http://annocpan.org/dist/Apache-RandomImage> * CPAN Ratings <http://cpanratings.perl.org/d/Apache-RandomImage> * Search CPAN <http://search.cpan.org/dist/Apache-RandomImage> ACKNOWLEDGEMENTS Apache::RandomImage was inspired by Apache::RandomLocation COPYRIGHT Copyright 2003-2009 Michael Kroell, all rights reserved. LICENSE This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.