# Module mod_imap

This module is contained in the `mod_imap.c` file, and is compiled in by default. It provides for `.map` files, replacing the functionality of the `imagemap` CGI program. Any document with mime type `application/x-httpd-imap` will be processed by this module.

## Summary

In order to use server-parsed imagemap files, you must first compile the module into your server, and add the following line to the server configuration file. This entry indicates that imagemap files will be named with a `.map` extension.

> `AddType application/x-httpd-imap map`

## New Features

The imagemap module adds some new features that were not possible with previously distributed imagemap programs.

- URL references relative to the Referer: information.
- Default <BASE> assignment through a new map field `base_uri`.
- No need for `imagemap.conf` file.
- Point references.

`base_uri` options:

`map`
  Provides the default and old behaviour of map relative reference.

`referer`
  Uses the Referer: header information to reference a URL relative to the current document.

`http://whateverurl`
  Has the effect of setting <BASE> to that URL making all references relative to that <BASE>.

### Mapfile Example

> `default http:/lincoln/
> base_uri referer
> rect .. 0,0 77,27
> poly http://www.inetnebr.com/ 78,0 194,27
> circle http://www.inetnebr.com/lincoln/feedback/ 195,0 305,27
> rect search_index 306,0 419,27
> point http://www.zyzzyva.com/ 420,0 549,27`

### Referencing your mapfile

> `<A HREF="http:/maps/imagmap1.map">
> <IMG ISMAP SRC="http:/images/imagemap1.gif">
> </A>`