Difference between revisions of "WordPress-GeoMashup"

From Help Wiki
(→‎Deleting KML files from the library)
 
(31 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
{{TOC right}}
 
=Introduction=
 
=Introduction=
 +
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.
 
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
 +
# Look for your blog title on a black bar along the top of the page (this is the administrative toolbar).
 +
# Hover your mouse cursor over the blog title
 +
# 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
 +
# Go to the WordPress dashboard
 +
# Go to '''Plugins''' > '''Add New'''
 +
# Search for the plugin name or keywords: '''"Geo Mashup"''' in this case
 +
# Click the '''Details''' link below the title of the relevant plug-in
 +
# If the plug-in is compatible with your version of WordPress and you want to install it, click '''Install Now'''
 +
# 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
 +
# Go to the WordPress Dashboard
 +
# Go to '''Plugins''' > '''Installed Plugins'''
 +
# 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
 +
# Go to the WordPress Dashboard
 +
# Go to '''Settings''' > '''Geo Mashup'''
 +
# Enable the '''Add Category Links''' option (click the checkbox)
 +
[[File:mashupoptions_screenshot.png|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=
 
=Creating a post=
−
# Go to the WordPress dashboard.
+
# Go to the WordPress dashboard
 
# Go to '''Posts''' > '''Add New'''
 
# Go to '''Posts''' > '''Add New'''
 
# Enter a title and body text
 
# Enter a title and body text
Line 14: Line 61:
 
# Zoom the map (use the + an - buttons on the left side of the map) to get close to your location
 
# Zoom the map (use the + an - buttons on the left side of the map) to get close to your location
 
# Click the map to add a green marker
 
# Click the map to add a green marker
 +
[[File:locations_screenshot.png]]
  
 
==Saving locations==
 
==Saving locations==
Line 26: Line 74:
  
 
==Add a Map in the Post body==
 
==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.
+
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.
−
  [geo_mashup_map]
+
[geo_mashup_map]
  
 
'''Note:''' be sure that you have added a location to the post, otherwise a global map of all posts will appear.
 
'''Note:''' be sure that you have added a location to the post, otherwise a global map of all posts will appear.
 +
 +
[http://codex.wordpress.org/Shortcode More information on shortcodes] can be found on the [http://codex.wordpress.org/ WordPress codex].
  
 
=Changing the location of a post=
 
=Changing the location of a post=
Line 44: Line 94:
 
# Click Pages > Add New
 
# Click Pages > Add New
 
# Add a title
 
# Add a title
−
# In the page body, add the Geo Mashup shordcode
+
# In the page body, add the Geo Mashup shortcode
  
 
   [geo_mashup_map]
 
   [geo_mashup_map]
Line 50: Line 100:
 
If you save and view the post, you will see all of your geolocations on a 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.
+
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.
 
# Go to the WordPress Dashboard
 
# Go to the WordPress Dashboard
−
# Go to '''Settings'' > '''Geo Mashup'''
+
# Go to '''Settings'' > '''Geo Mashup''
 
# Look for the '''Global Mashup Page''' and set its value to your global map page
 
# Look for the '''Global Mashup Page''' and set its value to your global map page
 
# Click the '''Update Options''' button at the bottom of the page
 
# 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
 
−
# Go to the WordPress Dashboard
 
−
# Go to '''Settings''' > '''Geo Mashup'''
 
−
# 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==
 
==Add category descriptions==
Line 71: Line 113:
 
# Hover your mouse over a category and click '''Edit'''
 
# Hover your mouse over a category and click '''Edit'''
 
# Add a description, anything really
 
# Add a description, anything really
−
# Repeat this for all categories that you want use on the map
+
# Repeat this for all categories which you can use on the map
  
 
= Working with KMLs=
 
= Working with KMLs=
 
It is sometimes desirable to add a KML file to a Geo Mashup Map.
 
It is sometimes desirable to add a KML file to a Geo Mashup Map.
 +
==Configure Geo-Mashup for KMLs==
 +
#Go to '''Settings > Geo-Mashup'''
 +
#From the '''Map Provider''' drop-down choose Google v2 (this is required to display KML files v3 won't work
 +
#Enter your Google API key and hit update
 +
To allow Global Maps to show KML files
 +
#From the Geo-Mashups Settings go to the Global Maps tab
 +
# under Marker Selection Behavior select '''Show Geo Attachments'''
  
 
==Importing a KML==
 
==Importing a KML==
Line 82: Line 131:
  
 
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.
 
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.
 +
[[File:upload_screenshot.png]]
  
 
==Deleting KML files from the library==
 
==Deleting KML files from the library==
Line 92: Line 142:
  
 
You can now re-submit the KML file, or continue managing your media collection.
 
You can now re-submit the KML file, or continue managing your media collection.
 +
 +
[[Category: Wordpress]]

Latest revision as of 10:57, 18 July 2016

Introduction

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. 

[geo_mashup_map]

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
 [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

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.

Retrieved from "http://helpwiki.evergreen.edu/wiki/index.php?title=WordPress-GeoMashup&oldid=28969"

The Evergreen State College