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