From Help Wiki


WordPress is remarkably capable in allowing a person to create a blog and present information on the web. When tied to the Geo-Mashup feature, it allows the blogger to attach geographic information to your blog posts.

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.

WordPress Dashboard

During this tutorial, you will be visiting the Dashboard often. To get to the WordPress Dashboard, you will need to be logged in.

  • Click the "Log-in" button on your theme.
  • If there is no log in button, type 'wp-admin' in the address bar: e.g. http://blog.com/wp-admin

Once you are logged in, you will be presented with the WordPress Dashboard. As you navigate your blog, you will sometimes leave the Dashboard. You can return to the Dashboard

  1. Look for your blog title on a black bar along the top of the page (this is the administrative toolbar).
  2. Hover your mouse cursor over the blog title
  3. Click "Dashboard" in the drop down menu

You can alternate between the Dashboard and blog view by clicking the blog title in the administrative toolbar.

Install Geo Mashup

Note: Geo Mashup may already be installed on your course blog.

To install plugins in self-hosted WordPress blogs

  1. Go to the WordPress dashboard
  2. Go to Plugins > Add New
  3. Search for the plugin name or keywords: "Geo Mashup" in this case
  4. Click the Details link below the title of the relevant plug-in
  5. If the plug-in is compatible with your version of WordPress and you want to install it, click Install Now
  6. Click Activate once the plug-in has been installed.

You may must configure your plug-in, which varies and is beyond the scope of this tutorial.

Activating Geo Mashup

Note: Geo Mashup may already be activated on your course blog.

On WordPress sites that are hosted by organizations, such as Evergreen College, users can usually only activate pre-selected plug-ins. This is generally for security, stability, and sanity of the system administrators.

To activate an installed plugin

  1. Go to the WordPress Dashboard
  2. Go to Plugins > Installed Plugins
  3. Click the Activate link under the plugin title. Geo Mashup in this case.

If you absolutely need a plug-in that is not available in a hosted account, such as the blogs.evergreen.edu portal, you may want to consider hosting your own blog.

Configure Geo Mashup

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)

Geo Mashup options

Note: Geo Mashup states that "categories must have descriptions for this to work." Make sure that all of your categories have descriptions.

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

Locations screenshot.png

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 type (or copy/paste) the following shortcode anywhere in the text where you would like your map to render.


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

More information on shortcodes can be found on the WordPress codex.

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 shortcode

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

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 which you can use on the map

Working with KMLs

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

Configure Geo-Mashup for KMLs

  1. Go to Settings > Geo-Mashup
  2. From the Map Provider drop-down choose Google v2 (this is required to display KML files v3 won't work
  3. Enter your Google API key and hit update

To allow Global Maps to show KML files

  1. From the Geo-Mashups Settings go to the Global Maps tab
  2. under Marker Selection Behavior select Show Geo Attachments

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. Upload screenshot.png

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:

  1. Go to the WordPress Dashboard
  2. Go to Media > Library
  3. Locate the media, KML file in this case, that you want to delete
  4. Hover your mouse over the File and click Delete Permanently
  5. Click OK to accept the warning

You can now re-submit the KML file, or continue managing your media collection.