General Configuration Properties

PROPERTY

EXPLANATION

 DEFAULTS

mapDiv

ID of div to contain the map.

 "map_container"

dragDiv

ID of div to contain draggable location icon

 "drag_container"

navDiv

ID of div to contain the navigation interface

None.  If not defined, there will not be a navigation window.

loginDiv

ID of div to contain the login interface

None.  If not defined, there will not be a login window.

langDiv

ID of div to contain the language interface

None.  If not defined, there will not be a language selection window.

selectDivID of div to contain the database search interface.  Typically this div will float in the middle of the screen.
"select_container".  It is strongly recommended that you use the default since styling is set for this div id. 

startLat

Latitude to use to initially center the map

42.369707 (Amherst, MA)

startLong

Longitude to use to initially center the map

-72.516051 (Amherst, MA)

startZoom

Initial map zoom level

12

mapTypeInitial map type.  Options are "ROADMAP","TERRAIN","HYBRID", and "SATELLITE".  Options are case-sensitive"ROADMAP"

user

User to use until someone authenticates

'' (blank string)

password

Password to use until someone authenticates

'' (blank string)

authority_level

Authority level to use until someone authenticates.  This only influences what is displayed.  It does not authorize changes to the database unless user/password are authorized

5 (Passerby)

language

Initial language to use

“English”

border

Do the divs have a border around them. This make them look like the other Extjs interface elements.  This value is not passed to aLogin or aBlog.  They must be set separately.

 

True

textFields

Array of arrays of titles to associate with information display for uploaded file in various languages. For Eample:

labelArray = new Array();

labelArray['English'] = new Array('label1"...);

labelArray['Dutch'] = new Array('D1'...);

 

If there are no labels for the language being used then the English labels are displayed.

“Title”,”Creator”, “Creator Dates”, “Media”, “Date”,” Size”, and “Source”. The assumption is that this is English. If you pass an array with any of the values set to ‘’, then the default will be used for that field.

allowedFieldTypes:

Array of allowed file types given as extension values (“.gif”).  Note that the program is case sensitive so you may need to include “.gif” and “.GIF”.  File types not in this array can not be uploaded.

 '.gif', '.GIF', '.png', '.PNG', '.jpg', '.JPG', '.doc', '.DOC', '.docx', '.DOCX', '.mov', '.MOV', '.wmv', '.WMV'.

If you pass this array, all the defaults are lost so if you want any of these file types, you would have to include them in your array.

navShadowShould a drop shadow be added to the navigation window.  This allows you to maintain a consistent appearance with the other windows if they have shadows.False
attribution_levelMinimum authority level a user must have in order to see Blog attributions.  In some cases privacy may require making the attribution unavailable to most users.0.  Everybody sees the attributions.
groupsWill the application use the group feature of MapAppFalse.  No groups
defaultIconURL of image to use as location icon when there are no location types.
'http://maps.google.com/mapfiles/kml/paddle/red-stars.png'
anchorXAlong the horizontal axis, what point of the icon is placed precisely over the location.12
anchorYAlong the vertical axis, what point of the icon is placed precisely over the location.24- Combined the default values for anchorX and anchorY cause  icon's bottom line to be centered over the location.  The icon is always 25x25 pixels in size.
instanceUnique value to associate with this instance of the mapAppObject.  Required if more than one instance is on the page or multiple pages are using the same database tables but with different data.
''
resizeOnGroupIf using groups, when the groups to be displayed change the zoom level is adjusted so all locations are shown.True
resizeOnLoadWhen aMapApp3 is loaded, the zoom is adjusted so all locations are shown.False
loginIf false, ignores all login capabilities included with aMapApp3.  This assumes that page access is completely controlled outside of aMapApp3.  This is different that just not providing a login div which suppresses the display but not the functionality which can still be accessed using the API.True
noShowIf true suppresses display of the map and other interface elements of aMapApp3.  Would be used if the map should not be displayed at load time.
False
draggableTrue if the user can drag the map within the map display area.  False if the map can't be dragged.  The map display area is always fixed.
True
startTabInitial tab for information window.  0 is the Location tab and 1 is the Files tab.0
imageTabInitial tab for the file information display. 0 is the description, 1 is the blog and 2 is notes.0
The following relate to searching capabilities.
flickrAre searches of flickr allowed?False
flickr_userid

Flickr id to use.  This limits the flickr search to that account.  If blank, there is no restriction. 

 

To find this string you'll need a Flickr account.  Then go to Flickr.com and login.  Then go to http://www.flickr.com/services/api/explore/?method=flickr.people.getInfo and look under the heading "useful information".

''
flickr_api_keyA key string provided by Flickr letting you access the Flickr database.  You get the key from Flickr.None.  This must be supplied to use search Flickr.
localTo we have a local database search?  If using a local search, this property must be sent to a string that is both the name of the file and the name of the function that does the search as in "searchYouTube" requires a file "searchYouTube.php" with a function "searchYouTube".  See the section on Searching File Repositories under Localization.
False
diskCan we search local/networked disks?True
The following relate to groups.
groupDivID of the div to contain the group interface.  The interface is 340px wide and variable height.None.  If not defined, the group interface will not be displayed.
currentGroupCurrent default.  This is the group that new locations would be assigned to.1 - 1 is a predefined default group that effectively includes everything and everybody.
collapsedShould the group display be initially shown in a collapsed form, i.e., only the title showing.False
The following relate to location types.  If the locationTypes array isn't defined, the other settings are meaningless.
locationTypes

Array of location type arrays.  This allows you to categorize the locations.  Each location type array contains an index field (starting with 1), the names of the different location types and the address of the icon to use for each type of location.  For example:

typeArray = [

   [1,"Park", "images/park.png"],

        ];

The icon reference can be a full http reference or a local reference relative to the application using MapApp.  In this case the icons where loaded into a “images” subfolder of the folder than contains our page.

 

For other languages, use the the locationTypesLabels setting below.

None.

 

If no array is passed, the user will not be able to classify a location by type.

locationTypesLabels

Array of arrays of alternative labels to use for location types by language.  For example

 

labelArray = new Array();

labelArray['Japanese'] = new Array("j1","j2","j3");

labelArray['French']=new Array("F1","F2","F3");

 

The language tag must match the language label used in the language file (See the sections of languges).  If you select a language for which you don't have label, it will default to "English" what are the labels included in locationTypes.

None.  Assumes the labels in locationTypes are English.
typeDivID of div to contain the location type display.  The interface is 340px wide and variable height.None.  If not defined, the type interface will not be displayed.
collapsedTypesShould the type display interface initial appear collapsed (true) or expanded (false)False
The following relate to document/file/entry types.  If the documentTypes array isn't defined, the other settings are meaningless.
documentTypes

Array of document type arrays.  This allows you to categorize uploaded files.  Each document type array contains an index field (starting with 1) and  the names of the different location types. For example:

typeArray = [

   [1,"Image"],

        ];

Unlike location types, there are no icon references since no icons are currently displayed based on document types.

None.

 

If no array is passed, the user will not be able to classify files by type.

docTypesLabels

Array of Arrays of labels for document types in languages other than English. For example,

 

doclabelArray = new Array();

doclabelArray['Japanese'] = new Array("j1","j2","j3");

doclabelArray['French']=new Array("F1","F2","F3");

 

The language tag must match the language label used in the language file (See the sections of languges).  If you select a language for which you don't have label, it will default to "English" what are the labels included in documentTypes.

Assumes labels are in English as defined by documentTypes.
docTypeDivID of div to contain the docment type display.  The interface is 340px wide and variable height.None.  If not defined, the type interface will not be displayed.
collapsedDocTypesShould the document type display interface initial appear collapsed (true) or expanded (false)False
The following properties are all objects that are passed to other objects within aMapApp3
locationConfigObject used to configure new locationsSee Location Configuration Properties
loginConfigObject used to configure new aLogin2 objectsSee Login Configuration Properties
blogConfigObject used to configure new aBlog2 objectsSee Blog Configuration Properties
aViewerConfigObject used to configure new aViewer objectsSee aViewer Configuration Properties

 

Note that some of the configuration options for objects used by aMapApp3 are set by aMapApp3.  Adding these properties to the configuration objects will have no effect.  For example, the blogConfig property of blogAuthority is determined by the authority level of the user in aMapApp3.