mod_imap.html revision 1997e02bed99bd0c081962ade257a0ea12ebe15b
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<HTML>
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence<HEAD>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<TITLE>Apache module mod_imap</TITLE>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</HEAD>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
15a44745412679c30a6d022733925af70a38b715David Lawrence<BODY
15a44745412679c30a6d022733925af70a38b715David Lawrence BGCOLOR="#FFFFFF"
15a44745412679c30a6d022733925af70a38b715David Lawrence TEXT="#000000"
15a44745412679c30a6d022733925af70a38b715David Lawrence LINK="#0000FF"
15a44745412679c30a6d022733925af70a38b715David Lawrence VLINK="#000080"
15a44745412679c30a6d022733925af70a38b715David Lawrence ALINK="#FF0000"
15a44745412679c30a6d022733925af70a38b715David Lawrence>
15a44745412679c30a6d022733925af70a38b715David Lawrence<!--#include virtual="header.html" -->
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<H1 ALIGN="CENTER">Module mod_imap</H1>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
9259fed3d8ac5d1efa9b5a647969e40c9c934484Andreas Gustafsson<p>This module provides for server-side imagemap processing.</p>
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<P><A
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonHREF="module-dict.html#Status"
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonREL="Help"
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence><STRONG>Status:</STRONG></A> Base
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<BR>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<A
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonHREF="module-dict.html#SourceFile"
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid LawrenceREL="Help"
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson><STRONG>Source File:</STRONG></A> mod_imap.c
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson<BR>
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson<A
9259fed3d8ac5d1efa9b5a647969e40c9c934484Andreas GustafssonHREF="module-dict.html#ModuleIdentifier"
9259fed3d8ac5d1efa9b5a647969e40c9c934484Andreas GustafssonREL="Help"
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson><STRONG>Module Identifier:</STRONG></A> imap_module
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<BR>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<A
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonHREF="module-dict.html#compatibility"
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonREL="Help"
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson><STRONG>Compatibility:</STRONG></A> Available in Apache 1.1 and later.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</P>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
fb01226bcd598c36b5edc566489c890c39f03ed3Brian Wellington
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<H2>Summary</H2>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<p>This module processes <CODE>.map</CODE> files, thereby replacing
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafssonthe functionality of the <CODE>imagemap</CODE> CGI program. Any
7a184cd4e5a54a4e530f9bff8a4e46be392d0b52Brian Wellingtondirectory or document type configured to use the handler
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<CODE>imap-file</CODE> (using either <CODE><A
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonHREF="mod_mime.html#addhandler">AddHandler</A> </CODE> or <CODE><A
9df7d74e421cf715c6e3cbbad2aba6d33a5d1c9bBrian WellingtonHREF="mod_mime.html#sethandler">SetHandler</A></CODE>) will be
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafssonprocessed by this module.</p>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<p>The following directive will
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrenceactivate files ending with <CODE>.map</CODE> as imagemap files:
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<BLOCKQUOTE><CODE>AddHandler imap-file map</CODE></BLOCKQUOTE>
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonNote that the following is still supported:
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <BLOCKQUOTE><CODE>AddType application/x-httpd-imap map</CODE></BLOCKQUOTE>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonHowever, we are trying to phase out "magic MIME types" so we are deprecating
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafssonthis method.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<H2>Directives</H2>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<UL>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence<LI><A HREF="#imapmenu">ImapMenu</A>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<LI><A HREF="#imapdefault">ImapDefault</A>
7a184cd4e5a54a4e530f9bff8a4e46be392d0b52Brian Wellington<LI><A HREF="#imapbase">ImapBase</A>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</UL>
7a184cd4e5a54a4e530f9bff8a4e46be392d0b52Brian Wellington
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<H2>New Features</H2>
6e49e91bd08778d7eae45a2229dcf41ed97cc636David LawrenceThe imagemap module adds some new features that were not
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafssonpossible with previously distributed imagemap programs.<P>
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence
7a184cd4e5a54a4e530f9bff8a4e46be392d0b52Brian Wellington<UL>
7a184cd4e5a54a4e530f9bff8a4e46be392d0b52Brian Wellington<LI>URL references relative to the Referer: information.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<LI>Default &lt;BASE&gt; assignment through a new map directive
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<CODE>base</CODE>.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<LI>No need for <CODE>imagemap.conf</CODE> file.
7a184cd4e5a54a4e530f9bff8a4e46be392d0b52Brian Wellington<LI>Point references.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<LI>Configurable generation of imagemap menus.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</UL>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<H2>Imagemap File</H2>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonThe lines in the imagemap files can have one of several formats:
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<BLOCKQUOTE>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<CODE>directive value [x,y ...]</CODE><BR>
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence<CODE>directive value "Menu text" [x,y ...]</CODE><BR>
9df7d74e421cf715c6e3cbbad2aba6d33a5d1c9bBrian Wellington<CODE>directive value x,y ... "Menu text"</CODE><BR>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</BLOCKQUOTE>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonThe directive is one of <CODE>base</CODE>, <CODE>default</CODE>,
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence<CODE>poly</CODE>, <CODE>circle</CODE>, <CODE>rect</CODE>, or
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<CODE>point</CODE>. The value is an absolute or relative URL, or one
fb01226bcd598c36b5edc566489c890c39f03ed3Brian Wellingtonof the special values listed below. The coordinates are
7a184cd4e5a54a4e530f9bff8a4e46be392d0b52Brian Wellington<CODE>x,y</CODE> pairs separated by whitespace. The quoted text is
fb01226bcd598c36b5edc566489c890c39f03ed3Brian Wellingtonused as the text of the link if a imagemap menu is generated. Lines
fb01226bcd598c36b5edc566489c890c39f03ed3Brian Wellingtonbeginning with '#' are comments.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<H3>Imagemap File Directives</H3>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas GustafssonThere are six directives allowed in the imagemap file. The directives
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafssoncan come in any order, but are processed in the order they are found
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafssonin the imagemap file.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<DL>
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson<DT><CODE>base</CODE> Directive
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson<DD>Has the effect of <CODE>&lt;BASE HREF="value"&gt;</CODE>. The
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson non-absolute URLs of the map-file are taken relative to this value.
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson The <CODE>base</CODE> directive overrides ImapBase as set in a
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson .htaccess file or in the server configuration files. In the absence
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson of an ImapBase configuration directive, <CODE>base</CODE> defaults to
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson <CODE>http://server_name/</CODE>. <BR>
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson <CODE>base_uri</CODE> is synonymous with <CODE>base</CODE>. Note that
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson a trailing slash on the URL is significant.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<P>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<DT><CODE>default</CODE> Directive
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<DD>The action taken if the coordinates given do not fit any of the
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson <CODE>poly</CODE>, <CODE>circle</CODE> or <CODE>rect</CODE>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson directives, and there are no <CODE>point</CODE> directives. Defaults
9df7d74e421cf715c6e3cbbad2aba6d33a5d1c9bBrian Wellington to <CODE>nocontent</CODE> in the absence of an ImapDefault
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson configuration setting, causing a status code of <CODE>204 No
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson Content</CODE> to be returned. The client should keep the same
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson page displayed.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<P>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<DT><CODE>poly</CODE> Directive
9259fed3d8ac5d1efa9b5a647969e40c9c934484Andreas Gustafsson<DD>Takes three to one-hundred points, and is obeyed if the user selected
c885fad9b8bf204ae9e62c9acb0321e2bcca30a4Andreas Gustafsson coordinates fall within the polygon defined by these points.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<P>
c885fad9b8bf204ae9e62c9acb0321e2bcca30a4Andreas Gustafsson<DT><CODE>circle</CODE>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<DD>Takes the center coordinates of a circle and a point on the circle. Is
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson obeyed if the user selected point is with the circle.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<P>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<DT><CODE>rect</CODE> Directive
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<DD>Takes the coordinates of two opposing corners of a rectangle. Obeyed
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson if the point selected is within this rectangle.
c885fad9b8bf204ae9e62c9acb0321e2bcca30a4Andreas Gustafsson<P>
c885fad9b8bf204ae9e62c9acb0321e2bcca30a4Andreas Gustafsson<DT><CODE>point</CODE> Directive
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<DD>Takes a single point. The point directive closest to the user
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson selected point is obeyed if no other directives are satisfied.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson Note that <CODE>default</CODE> will not be followed if a
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <CODE>point</CODE> directive is present and valid coordinates are
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson given.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</DL>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence<H3>Values</H3>
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas GustafssonThe values for each of the directives can any of the following:
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson<DL>
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson <DT>a URL
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson <DD>The URL can be relative or absolute URL. Relative URLs can
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson contain '..' syntax and will be resolved relative to the
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson <CODE>base</CODE> value. <BR>
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson <CODE>base</CODE> itself will not resolved according to the current
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson value. A statement <CODE>base mailto:</CODE> will work properly, though.
c885fad9b8bf204ae9e62c9acb0321e2bcca30a4Andreas Gustafsson<P>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <DT><CODE>map</CODE>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <DD>Equivalent to the URL of the imagemap file itself. No
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson coordinates are sent with this, so a menu will be generated
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson unless ImapMenu is set to 'none'.
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<P>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <DT><CODE>menu</CODE>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <DD>Synonymous with <CODE>map</CODE>.
<P>
<DT><CODE>referer</CODE>
<DD>Equivalent to the URL of the referring document.
Defaults to <CODE>http://servername/</CODE> if no Referer:
header was present.
<P>
<DT><CODE>nocontent</CODE>
<DD>Sends a status code of <CODE>204 No Content</CODE>,
telling the client to keep the same page displayed. Valid for
all but <CODE>base</CODE>.
<P>
<DT><CODE>error</CODE>
<DD>Fails with a <CODE>500 Server Error</CODE>. Valid for all but
<CODE>base</CODE>, but sort of silly for anything but
<CODE>default</CODE>.
</DL>
<H3>Coordinates</H3>
<DL>
<DT><CODE>0,0 200,200</CODE>
<DD>A coordinate consists of an <TT>x</TT> and a <TT>y</TT> value
separated by a comma. The coordinates are separated from each other
by whitespace. To accommodate the way Lynx handles imagemaps, should a
user select the coordinate <CODE>0,0</CODE>, it is as if
no coordinate had been selected.
</DL>
<H3>Quoted Text</H3>
<DL>
<DT><CODE>"Menu Text"</CODE>
<DD>After the value or after the coordinates, the line optionally may
contain text within double quotes. This string is used as the
text for the link if a menu is generated:<BR>
<CODE>&lt;a HREF="http://foo.com/"&gt;Menu text&lt;/a&gt;</CODE><BR>
If no quoted text is present, the name of the link will be used
as the text:<BR>
<CODE>&lt;a HREF="http://foo.com/"&gt;http://foo.com&lt;/a&gt;</CODE><BR>
It is impossible to escape double quotes within this text.
</DL>
<H2>Example Mapfile</H2>
<BLOCKQUOTE><CODE>
#Comments are printed in a 'formatted' or 'semiformatted' menu. <BR>
#And can contain html tags. &lt;hr&gt; <BR>
base referer <BR>
poly map "Could I have a menu, please?" 0,0 0,10 10,10 10,0 <BR>
rect .. 0,0 77,27 "the directory of the referer"<BR>
circle http://www.inetnebr.com/lincoln/feedback/ 195,0 305,27 <BR>
rect another_file "in same directory as referer" 306,0 419,27 <BR>
point http://www.zyzzyva.com/ 100,100 <BR>
point http://www.tripod.com/ 200,200 <BR>
rect mailto:nate@tripod.com 100,150 200,0 "Bugs?" <BR>
</CODE></BLOCKQUOTE>
<P>
<H2>Referencing your mapfile</H2>
<BLOCKQUOTE><CODE>
&lt;A HREF="/maps/imagemap1.map"&gt; <BR>
&lt;IMG ISMAP SRC="/images/imagemap1.gif"&gt; <BR>
&lt;/A&gt;
</CODE></BLOCKQUOTE><P>
<hr>
<H2><A NAME="imapmenu">ImapMenu</A> directive</H2>
<A
HREF="directive-dict.html#Syntax"
REL="Help"
><STRONG>Syntax:</STRONG></A> ImapMenu
none|formatted|semiformatted|unformatted<BR>
<A
HREF="directive-dict.html#Context"
REL="Help"
><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
<A
HREF="directive-dict.html#Override"
REL="Help"
><STRONG>Override:</STRONG></A> Indexes<BR>
<A
HREF="directive-dict.html#Module"
REL="Help"
><STRONG>Module:</STRONG></A> mod_imap<BR>
<A
HREF="directive-dict.html#Compatibility"
REL="Help"
><STRONG>Compatibility:</STRONG></A> ImapMenu is only available in Apache
1.1 and later.<P>
The ImapMenu directive determines the action taken if an imagemap file
is called without valid coordinates.
<DL>
<DT><CODE>none</CODE>
<DD>If ImapMenu is
<CODE>none</CODE>, no menu is generated, and the <CODE>default</CODE>
action is performed.
<DT><CODE>formatted</CODE>
<DD>A <CODE>formatted</CODE> 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.
<DT><CODE>semiformatted</CODE>
<DD>In the <CODE>semiformatted</CODE> 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 <CODE>formatted</CODE> menu.
<DT><CODE>unformatted</CODE>
<DD>Comments are printed, blank lines are ignored. Nothing is
printed that does not appear in the imagemap file. All breaks
and headers must be included as comments in the imagemap file.
This gives you the most flexibility over the appearance of your
menus, but requires you to treat your map files as HTML instead
of plaintext.
</DL>
<hr>
<H2><A NAME="imapdefault">ImapDefault</A> directive</H2>
<A
HREF="directive-dict.html#Syntax"
REL="Help"
><STRONG>Syntax:</STRONG></A> ImapDefault
error|nocontent|map|referer|<em>URL</em><BR>
<A
HREF="directive-dict.html#Context"
REL="Help"
><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
<A
HREF="directive-dict.html#Override"
REL="Help"
><STRONG>Override:</STRONG></A> Indexes<BR>
<A
HREF="directive-dict.html#Module"
REL="Help"
><STRONG>Module:</STRONG></A> mod_imap<BR>
<A
HREF="directive-dict.html#Compatibility"
REL="Help"
><STRONG>Compatibility:</STRONG></A> ImapDefault is only available in Apache
1.1 and later.<P>
The ImapDefault directive sets the default <CODE>default</CODE> used in
the imagemap files. Its value is overridden by a <CODE>default</CODE>
directive within the imagemap file. If not present, the
<CODE>default</CODE> action is <CODE>nocontent</CODE>, which means
that a <CODE>204 No Content</CODE> is sent to the client. In this
case, the client should continue to display the original page.
<hr>
<H2><A NAME="imapbase">ImapBase</A> directive</H2>
<A
HREF="directive-dict.html#Syntax"
REL="Help"
><STRONG>Syntax:</STRONG></A> ImapBase map|referer|<em>URL</em><BR>
<A
HREF="directive-dict.html#Context"
REL="Help"
><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
<A
HREF="directive-dict.html#Override"
REL="Help"
><STRONG>Override:</STRONG></A> Indexes<BR>
<A
HREF="directive-dict.html#Module"
REL="Help"
><STRONG>Module:</STRONG></A> mod_imap<BR>
<A
HREF="directive-dict.html#Compatibility"
REL="Help"
><STRONG>Compatibility:</STRONG></A> ImapBase is only available in Apache
1.1 and later.<P>
The ImapBase directive sets the default <CODE>base</CODE> used in
the imagemap files. Its value is overridden by a <CODE>base</CODE>
directive within the imagemap file. If not present, the
<CODE>base</CODE> defaults to <CODE>http://servername/</CODE>.
<!--#include virtual="footer.html" -->
</BODY>
</HTML>