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, semi-formatted,
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/imagmap1.map">
<IMG ISMAP SRC="/images/imagemap1.gif">
</A>