Extension:SnAmmap
 Release status: beta |
|||
|---|---|---|---|
| Implementation | Tag | ||
| Description | Integrate amMap (a flash-based interactive map) with your wiki! | ||
| Author(s) | SurfNext.com (surfnextTalk) | ||
| Last version | 0.5 (including amMap 2.5.7) (22.09.2011) | ||
| MediaWiki | 1.17 | ||
| License | MIT (snAmmap) & Linkware (amMap itself) | ||
| Download | snAmmap | ||
| Example | SurfNext | ||
|
|||
|
Check usage (experimental) |
|||
Contents |
[edit] What can this extension do?
It adds a tag, <ammap>, to your Wiki, with which you can embed one amMap per page, currently.
amMap is a Flash-based map offering many configuration and customisation possibilities. It's great to display data on maps, allow users to select a country and drill down, and many other possibilities. It zooms smoothly, unlike most tile-based maps.
It is available in a free version (which is included with snAmmap), in which you have to keep a link back to their homepage, and a paid version which drops the link.
[edit] Usage
[edit] Download instructions
Download the newest version of the extension from this page, extract the contents to your $IP/extensions/ folder. It should now contain a snAmmap folder. Note: $IP stands for the root directory of your MediaWiki installation, the same directory that holds LocalSettings.php.
[edit] Installation
To install this extension, add the following to LocalSettings.php:
require_once("$IP/extensions/snAmmap/snAmmap.php");
[edit] Configuration parameters
[edit] User rights
[edit] Tag usage
After you have installed the extension, use the following tag in your Wiki where you want to include the map: (only one map per page is supported currently!)
<ammap height=”500px” width=”500px” bgcolor=”#FFFFFF” data_file=”/custom/data.xml” settings_file=”/custom/settings.xml”>Placeholder text</ammap>
None of the tag’s attributes are required, there are sensible defaults for them (falling back on the data_file and settings_file provided with amMap, for instance.)
- height => sets the height of the map. Can be a percentage
- width => sets the width. Can also be a percentage.
- bgcolor => sets the initial background color, which can be modified in the settings file later.
- data_file => sets the path (URL!) for the data_file. Can be a full URL with hostname, but you have to enable cross-site scripting, which is dangerous. Use a file from your server, preferably.
- settings_file => sets the path for the settings_file
See the documentation of amMap for more details and information what you can modify.
If JavaScript and/or Flash are turned off, the placeholder text is displayed instead. (On some mobile browsers we tested, for instance).
