Main Page
From Wikimap wiki
WikiMap-WP 2.1 has been released! download, try out (login with demo demo), view some screenshots or read about possible setups.
WARNING: If you are using WikiMap 2.1 with an old WordPress version (2.0.5 or lower), you need to edit the file 'wikimap.config.php'.
Contents |
GENERAL INFORMATION
WikiMap is a dynamic ('web 2.0') map that allows you to easily add locations to it. These locations show up on the map as markers. When you click a marker a little infowindow pops up. This infowindow can contain text, images, video, you name it.
WikiMap is based on Openlayers and WordPress.
Author: Robert Buzink.
UPGRADE
When you are upgrading from version 1.1, deactivate Wikimap 1.1 and the rc-custom-values plugins, delete the files of these plugins in the plugin directory and proceed to the INSTALLATION section.
INSTALLATION
1. Install WordPress 2.1, if you haven't already.
2. Copy the files contained in the WikiMap zip-file into your wordpress directory while retaining the folder structure.
3. Make the 'wp-content/plugins/wikimap/cache' directory writable by your webserver if it isn't already. (unix/linux: chmod 777 cache).
4. Go to your WordPress administration panel and activate the WikiMap plugin under 'Plugins'. Deactivate the GeoPress-plugin if it is active (full GeoPress fuctionality is included in WikiMap).
5. Go to your WordPress administration panel and set some options under 'Options/WikiMap'. You can set:
- The base layers that you want on your map (google, yahoo, etc.)
- The api-keys for these layers (you need google for the geocoder to work!)
- The latitude/longitude values for the initial center of the map display
- The latitude/longitude values for your blogs location.
- The initial zoom level for the map.
- The marker pictures for the overlays.
6. Go to your WordPress administration panel and activate the WikiMap fullscreen blog theme under 'Presentation/Themes' or place a map in a page by typing [wikimap=] in the content-area of the page.
There are several configurations possible, read more about them at possible setups
USAGE
After installation, point your browser to your wordpress blog. You should now see a fullscreen map.
Click somewhere on the map to add a location. A window pops up where (after logging in) you can fill in the title and the content of the location you want to add. You can also decide in which overlay the location should show up. Press 'Publish', 'Close window' and refesh the page. You should see your location on the map as a little red marker. Click on it to get the infowindow, click on it again to get rid of the infowindow.
Try using the WordPress 'more' tag in your location-posts. It will display a 'read more' link in the infowindow that leads your readers to the full page and enables them to add comments to it.
Click on the little blue cross at the right side of the map to hide/show layers and overlays.
OPTIONS
In the WordPress administration panel, under 'Options/WikiMap', you can configure some aspects of WikiMap.
In the WordPress administration panel, under 'Options/GeoCoder', you can configure some aspects of the geocodig map that appears in the write-page.
In the WordPress administration panel, under 'Manage/Wikimap', you can manage the special Map-layers and Map-objects you have created using the 'Write Map-layer' and 'Write Map-object' pages.
In the WordPress administration panel, under 'Manage/GeoCoder', you can manage the predefined locations you saved using the geocoder. These locations are not plotted on the map, unless they are attached to a post. They are just there to make reusing the same location for different posts easier.
In the WordPress administration panel, under 'Write/Map layer', you can add a special map-layer to your map. It can be a image-layer, a georss layer, a wms-layer, etc. Check out http://openlayers.org/doc/reference.html and look for functions that start with 'OpenLayers.Layer.'. The part after the dot is the layer-type.
In the WordPress administration panel, under 'Write/Map object', you can add a special object to your map. Currently only boxes are supported. Check out http://openlayers.org/doc/reference.html and look for a function called 'OpenLayers.Marker.Box' to get an idea of possible properties. The bounds are a set of two geographic points, seperated by a comma (41.1,30.5,42.9,32.2). The color is the border-color (blue). The width is the border-width (4).
LIMITATIONS
This is a beta version. I know everyone calls everything beta these days, but it really is! The highway themes are still partly in Spanish (don't ask me why) and not enough checks are build in the code. You can break the map by entering a non existing Latitude/Longitude, for example. Please report bugs at SourceForge.net.
DEVELOPERS
I'm looking for people who can rewrite some of the php-code to javascript to make WikiMap even more userfriendly and faster. Send me a mail if you want to help. I'm also looking for people who want to write new features in php.
CUSTOM THEMES
Put the wm_map(); tag outside the loop in your custom(ized) WordPress theme and the wm_head(); tag in the head. Create a div called map where you want the map to show up.
Example (theme-specific stuff left out):
<html>
<head>
<?php wm_head(); ?>
</head>
<body>
<div id="map"></div>
<?php wm_map(); ?>
</body>
</html>
