From MapbenderWiki

User:Melchior Moos

if you still use Mapbender < 2.4.x you find the TreeGDE documentation at Talk:TreeGDE (module changed - old discription)

Contents 1 English 1.1 Functionality 1.2 Options 1.3 See also 2 Deutsch 2.1 Funktionalität 2.2 Options 2.3 Siehe auch 3 Files 3.1 SQL to migrate from the old treeGDE 3.2 SQL 3.3 Element Vars 3.4 known issues

English

TreeGDE2 replaces TreeGDE and adds some more options to it. It is a collapsible folder structure displaying layers with the option to turn each on or off. The capabilities documents returned by WMS services are stored in the Mapbender database (cached). The WMS is separated into one root layer and one level of sublayers. Group information (nested layers) is already available in the database but is not used to display in TreeGDE2.

Functionality

• TreeGDE2 displays each WMS service as a directory
• Layers are displayed as text-strings with a checkbox
• Left check box activates corresponding layer in the map
• Every action (select or unselect checkbox) redraws the map (triggers a GetMap request)
• Another module does not directly redraw the map. Use for less traffic.
• Semantic highlighting: Whenever a layer drops out of the visible scale range it is greyed out (metric coordinate systems only).

Options

JavaScript-Variables:

• Set ficheckbox = false to display one single checkbox for both display and query.
• Set metadatalink=false to remove the default metadata link
• Set cssfile=<path> to include a css-file
• Set imagedir=<path> to specify the image collection
• Set switchwms=true to display a checkbox which enables / disables all layers of a wms
• Set alerterror=true to see an alert box if a wms fails to load
• Set wmsbuttons=true to have buttons for wms management
• Set showstatus=true to see the loading status of wms on their folder icon
• Set menu=<menu elements> to enable a contextmenu with <menu elements> options
• Set openfolder=<index> to define a folder that will open on every reload
• Set handlesublayer=true to have grouped layers visible
• Set reverse=true to make the display order of the tree more reasoned
• Set redirectToMetadataUrl = true to load the given metadata URL in the metadata pop up (Mapbender >=2.5, default is false)
• Set enlargetreewidth (from 2.6.1 see also http://trac.osgeo.org/mapbender/ticket/559)
  • false (default): no enlargement of the div
  • integer value: treeGDE div is enlarged (widened) on mouseover by the given value and restored to its initial width onmouseout. The treeGDE div binds the mousewheel event on mouseover, thus scrolling within the tree should be possible and no mousewheel zooming of the underlying mapframe should happen.

See also

• TreeGDE
• GDE
• ConfTreeGde
• SetBackground
• mod_treefolder2.php technical background (German)

Deutsch

TreeGDE2 ersetzt TreeGDE und fügt neue Optionen hinzu. Die Ordnerstruktur zeigt normalerweise die OGC WMS Capabilities, die Namen und Layer des eingebundenen WMS enthalten.

Funktionalität

• Die linke Box steuert die Sichtbarkeit des Layers
• Jede Mausaktion (auswählen, deselektieren) der Checkbox zeichnet die Karte neu (führt einen GetMap Request aus)
• Noch ein Modul zeichnet nicht direkt die Karte neu. Nützlich für wenig Datenverkehr.
• Layer außerhalb des sichtbaren Maßstabes (MinScale, MaxScale) werden ausgegraut dargestellt (nur bei metrischen Koordinatensystemen).

Options

JavaScript-Variablen:

• Die Einstellung ficheckbox = false nutzt eine einzige Checkbox für das An und Ausstellen der Anzeige und der Abfrage.
• Die Einstellung metadatalink=false unterdrückt den voreingestellten Verweis auf die Metadaten URL.
• Die Einstellung cssfile=<path> bindet eine Stylesheet-Datei ein
• Die Einstellung imagedir=<path> verweist auf die anzuzeigenden Bilder in der Baumstruktur
• Die Einstellung switchwms=true bietet eine Checkbox an, um alle Ebenen eines wms an/aus zu stellen
• Die Einstellung alerterror=true bewirkt, dass eine Alertbox erscheint, wenn das Laden eines Layers fehlschlägt
• Die Einstellung wmsbuttons=true zeigt Schaltflächen zur WMS-Verwaltung
• Die Einstellung showstatus=true zeigt den Ladestatus der WMS in Ihrem Ordnersymbol an
• Die Einstellung menu=<menu elemente> bewirkt, dass ein Kontextmenu mit den definierten Elementen erscheint
• Die Einstellung openfolder=<index> definiert einen anfangs geöffneten Ordner
• Die Einstellung handlesublayer=true regelt die Handhabung von gruppierten Layern
• Die Einstellung reverse=true legt fest, dass die Darstellungsreihenfolge logischer wird (oben auf der Karte = oben im Baum, nicht oben im Baum = zuerst gezeichnet)
• Die Einstellung redirectToMetadataUrl = true lädt die angegebene Metadaten URL in dem Metadaten Pop-Up (Mapbender >=2.5, Voreinstellung false)
• enlargetreewidth (from 2.6.1 see also http://trac.osgeo.org/mapbender/ticket/559)
  • false (default): keine Vergrößerung des divs
  • Angabe der Breite als Ganzzahl: treeGDE-div wird beim mouseover-Ereignis verbreitert. Beim Mouseover wird das mousewheel-vent an das Element treeGDE gebunden. Es sollte kein mousewheel-Zoom in der Karte stattfinden.

Siehe auch

• TreeGDE
• GDE allgemeine Beschreibung
• ConfTreeGde Konfigurierbare Baumstruktur
• SetBackground Hintergrundauswahl zur Auswahl (Option) vorgeben
• mod_treefolder2.php Hintergrundinformationen zum Modul

Files

https://mapbender.osgeo.org/source/browse/mapbender/trunk/mapbender/http/html/mod_treefolder2.php

https://mapbender.osgeo.org/source/browse/mapbender/trunk/mapbender/http/javascript/jsTree.js

SQL to migrate from the old treeGDE

UPDATE gui_element SET e_src = '../html/mod_treefolder2.php?sessionID' WHERE fkey_gui_id = 'gui' AND e_id = 'treeGDE'; UPDATE gui_element_vars SET var_value = '../img/tree_new' WHERE fkey_gui_id = 'gui' AND fkey_e_id ='treeGDE' AND var_name = 'imagedir'; UPDATE gui_element_vars SET var_value = '../css/treeGDE2.css' WHERE fkey_gui_id = 'gui' AND fkey_e_id ='treeGDE' AND var_name = 'cssfile';

SQL

INSERT INTO gui_element(fkey_gui_id, e_id, e_pos, e_public, e_comment, e_element, e_src, e_attributes, e_left, e_top, e_width, e_height, e_z_index, e_more_styles, e_content, e_closeTag, e_js_file, e_mb_mod, e_target, e_requires) VALUES('gui1', 'treeGDE', '0002', '1', 'directory tree, checkbox for visible, checkbox for querylayer,', 'iframe', '../html/mod_treefolder2.php?sessionID', 'frameborder = \\\"0\\\" ', '10', '220', '200', '300', '', 'visibility:visible', '', 'iframe', '', '', 'mapframe1', ''); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'cssfile', '../css/treeGDE2.css', 'global stylesheets' ,'file/css'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'ficheckbox', 'true', 'checkbox for featureInfo requests' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'imagedir', '../img/tree_new', 'image directory' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'metadatalink', 'true', 'link for layer-metadata' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'wmsbuttons', 'true', 'wms management buttons' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'alerterror', 'true', 'alertbox for wms loading error' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'showstatus', 'true', 'show status in folderimages' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'menu', '', 'context menu elements' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'openfolder', 'false', 'initial open folder' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'switchwms', 'false', 'enable/disable all layer from wms' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'handlesublayer', 'true', 'handle grouped layers' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui1', 'treeGDE', 'reverse', 'false', 'reverse the traditional order' ,'var'); INSERT INTO gui_element_vars(fkey_gui_id, fkey_e_id, var_name, var_value, context, var_type) VALUES('gui', 'treeGDE', 'enlargetreewidth', '300', 'false (default): no enlargement of the div, integer value to enlarge on mouseover' ,'var');

Element Vars

• cssfile
• ficheckbox
• imagedir
• metadatalink
• switchwms
• alerterror
• showstatus
• wmsbuttons
• menu
• openfolder
• reverse
• handlesublayer

known issues

see all treeGDE trac tickets