這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

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.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈SALT Map〉的開發相關工作。

參與者

將〈SALT Map〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

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.