EDIT

 * @param array $copy passed by reference

 *  - migrating variables for map settings

    /*

     *  migrating variables for map settings

     */

    $cdm_map_distribution = array();

    $cdm_map_distribution['width'] = variable_get('cdm_dataportal_geoservice_display_width', 390);

    $cdm_map_distribution['height'] = $cdm_map_distribution['width'] / 2;

    _remove_variable('cdm_dataportal_geoservice_display_width');

    $cdm_map_distribution['bbox'] = variable_get('cdm_dataportal_geoservice_bounding_box', '-180,-90,180,90');

    _remove_variable('cdm_dataportal_geoservice_bounding_box');

    $cdm_map_distribution['show_labels'] = variable_get('cdm_dataportal_geoservice_labels_on', FALSE);

    _remove_variable('cdm_dataportal_geoservice_labels_on');

    $cdm_map_distribution['caption'] = variable_get('cdm_dataportal_geoservice_map_caption', '');

    _remove_variable('cdm_dataportal_geoservice_map_caption');

    $cdm_map_distribution['distribution_opacity'] = variable_get('cdm_dataportal_geoservice_distributionOpacity', '0.5');

    _remove_variable('cdm_dataportal_geoservice_distributionOpacity');

    $cdm_map_distribution['mapType'] = variable_get('cdm_dataportal_map_openlayers', 1);

    _remove_variable('cdm_dataportal_map_openlayers');

    // imageMap

    $cdm_map_distribution['image_map'] = array();

    $cdm_map_distribution['image_map']['base_layer']= variable_get('map_base_layer', 'cyprusdivs');

    _remove_variable('map_base_layer');

    $cdm_map_distribution['image_map']['bg_color'] = variable_get('map_bg_color', '1874CD');

    _remove_variable('map_bg_color');

    $cdm_map_distribution['image_map']['layer_style'] = variable_get('map_base_layer_style', 'ffffff,606060,,');

    _remove_variable('map_base_layer_style');

    // OpenLayers

    $cdm_map_distribution['openlayers'] = array();

    $cdm_map_distribution['openlayers']['base_layers'] = variable_get('baselayers', array('osgeo_vmap0' => 'osgeo_vmap0', 'PREFERRED' => 'osgeo_vmap0'));

    _remove_variable('baselayers');

    $cdm_map_distribution['openlayers']['show_layer_switcher'] = variable_get('cdm_dataportal_geoservice_showLayerSwitcher', TRUE);

    _remove_variable('cdm_dataportal_geoservice_showLayerSwitcher');

    $cdm_map_distribution['legend'] = array();

    $cdm_map_distribution['legend']['show'] = variable_get('cdm_dataportal_geoservice_legend_on', TRUE);

    _remove_variable('cdm_dataportal_geoservice_legend_on');

    $cdm_map_distribution['legend']['opacity'] = variable_get('cdm_dataportal_geoservice_legendOpacity', '0.5');

    _remove_variable('cdm_dataportal_geoservice_legendOpacity');

    $cdm_map_distribution['legend']['font_size'] = variable_get('cdm_dataportal_geoservice_legend_font_size', 10);

    _remove_variable('cdm_dataportal_geoservice_legend_font_size');

    $cdm_map_distribution['legend']['font_style'] = variable_get('cdm_dataportal_geoservice_legend_font_style', FALSE);

    _remove_variable('cdm_dataportal_geoservice_legend_font_style');

    $cdm_map_distribution['legend']['icon_width'] = variable_get('cdm_dataportal_geoservice_legend_icon_width', 35);

    _remove_variable('cdm_dataportal_geoservice_legend_icon_width');

    $cdm_map_distribution['legend']['icon_height'] = variable_get('cdm_dataportal_geoservice_legend_icon_height', 15);

    _remove_variable('cdm_dataportal_geoservice_legend_icon_height');

    variable_set('cdm_map_distribution', $cdm_map_distribution);

    $tasks_performed[] =  'variables for map settings migrated to new variable "cdm_map_distribution"';

