=== SALT Map === Contributors: Samuel Erdtman Tags: Google Maps, SALT, locations, map Requires at least: 3.8.0 Tested up to: 4.0.0 Stable tag: 1.4.2 Donate Link: http://salt.efs.nu License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html == Description == 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. == Installation == Installation of this plugin is fairly easy: 1. Download the plugin 1. Extract all the files. 1. Upload everything (keeping the directory structure) to the `/wp-content/plugins/` directory. 1. There should be a `/wp-content/plugins/salt_map` directory now with all files in it. 1. Activate the plugin through the 'Plugins' menu in WordPress. or 1. Install through wordpress.org 1. Activate the plugin through the 'Plugins' menu in WordPress. == Frequently Asked Questions == Non yet. == Screenshots == 1. A map with several locations, locations position too closely is grouped automatically. 1. Map showing location information inside map formated by template. 1. Map showing location information outside the map for mobile devices. 1. Search field with auto completion. 1. Global Map settings. 1. Global Map settings, showing how to add custom parameters for locations. 1. Location settings derived form the fields added under global settings. == Changelog == = 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. == Upgrade Notice == When upgrading to 1.4.0 hight has to be set without unit, it will be pixels. In 1.3.0 and later there exist the **instanceName** short code parameter it is required if wanting to have multiple maps on one page. When upgrading from pre 1.1.0 the search field has been made optional and default is not to show add the short code parameter **includeSerach=true** to get it back. If images in plugin folder has been replaced that will change back but form version 1.2.0 it is no longer needed to replace files in plugin folder, images from the media archive can be used for location icons. Replaced language files will be removed and has to be put back == Templating == The info window is formated according to a template that is set in the global settings it is based on [mustache.js](http://mustache.github.io/) 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](http://www.w3schools.com/googleAPI/google_maps_api_key.asp) 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