[[TOC]]

[DocManual >> Back to manual ]

= Settings in the XML file (config_default.xml) =
'''for p.mapper version 4.x'''

== <pmapper> ==
{{{

<!--
 MapServer Version 
 necessary only if extension dl() function is used
 corresponding to naming of php_mapscript_xx.dll/.so
 e.g. for php_mapscript_50.dll set
 <msVersion>50</msVersion>
 if not set php_mapscript.dll/.so 
 is assumed to be the extension name
-->
<msVersion>52</msVersion>


<!--
 Debug level: writes debugging info in pm_debug.log in the 
 same directory as PHP error log file requires php.ini 
 setting 'error_log' to be set to a valid file
 0: no debug 1: lowest debug level
-->
<debugLevel>3</debugLevel>


<!--
 PLUGINS activated
 a separate <plugins> tag for every plugin to be loaded
-->
<plugins>scalebar</plugins>
<plugins>transparency</plugins>
}}}


== <config> ==
{{{

<!--
 Configuration directory under /config/
 - for js_<php 
 - without slashes or backslashes
 - default value is: default
 === OPTIONAL ===
-->
<pm_config_location>default</pm_config_location>


<!--
 path of search config file for attribute search

 - relative file name under pm_config_location
 - or absolute path in filesystem (use slashes)
 default value is: inline
 === OPTIONAL ===
-->
<pm_search_configfile>default/search.xml</pm_search_configfile>


<!--
 WEB location for incphp dir
 === OPTIONAL ===
---------------------------------
<pm_incphp_location = ../../pmapper2lib/incphp


<!--
 WEB location for javascript dir
 === OPTIONAL ===
-->
<pm_javascript_location = ../../pmapper2lib/javascript
<pm_javascript_location = javascript/compressed 


<!--
 CONFIG FILEE FOR PRINTING
 path relative to /config/
 (same level as this <ini)
 defaults to common/print.xml
-->
<pm_print_configfile = common/print.xml

}}}



== <map> ==
{{{

<!--
 ALL groups displayed in TOC in this order
 - without definition, the order from map file will be taken.
 - <group> tag for every group/layer
 General rule: if a layer belongs to a group, use the group name, 
 otherwise use the layer name. 
 !!! Layer and group names must not have spaces. !!!
 === RECOMMENDED ===
-->
<allGroups>
    <group>countries</group>
    <group>cities10000eu</group>
    <group>cities10000eu_db</group>
    <group>rivers</group>
</allGroups>

<!--
 Default Groups (visible at start)
 === RECOMMENDED ===
-->
<defGroups>
    <group>countries</group>
    <group>cities10000eu</group>
</defGroups>

<!--
 Groups/Layers that shall be mutually disabled 
 if one is clicked, the other ones will be disabled
-->
<mutualDisableList>
    <group>countries</group>
    <group>dem</group>
</mutualDisableList>

<!--
 Groups/Layers list where to use auto_identify(tooltip) function
 === OPTIONAL ===
-->
<autoIdentifyGroups>

<!--
 Automatically refresh map when selection of 
 layers/grouops has changed in TOC
-->
<layerAutoRefresh>1</layerAutoRefresh>


<!--
 Image formats
 Image format for map and legend icons, like png, agg_png, jpeg
 formats with names defined in Map file
-->
<imgFormat>png</imgFormat>

<!--
 alternative Image format for map 
 useful eg. for imagery data
 -->
<altImgFormat>jpeg</altImgFormat>

<!--
 layer list (comma separated) that shall activate alternative
 image format when one of these layers has status ON
 -->
<altImgFormatLayers>
    <layer>jpl_wms_global_mosaic</layer>
    <layer>dem</layer>
</altImgFormatLayers>


<!--
 Define start and end scale for zoom slider
 => Adapt to specific extents of the datasets
 or use 'max' for automatically calculate from map file
-->
<sliderMax>max</sliderMax>
<sliderMin>100000</sliderMin>
}}}