// TODO remove if not needed (Andreas Kohlbecker 30.07.2013)

 * Similar compose function compose_distribution_map()

 *

  $map_settings = get_array_variable_merged(CDM_MAP_DISTRIBUTION, CDM_MAP_DISTRIBUTION_DEFAULT);

  if ($map_settings['map_type'] == 1) {

        $map_settings['width'],

        $map_settings['height'],

        $map_settings['bbox'],

        $map_settings['caption'],

        $map_settings['width'],

        $map_settings['height'],

        $map_settings['bbox'],

        $map_settings['caption']

  $map_settings = get_array_variable_merged(CDM_MAP_DISTRIBUTION, CDM_MAP_DISTRIBUTION_DEFAULT);

  $baseLayers = $map_settings['openlayers']['base_layers'];

  $gmap_api_key = variable_get('gmap_api_key', 'ABQIAAAAFho6eHAcUOTHLmH9IYHAeBRi_j0U6kJrkFvY4-OX2XYmEAa76BTsyMmEq-tn6nFNtD2UdEGvfhvoCQ');

                    boundingBox: '" . $map_settings['bbox'] . "',

                    distributionOpacity: '" . $map_settings['distribution_opacity'] . "',

                    legendOpacity: '" . $map_settings['legend']['opacity'] . "',

                    showLayerSwitcher: " . ($map_settings['openlayers']['show_layer_switcher'] ? 'true' : 'false') . ",

function get_openlayers_map($width, $height, $bounding_box = FALSE, $occurrenceQuery = FALSE, $distributionQuery = FALSE, $legendFormatQuery = FALSE, $map_caption = FALSE, array $event_listeners = array()) {

  $map_settings = get_array_variable_merged(CDM_MAP_DISTRIBUTION, CDM_MAP_DISTRIBUTION_DEFAULT);

    if(!$height){

      $height = $width / 2;

    }

    $out .= ' style="width: ' . $width . 'px; height:' . $height . 'px"';

  $labels_on = $map_settings['show_labels'];

function get_image_map($width, $height= NULL, $bounding_box = FALSE, $occurrenceQuery = FALSE, $distributionQuery = FALSE, $legendFormatQuery = FALSE, $map_caption = FALSE) {

  $map_settings = get_array_variable_merged(CDM_MAP_DISTRIBUTION, CDM_MAP_DISTRIBUTION_DEFAULT);

  $query_string = '&image=true&recalculate=false&legend=1&ms=' . $width . ($height ? ',' . $height : '')

  // Additional query parameters as set in the data portal admin section.

  . ($map_settings['show_labels'] ? '&label=' . $map_settings['show_labels'] : '');

    if ($map_settings['image_map']['bg_color'] ) {

      $additional_area_styles[] = $bgcolor_areaStyleId . ":" . $map_settings['image_map']['bg_color'] . ",,";

    if ($map_settings['image_map']['base_layer']) {

      $query_string = str_replace($layer_param_token . "tdwg4", "$layer_param_token" . $map_settings['image_map']['base_layer'] . ":" . $baselayer_areaStyleId, $query_string);

    if ($map_settings['image_map']['layer_style']) {

      $additional_area_styles[] = $baselayer_areaStyleId . ":" . $map_settings['image_map']['layer_style'];

                  "OSGEO Vmap0",

                    maxExtent: window.CdmOpenLayers.mapExtends.epsg_4326,

                    projection: new OpenLayers.Projection("EPSG:4326"),

                    isBaseLayer: true,

                    displayInLayerSwitcher: true

                  }

                );

         /**

          * TODO unused, can be deleted?

          */

         case 'edit-etopo1':

                    maxExtent: window.CdmOpenLayers.mapExtends.epsg_4326,

                    projection: new OpenLayers.Projection("EPSG:4326"),

                    isBaseLayer: true,

                    displayInLayerSwitcher: true

                  }

                );

        /**

         * TODO unused, can be deleted?

         */

        case 'edit-vmap0_world_basic':

        minZoom: 0,

        /**

         * allows the map to display parts of the layers which are outside

         * the maxExtent if the aspect ratio of the map and of the baselayer

         * are not equal

         */

        displayOutsideMaxExtent: true,

        customWMSBaseLayerData: {

            name: "Euro+Med",

            url: "http://edit.africamuseum.be/geoserver/topp/wms",

            params: {layers: "topp:em_tiny_jan2003", format:"image/png", tiled: true},

            projection: "EPSG:7777777",

            maxExtent: "-1600072.75, -1800000, 5600000, 5850093",

            unit: 'm'

        }

//    var dataProj = new OpenLayers.Projection("EPSG:4326");

      createLayers(options.baseLayerNames, options.defaultBaseLayerName, options.customWMSBaseLayerData);

      initMap();

        info += "<dt>map resolution:<dt><dd>" + map.getResolution() + "</dd>";

        info += "<dt>map max resolution:<dt><dd>" + map.getMaxResolution() + "</dd>";

        info += "<dt>map scale:<dt><dd>" + map.getScale() + "</dd>";

        info += "<dt>map extent bbox:<dt><dd>" + map.getExtent().toBBOX() + " (" + mapExtendDegree.toBBOX() + ")</dd>";

        info += "<dt>map maxExtent bbox:<dt><dd>" + map.getMaxExtent().toBBOX() + "</dd>";

     * Initialize the Openlayers Map with the base layer

    var initMap = function(){

//      var maxExtentByAspectRatio = cropBoundsToAspectRatio(defaultBaseLayer.maxExtent, mapWidth/mapHeight);

      // gmaps has no maxExtent at this point, need to check for null

          maxResolution = Math[(options.displayOutsideMaxExtent ? 'max' : 'min')](

                      defaultBaseLayer.maxExtent.getWidth() / mapWidth,

                      defaultBaseLayer.maxExtent.getHeight() / mapHeight

                    );

      console.log("mapOptions.maxResolution: " + maxResolution);

      console.log("mapOptions.restrictedExtent: " + defaultBaseLayer.maxExtent);

              // in its maximum extent into the available view port so that no additinal

              // IMPORTANT!!!

              // the maxResulution set here will be overwritten if the baselayers maxResolution

              // it is set

              // setting restrictedExtent the the maxExtent prevents from panning the

      // calculate the bounds to zoom to

      // zoom to the extent of the bbox

//      if(map.getZoom() > options.maxZoom){

//        map.zoomTo(options.maxZoom);

//      } else if(map.getZoom() < options.minZoom){

//        map.zoomTo(options.minZoom);

//      }

          newBounds.transform(layer.projection, map.getProjectionObject());

          map.zoomToExtent(dataBounds, false);

     var createLayers = function( baseLayerNames, defaultBaseLayerName, customWMSBaseLayerData){

       var i = 0;

       for(; i <  baseLayerNames.length; i++) {

       if(false && customWMSBaseLayerData){

            var wmsLayer = createWMSBaseLayer(

                   customWMSBaseLayerData.name,

                   customWMSBaseLayerData.url,

                   customWMSBaseLayerData.params,

                   customWMSBaseLayerData.projection,

                   customWMSBaseLayerData.unit,

                   OpenLayers.Bounds.fromString(customWMSBaseLayerData.maxExtent)

                );

           // FIXME remove HACK (customWMSBaseLayerData as default)

           baseLayers[i++] = wmsLayer;

           defaultBaseLayer = wmsLayer;

       }

      * @return the bboxstring projected onto the layer and intersected with the maximum extent of the layer

             // transform bounding box given in degree values to the projection of the base layer

             zoomToBounds.transform(CdmOpenLayers.projections.epsg_4326, layer.projection);

         } else if(layer.maxExtent) {

             zoomToBounds = layer.maxExtent;

             // no need to transform since the bounds are obtained from the layer

             // transform bounding box given in degree values to the projection of the base layer

             zoomToBounds.transform(CdmOpenLayers.projections.epsg_4326, layer.projection);

     /**

      * Creates a WMS Base layer

      * @param String name

      *     A name for the layer

      * @param String url

      *     Base url for the WMS (e.g.  http://wms.jpl.nasa.gov/wms.cgi)

      * @param Object params

      *     An object with key/value pairs representing the GetMap query string parameters and parameter values.

      * @param Object projection

      *    A OpenLayers.Projection object

      */

     var createWMSBaseLayer= function(name, url, params, projection, unit, maxExtent){

         if(maxExtent == null){

             maxExtent = CdmOpenLayers.mapExtends.epsg_4326.clone();

             maxExtent.transform(CdmOpenLayers.projections.epsg_4326, projection);

         }

         return  new OpenLayers.Layer.WMS(

                 name,

                 url,

                 params,

                 {

                   maxExtent: maxExtent,

                   projection: projection,

                   unit: unit,

                   isBaseLayer: true,

                   displayInLayerSwitcher: true

                 }

               );

     };

define('CDM_MAP_DISTRIBUTION', 'cdm_map_distribution');

define('CDM_MAP_DISTRIBUTION_DEFAULT', serialize(array(

  // needs to be merged with user setting by drupal_array_merge_deep()

  'width' => 512, // optimum size for OSM layers is 512

  'height' => 512 / 2, // optimum size for OSM layers 256

  'bbox' => '', // empty to allow automatic zooming to extend

  'show_labels' => FALSE,

  'caption' => '',

  'distribution_opacity' => '0.5',

  'map_type' => 1, //  1 = 'openlayers', 0 = 'image'

  'image_map' => array(

    'base_layer' => '', // none, formerly this was cyprusdivs

    'bg_color' => '1874CD',

    'layer_style' => 'ffffff,606060,,',

  ),

  'openlayers' => array(

    'base_layers' =>  array(

      // A layer MUST NOT BE SET in the defaults,

      // otherwise it can not be overidden by the user settings:

      // 'osgeo_vmap0' => 'osgeo_vmap0',

      // it is sufficient to define the preferred layer,

      // since it will automatically be enabled:

      'PREFERRED' => 'osgeo_vmap0'),

    'show_layer_switcher' => TRUE

  ),

  'legend' => array(

    'show' => TRUE,

    'opacity' => '0.5',

    'font_size' => 10,

    'font_style' => FALSE,

    'icon_width' => 35,

    'icon_height' => 15

  )

)));

/**

 * Merges the named array variable with the array of defaults.

 *

 * @param string $variable_name

 *     The variable name

 * @param string | array $default

 *     The array containing the default values either as array or serialized as string.

 *     Unserialization is cared for if nessecary

 * @return array

 *     The merged array as returnd by drupal_array_merge_deep()

 */

function get_array_variable_merged($variable_name, $default){

    // unserialize if nessecary

    if(!is_array($default)){

      $default = unserialize($default);

    }

    $variable = variable_get($variable_name, array());

    return drupal_array_merge_deep($default, $variable);

}

  return get_array_variable_merged($gallery_config_form_name, CDM_DATAPORTAL_GALLERY_SETTINGS);

  $current_geoserver_settings = get_edit_map_service_settings();

  $map_distribution = get_array_variable_merged(CDM_MAP_DISTRIBUTION, CDM_MAP_DISTRIBUTION_DEFAULT);

  $dummy_distribution_query = NULL;

  if($map_distribution['map_type'] != 1){

    // we need to apply a dummy query since the map serice requires for image maps

    // at least as and ad to be defined

    $dummy_distribution_query = "as=a:339966&ad=tdwg1:a:1,2,3,4,5,6,7,8,9";

  }

      '#description' => 'The preview of the map'

       . ($dummy_distribution_query != null ? ' may not be accurate in case if image maps, please check the map display in the taxon pages.': '.')

  $form['map_preview']['map'] = compose_map(NULL, $dummy_distribution_query, NULL,

  $localhostkey = 'ABQIAAAAFho6eHAcUOTHLmH9IYHAeBRi_j0U6kJrkFvY4-OX2XYmEAa76BTsyMmEq-tn6nFNtD2UdEGvfhvoCQ';

  $gmap_api_key = variable_get('gmap_api_key', 'ABQIAAAAFho6eHAcUOTHLmH9IYHAeBRi_j0U6kJrkFvY4-OX2XYmEAa76BTsyMmEq-tn6nFNtD2UdEGvfhvoCQ');

  $form['gmap_api_key'] = array(

      '#type' => 'textfield',

      '#title' => t('Google maps API key') . ':',

      '#default_value' => variable_get('gmap_api_key', $gmap_api_key),

      '#description' => t('If you want to use the Google Maps Layer, a key is

      needed. If you need a key, visit

      <a href="http://code.google.com/intl/en/apis/maps/signup.html">google maps api key</a>.

      <br/><strong>Note:</strong> The following key: <code>!localhostkey</code>

      is the default key for the localhost (127.0.0.1).',

      array('!localhostkey' => $localhostkey)),

  );

  $form[CDM_MAP_DISTRIBUTION] = array(

    '#tree' => TRUE,

  /*

   * settings for the distribution map are used also for specimens map!!!!

   */

  $form[CDM_MAP_DISTRIBUTION]['width'] = array(

    '#title' => 'Width',

    '#default_value' => $map_distribution['width'],

    '#maxlength' => 4,

    '#size' => 4,

    '#description' => 'Width of the map. To allow OSM baselayers to zoom out to the full extend of the world the map width must be

  $form[CDM_MAP_DISTRIBUTION]['height'] = array(

      '#type' => 'textfield',

      '#title' => 'Height',

      '#default_value' => $map_distribution['height'],

      '#maxlength' => 4,

      '#size' => 4,

      '#description' => 'Height of the map. Depending on the chosen base layer you may want to choose the height equal

      to the width or half of the width. Any other aspect ratio is also possible if desired.',

  );

  $form[CDM_MAP_DISTRIBUTION]['bbox'] = array(

    '#title' => 'Bounding box',

    '#default_value' => $map_distribution['bbox'],

    '#description' => t('The bounding box defines the area to be initially displayed in maps.

      to let the map <strong>automatically zoom</strong> to the bounds enclosing the shown data.'),

  $form[CDM_MAP_DISTRIBUTION]['show_labels'] = array(

    '#title' => 'Display area labels',

    '#default_value' => $map_distribution['show_labels'],

    '#description' => t('The map will show name labels of the areas'),

  $form[CDM_MAP_DISTRIBUTION]['caption'] = array(

    '#title' => 'Map caption',

    '#default_value' => $map_distribution['caption'],

    '#description' => t('The caption will be shown below the map.'),

  $form[CDM_MAP_DISTRIBUTION]['distribution_opacity'] = array(

    '#title' => 'Distribution layer opacity',

    '#default_value' => $map_distribution['distribution_opacity'],

  $form[CDM_MAP_DISTRIBUTION]['map_type'] = array(

    '#title' => 'Map types',

      1 => "OpenLayers dynamic map viewer",

    '#default_value' => $map_distribution['map_type'],

    '#description' => 'Two different map types are available :

      <ul><li><em>OpenLayers</em>: Display the maps in an interactive viewer

      which allows zooming and panning. If enabled you can configure the default layer

      (background of your maps) below.</li>

      <li><em>Plain image</em>: The map will be static non interactive

      image.</li></ul>',

  $open_layers_is_enabled = $map_distribution['map_type'] == 1;

  $form[CDM_MAP_DISTRIBUTION]['image_map'] = array(

    '#title' => 'Plain image map settings',

    '#tree' => TRUE,

    '#collapsed' => $open_layers_is_enabled,

    '#description' => 'The settings in this section are still expertimental

      and can only be used with the EDIT map service version 1.1 or above.',

    $form[CDM_MAP_DISTRIBUTION]['image_map']['#description'] = '<div class="messages warning">' . t("The chosen EDIT map service version ($edit_mapserver_version) is too low, it must be at least 1.1") . '</div>'

      . $form[CDM_MAP_DISTRIBUTION]['image_map']['#description'];

  $form[CDM_MAP_DISTRIBUTION]['image_map']['base_layer'] = array(

    '#title' => 'Background layer',

    '#default_value' => $map_distribution['image_map']['base_layer'],

      '!url1' => l('deegree-csw', 'http://edit.africamuseum.be:8080/deegree-csw/md_search.jsp'),

      '!url2' => l('geoserver layers', 'http://edit.africamuseum.be/geoserver/web/'),

  $form[CDM_MAP_DISTRIBUTION]['image_map']['bg_color'] = array(

    '#title' => 'Background color',

    '#default_value' => $map_distribution['image_map']['bg_color'],

  $form[CDM_MAP_DISTRIBUTION]['image_map']['layer_style'] = array(

    '#title' => 'Background layer style',

    '#default_value' => $map_distribution['image_map']['layer_style'],

    '#description' => 'Syntax: {Area fill color},{Area stroke color},{Area stroke width},{Area stroke dash style}',

  $form[CDM_MAP_DISTRIBUTION]['openlayers'] = array(

    '#title' => 'OpenLayers settings',

    '#tree' => TRUE,

    '#collapsed' => !$open_layers_is_enabled,

  if (!$open_layers_is_enabled) {

    $form[CDM_MAP_DISTRIBUTION]['openlayers']['#description'] = '<div class="messages warning">'

        . 'The Openlayers viewer is currently not enabled! (see section Maps settings above )</div>'

        . $form[CDM_MAP_DISTRIBUTION]['openlayers']['#description'];

//     'veroad' => 'Virtual Earth Roads',

//     'veaer' => 'Virtual Earth Aerial',

//     'vehyb' => 'Virtual Earth Hybrid',

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['base_layers'] = array(

    '#title' => 'Base Layers',

    '#default_value' =>  $map_distribution['openlayers']['base_layers'],

    '#description' => 'Choose the baselayer layer you prefer to use as map background in the OpenLayers dynamic mapviewer.',

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['show_layer_switcher'] = array(

    '#title' => 'Show Layer Switcher',

    '#default_value' => $map_distribution['openlayers']['show_layer_switcher'],

    '#description' => 'The Layer Switcher control displays a table of contents

      base layers and to show or hide overlays.  By default the switcher is

      by clicking on the handle.',

  /*

   * Map Legend

   */

  $form[CDM_MAP_DISTRIBUTION]['legend'] = array(

    '#title' => 'Map legend',

    '#tree' => TRUE,

    '#description' => 'Configure the maps legend.',

  $form[CDM_MAP_DISTRIBUTION]['legend']['show'] = array(

    '#title' => 'Display a map legend',

    '#default_value' => $map_distribution['legend']['show'],

    '#description' => 'Check this if you like a legend to be displayed with the maps.',

  $form[CDM_MAP_DISTRIBUTION]['legend']['opacity'] = array(

    '#title' => 'Legend opacity',

    '#default_value' => $map_distribution['legend']['opacity'],

    '#description' => 'Valid values range from 0.0 to 1.0. Value 1.0 means the legend will be fully visible, while a value near

                         to 0.0 will be not much visible.',

  $form[CDM_MAP_DISTRIBUTION]['legend']['font_size'] = array(

    '#title' => 'Font size',

    '#default_value' => $map_distribution['legend']['font_size'],

    '#description' => 'Font size in pixels.',

  $form[CDM_MAP_DISTRIBUTION]['legend']['font_style'] = array(

    '#title' => 'Available font styles',

    '#default_value' => $map_distribution['legend']['font_style'],

    '#description' => 'Select a font style for the map legend.',

  $form[CDM_MAP_DISTRIBUTION]['legend']['icon_width'] = array(

    '#title' => 'Icon width',

    '#default_value' => $map_distribution['legend']['icon_width'],

    '#description' => 'Legend icon width in pixels.',

  $form[CDM_MAP_DISTRIBUTION]['legend']['icon_height'] = array(

    '#title' => 'Icon height',

    '#default_value' => $map_distribution['legend']['icon_height'],

    '#description' => 'Legend icon height in pixels.',

  // compose the element name

  $parents = array();

  array_deep_copy($element['#parents'], $parents);

  $parents[count($parents) -1 ] .= '_preferred';

  $element_name = $parents[0];

  for ($i=1; $i < count($parents); $i++){

    $element_name .= '[' . $parents[$i] . ']';

  }

          '#name' => $element_name,

 * @param $element

 *   This includes the current persistent storage data for the form.

 *   Additional information, like the sanitized $_POST data,

 *   is also accumulated here in $form_state['input']

function checkboxes_preferred_after_build($element, &$form_state) {

  $parent_id = $element['#parents'][count($element['#parents']) - 1];

    // TODO use  $form_state['input'] instead of POST !!!

    $parents = array();

    array_deep_copy($element['#parents'], $parents);

    $parents[count($parents) - 1] .= '_preferred';

    $preferred_layer = drupal_array_get_nested_value($_POST, $parents);

    $element['#value']['PREFERRED'] = $preferred_layer;

//     $form_state[$parent_id] = $element['#value'];

//     $form_state['values']['baselayers'] = $element['#value'];

    $form_state_element_values = &drupal_array_get_nested_value($form_state['values'], $element['#parents']);

    $form_state_element_values = $element['#value'];

    $preferred_layer = $element['#value']['PREFERRED'];

  foreach ($children = element_children($element) as $key) {

    if (!empty($element[$key]['#type']) && $element[$key]['#type'] == 'radio') {

      $element[$key]['#value'] = $preferred_layer;

  $element[$preferred_layer]['#value'] = $preferred_layer;

  return $element;

 * @param $form

 *   Nested array of form elements that comprise the form.

          $map_render_element = compose_distribution_map($taxon);

          $block->content .= $map_render_element['#markup'];

 * Composes the render array for a distribution map of the given taxon.

 *

 * The distribution map can either be a plain image or a dynamic open layers map

 * depending on the settings.

 *

 * compose_hook() implementation

 *

 * @param $taxon

 *   The CDM Taxon instance to create the distribution map for.

 * @return array

 *    A drupal render array

 *

 * Similar compose function compose_map()

 *

 * @ingroup compose

function compose_distribution_map($taxon) {

  $map_settings = get_array_variable_merged(CDM_MAP_DISTRIBUTION, CDM_MAP_DISTRIBUTION_DEFAULT);

  if ($map_settings['map_type'] == 1) {

    $legendFormatQueryStr = "format=image" . urlencode('/') . "png"

         . "&TRANSPARENT=TRUE"

         . "&WIDTH=" . $map_settings['legend']['icon_width']

         . "&HEIGHT=" . $map_settings['legend']['icon_height']

           // TODO why is the layer=topp:tdwg_level_4 parameter needed at all here??

           // AK: i think the tdwg_level_4 is used as place holder and will be replaced later on

           // => search for "tdwg_level_4" in the code

         . "&layer=topp" . urlencode(':') . "tdwg_level_4"

         . "&LEGEND_OPTIONS=forceLabels" . urlencode(':') . "on"

             . ";fontStyle" . urlencode(':') . $fontStyles[$map_settings['legend']['font_style']]

             . ";fontSize" . urlencode(':') .  $map_settings['legend']['font_size']

         . "&SLD=";

    $out .= get_openlayers_map(

        $map_settings['width'],

        $map_settings['height'],

        $map_settings['bbox'],

        NULL,

        $query_string,

        $legendFormatQueryStr,

        $map_settings['caption']

     );

    $out = get_image_map(

        $map_settings['width'],

        $map_settings['height'],

        $map_settings['bbox'],

        NULL,

        $query_string,

        $legendFormatQueryStr,

        $map_settings['caption']

    );

  return markup_to_render_array($out);