mod_imap (Webmaster in a Nutshell, 3rd Edition)

19.18. mod_imap

The mod_imap module provides support for .map files and imagemaps. Imagemaps allow a server to respond to clicks in various "hot zones" of an image, without creating an explicit link to redirect the client.

ImapBase

ImapBase map|referer|url

[server config, or within <VirtualHost> or <Directory>, or .htaccess]

Specifies the default base for imagemap files, if there is no base directive in the imagemap file itself. A URL can be specified, or one of the following options can be used:

map: Uses the URL of the imagemap file.
referer: Uses the referring document or the ServerRoot if a Referer header is not specified.

ImapDefault

ImapDefault error|nocontent|map|referer|URL

[server config, or within <VirtualHost> or <Directory>, or .htaccess]

Specifies the default action for imagemap files, if there is no default directive in the imagemap file itself. A URL can be specified, or one of the following options can be used:

error: Fails with a server response code of 500 (see Chapter 17).
nocontent: Sends a server response code of 204, telling the client to keep the same page displayed (see Chapter 17).
map: Uses the URL of the imagemap file.
referer: Uses the referring document, or the server root if a Referer header is not specified.

ImapMenu

ImapMenu none|formatted|semiformatted|unformatted

[server config, or within <VirtualHost> or <Directory>, or .htaccess]

Under Apache, if an imagemap is called without valid coordinates, the server can return a menu of the items in the imagemap file. The ImapMenu directive configures that menu. Options are:

none: No menu is created. The action specified with ImapDefault is taken.
formatted: A formatted menu is generated, with a listing of the possible links.
semiformatted: A menu with comments from the imagemap file and simple breaks is generated, with a listing of the possible links.
unformatted: A menu with the text of the imagemap file, unformatted. Useful if map files are written as HTML.