NAME
Apache::Icon - Lookup icon images
SYNOPSIS
use Apache::Icon ();
my $icon = Apache::Icon->new($subr);
my $img = $icon->find || $icon->default;
my $alt = $icon->alt;
DESCRIPTION
This module rips out the icon guts of mod_autoindex and provides
a Perl interface for looking up icon images. The motivation is
to piggy-back the existing *AddIcon* and related directives for
mapping file extensions and names to icons, while keeping things
as small and fast as mod_autoindex does.
METHODS
new Create a new *Apache::Icon* object with the given
*Apache::SubRequest* object. Example:
for my $entry (sort $dh->read) {
next if $entry eq '.';
my $subr = $r->lookup_file($entry);
my $icon = Apache::Icon->new($subr);
...
find
Lookup icon image associated with the subrequest.
my $img = $icon->find;
default
Lookup the default icon images.
my $img = $icon->default; #DefaultIcon (unknown.gif)
my $img = $icon->default("^^DIRECTORY^^"); #folder.gif
my $img = $icon->default("^^BLANKICON^^"); #blank.gif
alt Lookup the text alternative specified by the AddAlt directive.
my $alt = $icon->alt || $img;
DIRECTIVES
Refer to the *mod_autoindex* documentation for directives listed
here with no description.
IconDouble
This directive can be set to *On* or *Off*. The default is
*On* if *mod_autoindex* is configured with the server, *Off*
otherwise. When the directive is *On*, *mod_icon* directive
handlers will return DECLINE_CMD after processing which
allows *mod_autoindex* to also handle the various *Icon* and
*Alt* directives.
AddIcon
AddIconByType
AddIconByEncoding
AddAlt
AddAltByType
AddAltByEncoding
DefaultIcon
SEE ALSO
Apache::AutoIndex(3)
AUTHOR
Doug MacEachern
C code based on mod_autoindex by the Apache Group