.. _web:

*****************************************************************************
 WEB
*****************************************************************************

EMPTY [url]
    URL to forward users to if a query fails. If not defined the value for 
    ERROR is used.

ERROR [url]
    URL to forward users to if an error occurs. Ugly old MapServer error 
    messages will appear if this is not defined

FOOTER [filename]
    Template to use AFTER anything else is sent. Multiresult query modes only.

HEADER [filename]
    Template to use BEFORE everything else has been sent. Multiresult query 
    modes only.

IMAGEPATH [path]
    Path to the temporary directory fro writing temporary files and images. 
    Must be writable by the user the web server is running as. Must end 
    with a / or \ depending on your platform.

IMAGEURL [path]
    Base URL for IMAGEPATH. This is the URL that will take the web browser 
    to IMAGEPATH to get the images.

LOG [filename]
    File to log MapServer activity in. Must be writable by the user the web 
    server is running as.

.. index::
    pair: MAXSCALEDENOM; WEB
    
MAXSCALEDENOM [double]
    Maximum scale at which this interface is valid. When a user requests a map
    at a bigger scale, MapServer automatically returns the map at this scale.
    This effectively prevents user from zooming too far out.  Scale is given as
    the denominator of the actual scale fraction, for example for a map at a
    scale of 1:24,000 use 24000.  Implemented in MapServer 5.0, to replace the
    deprecated MAXSCALE parameter.
    
    .. deprecated:: 5.0
    
MAXSCALE [double] - deprecated
    Since MapServer 5.0 the proper parameter to use is MAXSCALEDENOM instead.
    The deprecated MAXSCALE is the maximum scale at which this interface is
    valid. When a user requests a map at a bigger scale, MapServer automatically
    returns the map at this scale. This effectively prevents user from zooming
    too far out.  Scale is given as the denominator of the actual scale
    fraction, for example for a map at a scale of 1:24,000 use 24000.

    .. seealso::
        
        :term:`Map scale`

MAXTEMPLATE [file|url]
    Template to be used if above the maximum scale for the app, useful 
    for nesting apps.

METADATA
    This keyword allows for arbitrary data to be stored as name value pairs. 
    This is used with OGC WMS to define things such as layer title. It can 
    also allow more flexibility in creating templates, as anything you put 
    in here will be accessible via template tags.
    Example:
    
    .. code-block:: mapfile

        METADATA
            title "My layer title"
            author "Me!"
        END

.. index::
    pair: MINSCALEDENOM; WEB
    
MINSCALEDENOM [double]
    Minimum scale at which this interface is valid. When a user reqests a 
    map at a smaller scale, MapServer automatically returns the map at this 
    scale. This effectively prevents the user from zooming in too far. 
    Scale is given as the denominator of the actual scale fraction, for example
    for a map at a scale of 1:24,000 use 24000.  Implemented in MapServer 5.0, to
    replace the deprecated MINSCALE parameter.

    .. seealso::
        
        :term:`Map scale`

MINSCALE [double] - deprecated
    Since MapServer 5.0 the proper parameter to use is MINSCALEDENOM
    instead.  The deprecated MINSCALE is the minimum scale at which this
    interface is valid. When a user reqests a map at a smaller scale, MapServer
    automatically returns the map at this scale. This effectively prevents the
    user from zooming in too far.  Scale is given as the denominator of the
    actual scale fraction, for example for a map at a scale of 1:24,000 use
    24000.
    
    .. deprecated:: 5.0

MINTEMPLATE
    Template to be used if above the minimum scale for the app, useful 
    for nesting apps.

OUTPUTFORMAT [mime-type]
    Format of the query output. Default is "text/html". This is experimental, 
    the use of the :ref:`OUTPUTFORMAT` object is recommended instead. 

TEMPLATE [filename|url]
    Template file or URL to use in presenting the results to the user in an 
    interactive mode (i.e. map generates map and so on ... )