Revision as of 16:27, 12 January 2013

Introduction

This tutorial describes how to create maps using the WordPress Geo Mashup plugin. It is assumed that you are familiar with the basics of WordPress, and have already installed and activated the Geo Mashup plugin.

Creating a post

1. Go to the WordPress dashboard.
2. Go to Posts > Add New
3. Enter a title and body text

Add a location

While you are on the post edit page

1. Scroll the page to the Location section
2. Look for a world map
3. Drag the map (left click and hold while moving the mouse) to center it on your location
4. Zoom the map (use the + an - buttons on the left side of the map) to get close to your location
5. Click the map to add a green marker

Saving locations

To save a location, we need to name it. Look below the map, you should see:

• Address
• Saved Name
• Geo Date

1. Click the Saved Name field and give your location a name
2. Modify the date as needed.

Reusing saved locations

Add a Map in the Post body

To add a map in the post body, you simply need to add the following shortcode anywhere in the text where you would like your map to render.

 [geo_mashup_map]

Note: be sure that you have added a location to the post, otherwise a global map of all posts will appear.

Changing the location of a post

To change the location for a post:

1. Click to Edit the post
2. On the edit page, scroll down to Location
3. Click the map to select a new location
4. Update the post (under the Publish section)

Global maps

It is often desirable to display a global map of all locations. Global maps can appear in posts (when the post has no location, but contains the [geo_mashup_map] shortcode) and pages. Pages offer a bit more flexibility for global maps.

1. Go to the WordPress Dashboard
2. Click Pages > Add New
3. Add a title
4. In the page body, add the Geo Mashup shordcode

 [geo_mashup_map]

If you save and view the post, you will see all of your geolocations on a map.

Additionally, we can tell Geo Mashup that this is our Global Map page, so that it can perform special functions, such as creating category maps, using this page.

1. Go to the WordPress Dashboard
2. Go to Settings > Geo Mashup'
3. Look for the Global Mashup Page and set its value to your global map page
4. Click the Update Options button at the bottom of the page

Category maps

You can display a map of all georeferenced content from a category. To do this, first set up a global map page. Once you have a global map page

1. Go to the WordPress Dashboard
2. Go to Settings > Geo Mashup
3. Enable the Add Category Links option (click the checkbox)

Notice that it says "categories must have descriptions for this to work." Make sure that all of your categories have descriptions.

Add category descriptions

Here is how to add descriptions to your categories.

1. Go to the WordPress Dashboard
2. Go to Posts > Categories
3. Hover your mouse over a category and click Edit
4. Add a description, anything really
5. Repeat this for all categories that you want use on the map

Working with KMLs

It is sometimes desirable to add a KML file to a Geo Mashup Map.

Importing a KML

You can attach a KML file to any page or post. From the page/post edit screen:

1. Click the Add Media button
2. Either drag-and-drop or locate your KML file by clicking Select files

The KML will then upload. You can add a title and description to help keep things organized. Once you are done, close the upload dialog. You do not need to insert the KML into the post.

Deleting KML files from the library

Sometimes you need to delete a KML file, such as when you are replacing the KML associated with a post or page. To do this: