SALT Map

Uses google maps to visualise locations on a map. Creates a custom post type for locations and the possibility to have custom fields like address and other information. Then the information is formated for the info window with help of a template. By having the possibility to place the info window outside the map for small screens it functions well for mobile device too.

In addition to displaying the Locations it has support for search among locations with auto completion. The search will be one in all information about the location but all information does not have to be displayed by the template.

The map can be placed on whatever page or post you like with a short code. By giving the short code parameters global values can be override and locations can be filtered for each map. see short code section below for more details.

Templating

The info window is formated according to a template that is set in the global settings it is based on mustache.js tempting framework. There is an example template in the distribution of the plugin named template_example.html. It is the id that is refereed in the template.

Styling

The plugin adds the salt_map.css which can be used to add style to the info window.

API Key

The plugin will work for now without registering a API key with google since mine still is active but for reliability it is recommended to register your own. Here are some instructions on how to get an API key from Google.

Short Code

The salt map is integrated with the short code ‘salt_map’. It has several parameters. All
settings data can be override through the short code parameters, for a list of parameters
se “Available parameters” here below.
If you want to have several maps on one page then the instanceName parameter is mandatory.

Available parameters

• height, hight of this map instance.
• lat, inital center latetude.
• lng, inital center longitude.
• zoom, inital zoom.
• gridSize, limit for when to group locations
• maxWidth, max width of infowindow
• includeSearch, Add the search field by setting to true
• largeScreenLimit, screen size limit for when to display infowindow insode or outside map.
• filterAttribute, specifies an attribute to filter locations on. filterValue has to be set for this parameter to function.
• filterValue, specifies the value to filter attribute on, comarisone is made with LIKE. filterAttribute has to be set for this parameter to function.

Example

[salt_map height=500px instanceName=First]

Dependencies

• Markercluster
• Google maps API
• mustache.js

Known Limitations

• None that we know of

Installation of this plugin is fairly easy:

1. Download the plugin
2. Extract all the files.
3. Upload everything (keeping the directory structure) to the /wp-content/plugins/ directory.
4. There should be a /wp-content/plugins/salt_map directory now with all files in it.
5. Activate the plugin through the ‘Plugins’ menu in WordPress.

or

1. Install through wordpress.org
2. Activate the plugin through the ‘Plugins’ menu in WordPress.

Non yet.

1. 

   A map with several locations, locations position too closely is grouped automatically.

2. 

   Map showing location information inside map formated by template.

3. 

   Map showing location information outside the map for mobile devices.

4. 

   Search field with auto completion.

5. 

   Global Map settings.

6. 

   Global Map settings, showing how to add custom parameters for locations.

7. 

   Location settings derived form the fields added under global settings.

1.4.2

• Fix for if page CCS had set the img max-width to 100% with !imortant indication, controls in map was small and distorted. now the !important indication is also overridden.

1.4.1

• Fixed warnings when using ‘array_key_exists’

1.4.0

• Removed need for instanceName in short code when using several maps on one page
• When map has a height larger the the viewport, it is lessened to 50px less then viewport

1.3.1

• Fixed IE problems with load order and screen size detection.

1.3.0

• Added support for multiple maps on one page

1.2.0

• Made it possible to use icons from media archive.
• Moved files into folders.

1.1.0

• Added short code parameter for including

1.0.1

• Updated documentation.

1.0.0

• Initial release.