== <query> ==
{{{
<!--
 Limit for results of selection with select tool or search
-->
<limitResult>300</limitResult>

<!--
 Highlight color for identify/search zoom in
 RGB values, separated with commas
-->
<highlightColor>0 255 255</highlightColor>

<!--
 Map file template used for highlighting query results
 use relative path towards /config/
 if not specified then default highlighting 
 is used applying values from highlightColor
-->
<tplMapFile>common/template.map</tplMapFile>

<!--
 Defines if SELECT function causes feature highlight
-->
<highlightSelected>1</highlightSelected>

<!--
 AUTOZOOM: zoom in automatically after results are displayed
 possible values: off  search  nquery (= select)
-->
<autoZoom>search </autoZoom>
<autoZoom>nquery</autoZoom> 

<!--
 Add button 'zoom to All Features' to result table
 - possible values: off  search  nquery (= select)
-->
<zoomAll>nquery</zoomAll>
<zoomAll>search</zoomAll>

<!--
 How to show the query results (identify/search) 
 dynwin: open DHTML window
 anything else will be used as id of the DOM elment where to place the query result
-->
<infoWin>dynwin</infoWin>

<!--
 Automatically align column contents of result tables of queries
 with regard to data type (default, numeric, currency, etc)
 algorithm in 'sorttable.js', function 'ts_alignCols(table)'
-->
<alignQueryResults>1</alignQueryResults>

<!--
 Extent buffer for zoom extent for point layers in queries
 value in map units
-->
<pointBuffer>10000</pointBuffer>

<!--
 Extent buffer for zoom extent for non-point layers in queries
 value in a fraction of the original extent
-->
<shapeQueryBuffer>0.02</shapeQueryBuffer> 

}}}


== <ui> ==
{{{

<!--
 Categories Style in TOC: 
 (only has effect when useCategories = 1) 
 - tree or flat
-->
<tocStyle>tree</tocStyle>

<!--
 Legend Style: 
 - attached: together with TOC
 - swap: swapping with TOC
-->
<legendStyle>attached</legendStyle>


<!--
 Use categories to thematically group layers 
 categories defined in incphp/custom.php
 works for TOC setting 'flat' and 'tree'
 1 = yes,  0 = no
-->
<useCategories>1</useCategories>

<!--
 use checkboxes for en/disable complete categories
 with child groups/layers. 1 = yes,  0 = no
-->
<catWithCheckbox>1</catWithCheckbox>

<!--
 Layer list (TOC) automatically updated according to scale
-->
<scaleLayers>1</scaleLayers>

<!--
 Icon Width in pixels
-->
<icoW>18</icoW>

<!--
 Icon Height in pixels
-->
<icoH>14</icoH>
}}}


== <locale> ==
{{{

<!--
 Default language
-->
<defaultLanguage>en</defaultLanguage>

<!--
 Default character set
 UTF-8
-->
<defaultCharset>UTF-8</defaultCharset>

<!--
 if map file contains non-ASCII characters,eg for layer DESCRIPTION or CLASS names, 
 and is not in UTF (UNICODE) encoding set value to 1
-->
<map2unicode>1</map2unicode>

}}}


== <print> ==
{{{

<!--
 PDF print resolution
 - Factor to increase resolution for better image quality 
-->
<pdfres>2</pdfres>

<!--
Print formats
-->
<printImgFormat>png</printImgFormat>
<printAltImgFormat>jpeg</printAltImgFormat>
            

}}}


== <download> ==
{{{
<!--
DPI levels for map download
- used in downloaddlg.phtml
-->
<dpiLevels>150</dpiLevels>
<dpiLevels>200</dpiLevels>
<dpiLevels>300</dpiLevels>
}}}


== <php> ==
{{{
<pearDbClass>MDB2</pearDbClass>
}}}


== <pluginsConfig> ==
Plugin-specific config setiings. See README for every plugin how to define
{{{
<export>
    <formats>XLS</formats>
    <formats>CSV</formats>
    <formats>PDF</formats>
</export>
}}}


== <searchlist> ==
The search definitions can be either directly defined in this XML file: "inline" option
{{{
<config>
   <pm_search_configfile>inline</pm_search_configfile>
   ...
</config>
}}}

or in a separate file below the custom config directory: define relative file path to search.xml
{{{
<config>
   <pm_search_configfile>default/search.xml</pm_search_configfile>
   ...
</config>
}}}

See [DocManualsearch Search definition via XML file ] for more details.