.. include :: substitutions.txt 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: Main configuration ------------------------- |GC| main configuration is done through the "Parameters" button in the main |GC| view (from |J| control panel, choose :menuselection:`Components-->GeoContent` then click on the "Parameters" icon on the right). .. figure :: images/gc_globalconfig.* The "Parameters" configuration window. .. _parameters : Parameters --------------- This section contains a detailed list of all configuration parameters and their meaning. General parameters .................... This options are available in :ref:`globalconfiguration` window and :ref:`overview_maps` menu item configuration (see: :ref:`overview_maps_config`). .. tabularcolumns:: |l|l|p{7cm}|p{1cm}|p{1cm}| ================ ==================== ================================================== ===================== =================================== Label Name Notes Available in tag maps Available in front-end editor links ================ ==================== ================================================== ===================== =================================== Google API key google_api_key The API key is different for every No No domain on the internet and you can obtain one for your website from ``_ Map lat center gmap_latstart Latitude of the map center Yes Yes Map lon center gmap_lngstart Longitude of the map center Yes Yes Default map type gmap_type Default map type (G_SATELLITE_MAP, Yes Yes G_NORMAL_MAP, G_HYBRID_MAP, G_PHYSICAL_MAP) Map zoom level gmap_zoomstart Map zoom level at start Yes Yes Icon folder point_icon_folder Icon's subdirectory (under No No directory `images`, so `stories/geocontent` translates to `images/stories/geocontent`) Article's ID contentid Show items for this particular |J| article Yes Yes ================ ==================== ================================================== ===================== =================================== 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 available in :ref:`tag_maps`. .. tabularcolumns:: |p{3cm}|l|p{8cm}| ============================== ==================== ================================================== Label Name Notes ============================== ==================== ================================================== Map width (%) map_width The width of the map wrapper DIV in percent Map height (px) map_height The height of the map wrapper DIV in pixels TOC style toc_style Style of the Table Of Contents (layers list): * none: TOC is hidden * list: TOC layer elements are drawn as list items * select: TOC is drawn as a drop-down select [1]_ TOC position toc_position TOC position in respect to the map window within the map wrapper DIV TOC width (%) toc_width The width of the TOC frame (in %) when it is positioned at the left or at the right of the map frame. This option has no effect when toc_style is top or bottom KML icon toc_kml Shows in the |TOC| a small globe icon with an hyperlink to the KML file for the layers Active layers at start start_with_layers Define which layer should be switched on at startup. Choose 'selected' and pick one from the list if you want to start with a particular layer [1]_ Selected active layer active_layer Select here the layer that should be switched on at startup if you choose 'select' as start_with_layers parameter value [1]_ Open links in the same window replace_target Open balloon links in the same window. Replace `target = _blank` in the map balloon links, so that they are opened in the same window ============================== ==================== ================================================== .. _front_end_parameters: Front-end map edit parameters .................................. This group of options affects front-end (the public side of |J|) editing functionality. For security reasons, none of this options are available in :ref:`tag_maps`. .. tabularcolumns:: |p{3cm}|l|p{8cm}| ============================== ==================== ================================================== Label Name Notes ============================== ==================== ================================================== Front-end access front_end_enabled If the front-end users can edit/create maps. This option completely enable/disable front-end map editing Minimum access level front_end_level Minimum user lever for front-end map handling Check article's user access front_end_check_user Additionally check if the user can edit the article. Activate this option if you want to prevent users to add/edit maps on articles they have no editing permissions. This is an additional internal check, that make only sense if the map editing window is activated directly with a link, the normal **geocontent_editors-xtd** plugin behaviour is to add a button under the article's editor window, this means that |J|'s standard permission check is never overridden. Unbound items front_end_unbound If enabled, it allows front end user to add map items without linking to existing articles Custom URLs allowed front_end_url Accepts arbitrary URLs for links in ballons when created from the front end (can be a security risk!) Add only, no edit front_end_add_only If this option is enabled and front-end editing is allowed, front-end users will only be allowed to add new |GCIs| and cannot edit existing ones Article's ID contentid Edit items for this particular |J| article ============================== ==================== ================================================== .. [1] When **toc_style** is **select** only one |GCL| at a time can be shown, so some options (like **start_with_layers=all**) are ignored.