mod_imap.c
file, and is
compiled in by default. It provides for .map
files,
replacing the functionality of the imagemap
CGI
program. Any directory or document type configured to use the handler
imap-file
(using either AddHandler
or SetHandler
) will be
processed by this module.
.map
as imagemap files:
AddHandler imap-file map
Note that the following is still supported:
AddType application/x-httpd-imap map
However, we are trying to phase out "magic MIME types" so we are deprecating
this method.
base
.
imagemap.conf
file.
{none, formatted, semiformatted,
unformatted}
The ImapMenu directive determines the action taken if an imagemap file is called without valid coordinates.
none
none
, no menu is generated, and the default
action is performed.
formatted
formatted
menu is the simplest menu. Comments
in the imagemap file are ignored. A level one header is
printed, then an hrule, then the links each on a separate line.
The menu has a consistent, plain look close to that of
a directory listing.
semiformatted
semiformatted
menu, comments are printed
where they occur in the imagemap file. Blank lines are turned
into HTML breaks. No header or hrule is printed, but otherwise
the menu is the same as a formatted
menu.
unformatted
{error, nocontent,
map, referer, URL}
The ImapDefault directive sets the default default
used in
the imagemap files. It's value is overridden by a default
directive within the imagemap file. If not present, the
default
action is nocontent
, which means
that a 204 No Content
is sent to the client. In this
case, the client should continue to display the original page.
{map, referer, URL}
The ImapBase directive sets the default base
used in
the imagemap files. It's value is overridden by a base
directive within the imagemap file. If not present, the
base
defaults to http://servername/
.
The directive is one ofdirective value [x,y ...]
directive value "Menu text" [x,y ...]
directive value x,y ... "Menu text"
base
, default
,
poly
, circle
, rect
, or
point
. The value is an absolute or relative URL, or one
of the special values listed below. The coordinates are
x,y
pairs separated by whitespace. The quoted text is
used as the text of the link if a imagemap menu is generated. Lines
beginning with '#' are comments.
base
Directive
<BASE HREF="value">
. The
non-absolute URLs of the map-file are taken relative to this value.
The base
directive overrides ImapBase as set in a
.htaccess file or in the server configuration files. In the absence
of an ImapBase configuration directive, base
defaults to
http://server_name/
. base_uri
is synonymous with base
. Note that
a trailing slash on the URL is significant.
default
Directive
poly
, circle
or rect
directives, and there are no point
directives. Defaults
to nocontent
in the absence of an ImapDefault
configuration setting, causing a status code of 204 No
Content
to be returned. The client should keep the same
page displayed.
poly
Directive
circle
rect
Directive
point
Directive
default
will not be followed if a
point
directive is present and valid coordinates are
given.
base
value. base
itself will not resolved according to the current
value. A statement base mailto:
will work properly, though.
map
menu
map
.
referer
http://servername/
if no Referer:
header was present.
nocontent
204 No Content
,
telling the client to keep the same page displayed. Valid for
all but base
.
error
500 Server Error
. Valid for all but
base
, but sort of silly for anything but
default
.
0,0 200,200
0,0
, it is as if
no coordinate had been selected.
"Menu Text"
<a HREF="http://foo.com/">Menu text</a>
<a HREF="http://foo.com/">http://foo.com</a>
#Comments are printed in a 'formatted' or 'semiformatted' menu.
#And can contain html tags. <hr>
base referer
poly map "Could I have a menu, please?" 0,0 0,10 10,10 10,0
rect .. 0,0 77,27 "the directory of the referer"
circle http://www.inetnebr.com/lincoln/feedback/ 195,0 305,27
rect another_file "in same directory as referer" 306,0 419,27
point http://www.zyzzyva.com/ 100,100
point http://www.tripod.com/ 200,200
rect mailto:nate@tripod.com 100,150 200,0 "Bugs?"
<A HREF="/maps/imagemap1.map">
<IMG ISMAP SRC="/images/imagemap1.gif">
</A>