19.18 mod_imap | Webmaster in a Nutshell, Third Edition


Team-Fly

	Webmaster in a Nutshell, 3rd Edition By Robert Eckstein, Stephen Spainhour
	Table of Contents

	Chapter 19. Apache Modules

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  maprefererurl

[ 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  errornocontentmaprefererURL

[ 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  noneformattedsemiformattedunformatted

[ 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.


Team-Fly

Top