.. include :: substitutions.txt


.. index:: ! Configuration


Configuration
=====================


|GC| is configured through **Parameters**.

All parameters can be set in the :ref:`globalconfiguration` window, most of them can be overridden in the individual :ref:`overview_maps` menu item configuration (see: :ref:`overview_maps_config`), only a selected set of parameters can be set in :ref:`tag_maps`.

There are three places where parameters can be set:

#. main configuration
#. the "Parameters (Component)" tab (only for :ref:`overview_maps`)
#. parameters in the tag (only for :ref:`tag_maps`)
#. query string (only for :ref:`overview_maps`)

When :ref:`front_end` is enabled (see :ref:`front_end_parameters` below), the editor map window can also be configured through key-value-pairs in the hyperlink as explained in :ref:`front_end_configuration`.

.. note::

    Not all parameters are supported in the three methods, see the full parameters list below.

.. seealso::

    :ref:`tag_maps_configuration` and :ref:`automatic_maps_configuration`.


.. _globalconfiguration:

.. index:: Main configuration
    pair: Configuration; Main configuration

Main configuration
-------------------------

|GC| main configuration is done through the "Options" button in the main |GC| view (from |J| control panel, choose :menuselection:`Components-->GeoContent` then click on the "Options" icon on the right).



.. index:: Parameters
    pair: Configuration; Parameters

.. _parameters :

Parameters
---------------

This section contains a detailed list of all configuration parameters and their meaning.



General parameters
....................

This parameters are available in :ref:`globalconfiguration` window, the windows consists of different panels.

Parameters overview
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


.. tabularcolumns:: |l|l|p{7cm}|p{1cm}|p{1cm}|

.. include :: tables/gc_general_config.rst


.. _fe_configuration:



.. index:: Front-end parameters
    pair: Configuration; Front-end parameters

Front-end map view parameters
......................................

This group of options affects the appearance of the map, its size, the presence and position of the |TOC| and which layers are visible and automatically activated when the map is loaded. All of this options are also available in :ref:`tag_maps`.

Different :ref:`map_renderers` have slightly different configuration parameters.



|GM| parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


.. tabularcolumns:: |p{3cm}|l|p{8cm}|

.. include :: tables/gc_gmap_config.rst


|OLM| parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. tabularcolumns:: |p{3cm}|l|p{8cm}|

.. include :: tables/gc_olmap_config.rst

|OLWM| parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. tabularcolumns:: |p{3cm}|l|p{8cm}|

.. include :: tables/gc_olwidgetmap_config.rst


.. _tag_maps_parameters:


Tag maps parameters
...................

This is a list of parameters accepted by :ref:`tag_maps` (they can be setted as explained in :ref:`tag_maps_configuration`):

* map_latstart
* map_lngstart
* toc_style
* toc_position
* map_width
* map_height
* start_with_layers
* map_zoomstart
* toc_width
* toc_kml
* active_layer
* base_layers
* default_base_layer
* replace_target
* layer_filter_list
* show_mouse_position
* map_type


.. _front_end_parameters:

Front-end map edit parameters
.............................

Most of the configuration specific to front-end editing is performed assigning the right :ref:`permissions` to certain users or user groups.

This is a list of parameters accepted by :ref:`mapeditor_button` links (they can be set as explained in :ref:`tag_maps_configuration`):

* contentid (id of the |J| article)
* layerid (id of the layer)
* map_latstart
* map_lngstart
* map_width
* map_height
* map_zoomstart
* default_base_layer  (|OLM| and |OLWM| only)
* show_mouse_position
* button_text (text for the button)
* class (extra class for the button)