Help Wiki - User contributions [en]

WordPress-GeoMashup

2013-01-15T07:32:14Z

Camrog11: /* Global maps */

{{TOC right}}
=Introduction=
Wordpress is remarkably capable at 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
# 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 need 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.

=Creating a post=
# Go to the WordPress dashboard
# Go to '''Posts''' > '''Add New'''
# Enter a title and body text

==Add a location==
While you are on the post edit page
# Scroll the page to the '''Location''' section
# Look for a world map
# Drag the map (left click and hold while moving the mouse) to center it on 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
[[File: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

# Click the '''Saved Name''' field and give your location a name
# 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.

[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=
To change the location for a post:
# Click to '''Edit''' the post
# On the edit page, scroll down to '''Location'''
# Click the map to select a new location
# '''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.

# Go to the WordPress Dashboard
# Click Pages > Add New
# Add a title
# 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.
# Go to the WordPress Dashboard
# Go to '''Settings'' > '''Geo Mashup''
# 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

=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.
[[File:mashupoptions_screenshot.png]]
==Add category descriptions==
Here is how to add descriptions to your categories.

# Go to the WordPress Dashboard
# Go to '''Posts''' > '''Categories'''
# Hover your mouse over a category and click '''Edit'''
# Add a description, anything really
# 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:
# Click the '''Add Media''' button
# 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.
[[File: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:
# Go to the WordPress Dashboard
# Go to '''Media''' > '''Library'''
# Locate the media, KML file in this case, that you want to delete
# Hover your mouse over the File and click '''Delete Permanently'''
# Click '''OK''' to accept the warning

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

[[Category: WordPress]][[Category:Tutorials]][[Category:Geospatial]][[Category:KML]]

WordPress-GeoMashup

2013-01-15T07:30:42Z

Camrog11: /* Creating a post */

{{TOC right}}
=Introduction=
Wordpress is remarkably capable at 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
# 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 need 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.

=Creating a post=
# Go to the WordPress dashboard
# Go to '''Posts''' > '''Add New'''
# Enter a title and body text

==Add a location==
While you are on the post edit page
# Scroll the page to the '''Location''' section
# Look for a world map
# Drag the map (left click and hold while moving the mouse) to center it on 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
[[File: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

# Click the '''Saved Name''' field and give your location a name
# 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.

[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=
To change the location for a post:
# Click to '''Edit''' the post
# On the edit page, scroll down to '''Location'''
# Click the map to select a new location
# '''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.

# Go to the WordPress Dashboard
# Click Pages > Add New
# Add a title
# 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.
# Go to the WordPress Dashboard
# Go to '''Settings'' > '''Geo Mashup'''
# 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

=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.
[[File:mashupoptions_screenshot.png]]
==Add category descriptions==
Here is how to add descriptions to your categories.

# Go to the WordPress Dashboard
# Go to '''Posts''' > '''Categories'''
# Hover your mouse over a category and click '''Edit'''
# Add a description, anything really
# 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:
# Click the '''Add Media''' button
# 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.
[[File: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:
# Go to the WordPress Dashboard
# Go to '''Media''' > '''Library'''
# Locate the media, KML file in this case, that you want to delete
# Hover your mouse over the File and click '''Delete Permanently'''
# Click '''OK''' to accept the warning

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

[[Category: WordPress]][[Category:Tutorials]][[Category:Geospatial]][[Category:KML]]

WordPress-GeoMashup

2013-01-15T07:30:14Z

Camrog11: /* WordPress Dashboard */

{{TOC right}}
=Introduction=
Wordpress is remarkably capable at 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
# 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 need 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.

=Creating a post=
# Go to the WordPress dashboard.
# Go to '''Posts''' > '''Add New'''
# Enter a title and body text

==Add a location==
While you are on the post edit page
# Scroll the page to the '''Location''' section
# Look for a world map
# Drag the map (left click and hold while moving the mouse) to center it on 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
[[File: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

# Click the '''Saved Name''' field and give your location a name
# 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.

[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=
To change the location for a post:
# Click to '''Edit''' the post
# On the edit page, scroll down to '''Location'''
# Click the map to select a new location
# '''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.

# Go to the WordPress Dashboard
# Click Pages > Add New
# Add a title
# 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.
# Go to the WordPress Dashboard
# Go to '''Settings'' > '''Geo Mashup'''
# 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

=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.
[[File:mashupoptions_screenshot.png]]
==Add category descriptions==
Here is how to add descriptions to your categories.

# Go to the WordPress Dashboard
# Go to '''Posts''' > '''Categories'''
# Hover your mouse over a category and click '''Edit'''
# Add a description, anything really
# 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:
# Click the '''Add Media''' button
# 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.
[[File: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:
# Go to the WordPress Dashboard
# Go to '''Media''' > '''Library'''
# Locate the media, KML file in this case, that you want to delete
# Hover your mouse over the File and click '''Delete Permanently'''
# Click '''OK''' to accept the warning

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

[[Category: WordPress]][[Category:Tutorials]][[Category:Geospatial]][[Category:KML]]

Creating KML Files

2013-01-15T07:28:10Z

Camrog11: /* Description */

{{TOC_right}}
=Introduction=
This tutorial covers the basics of creating KML files. We will be using Google Earth to create KML files containing points, lines, and polygons, the three basic geometries involved in vector-based GIS.

= Geometry types=
A quick description of the basic geometry of GIS will be helpful.

There are three primary geometric types in most GIS applications.
==Point==
A point is a single 'spot' in space. It has no dimension, i.e. no length, width, or height. Points are typically defined by a set of coordinates, also known as a coordinate tuple. Two examples of coordinate sets include:
* (X, Y)
** (Longitude, Latitude)
* (X, Y, Z)
** (Longitude, Latitude, Altitude)

'''Further reading:''' [http://en.wikipedia.org/wiki/Point_%28spatial%29 Wikipedia: Point]

==Line==
A line is built of points. A sequence of points will form a line, or linestring. For example:
* ((X, Y), (X, Y), (X, Y))

'''Further reading:''' [http://en.wikipedia.org/wiki/Line_%28mathematics%29 Wikipedia: Line]

==Polygon==
A polygon is similar to a line, except that its start and end points are the same. In effect, polygons are closed loops. Polygons form an area, and can have loops cut out of them.

'''Further reading:''' [http://en.wikipedia.org/wiki/Polygon Wikipedia: Polygon]

=Install Google Earth=
Skip this step if you already have Google Earth installed.

# Visit the [http://www.google.com/earth/ Google Earth website] to download the installer.
# Follow the install instructions particular to your Operating System.
# Launch Google Earth and proceed to the next section.

=Zoom to an Area=
Use the '''Navigation Controls''' or your mouse to zoom in to a location. If you are unfamiliar with navigation in Google Earth, take a moment to go through the [http://support.google.com/earth/bin/answer.py?hl=en&answer=176674 Navigation in Google Earth tutorial].

=Create map geometry=
A placemark is a point, line, or polygon that is used to indicate a specific, or general, location. We will look at the general procedure to create any type of placemark (point, line, or polygon).

==Type==
First, choose the type of placemark you would like to add.
* [[File:GoogleEarth-pushpin.png]] Placemark (Point)
* [[File:GoogleEarth-path_button.png]] Path (Line)
* [[File:GoogleEarth-polygon_button.png]] Polygon

If you choose a '''Placemark''' (Point), you simply click once on the map to add your mark.

If you choose a '''Path''' or '''Polygon''' you will click multiple times along the geometry you wish to add. Polygons are closed by default, while paths are open. With the path or polygon tools you can either
* click multiple times to define ''regular'' geometry, or
* click and drag to define ''free-form'' geometry.

===Example Usage===
* '''Points''' are good to indicate singular locations such as an address point, fire hydrant, or other small feature.
* '''Lines''' are useful to indicate roads, rivers, trails, etc..
* '''Polygons''' can be used for features such as building footprints, wildlife areas, bodies of water, etc..

==Geometry attributes==
Once you begin adding geometry (a point, or points in a line or polygon), a dialogue box will appear. This dialogue box has several sections, depending on the geometry type you are creating.

===Description===
The description tab contains a large text area where you add notes about the geometry. Your description can be any length, and can contain some HTML tags, including accompanying styles (CSS), such as:
* Styles
** Font
** Size
** Color
* Tables (Table tag <table>)
* Images (Image tag <img ...>)
* Hyperlinks (Anchor tag <a ...>)
[[File:descriptions_screenshot.png]]

===Style===
You can change the display style for the geometry on the '''Style''' tab. Style attributes vary depending on the geometry type and include
* Marker style
* Line color
* Line width
* Fill color

===Altitude===
The '''Altitude''' tab enables you to
* declare the geometry altitude in several ways
** absolute
** relative to ground
** relative to sea floor
* clamp your geometry to the Earth's surface
** ground
** sea floor

'''Further reading:''' [http://support.google.com/earth/bin/answer.py?hl=en&answer=148078 Google Earth: Setting altitude]

===Measurements===
Lines and polygons have inherent measurements. The measurement tab allows you to see literal measurement values.
====Line====
* Distance

====Polygon====
* Perimeter
* Area

=Exporting KML=
OK, we've made it! We are this close ( -> | | <- ) to having a KML file.
==Single Placemarker==
To export a single placemarker as a KML file
# Click on the desired place
# On the top menu, click '''File''' > '''Save''' > '''Save Place As...'''
# Choose a '''location''' on disk
# Check the '''Filename'''
# Under '''Save as type''' select '''KML'''
# Click '''Save'''

==Grouped Placemarkers==
===Create a folder===
# Select '''My Places''' by clicking on it in the places sidebar
# On the top menu, click '''Add''' > '''Folder'''
# Name your folder and click '''OK'''

===Drag and Drop Placemarkers===

# Drag one or more placemarker geometries into the folder
# Select your folder by clicking on it
[[File:places_screenshot.png]]
===Export Folder as KML===

# On the top menu, click '''File''' > '''Save''' > '''Save Place As...'''
# Choose a '''location''' on disk
# Check the '''Filename'''
# Under '''Save as type''' select '''KML'''
# Click '''Save'''

=References=
* [http://support.google.com/earth/bin/answer.py?hl=en&answer=148072 Google Earth: Drawing paths and polygons]
* [http://support.google.com/earth/bin/answer.py?hl=en&answer=148142 Google Earth: Creating a new place mark]
* [http://support.google.com/earth/bin/answer.py?hl=en&topic=2376990&ctx=topic&answer=148075 Google Earth: Writing Descriptions]

[[Category:Google Earth]][[Category:Geospatial]][[Category:GIS]][[Category:Tutorials]]

Creating KML Files

2013-01-15T07:27:50Z

Camrog11: /* Grouped Placemarkers */

{{TOC_right}}
=Introduction=
This tutorial covers the basics of creating KML files. We will be using Google Earth to create KML files containing points, lines, and polygons, the three basic geometries involved in vector-based GIS.

= Geometry types=
A quick description of the basic geometry of GIS will be helpful.

There are three primary geometric types in most GIS applications.
==Point==
A point is a single 'spot' in space. It has no dimension, i.e. no length, width, or height. Points are typically defined by a set of coordinates, also known as a coordinate tuple. Two examples of coordinate sets include:
* (X, Y)
** (Longitude, Latitude)
* (X, Y, Z)
** (Longitude, Latitude, Altitude)

'''Further reading:''' [http://en.wikipedia.org/wiki/Point_%28spatial%29 Wikipedia: Point]

==Line==
A line is built of points. A sequence of points will form a line, or linestring. For example:
* ((X, Y), (X, Y), (X, Y))

'''Further reading:''' [http://en.wikipedia.org/wiki/Line_%28mathematics%29 Wikipedia: Line]

==Polygon==
A polygon is similar to a line, except that its start and end points are the same. In effect, polygons are closed loops. Polygons form an area, and can have loops cut out of them.

'''Further reading:''' [http://en.wikipedia.org/wiki/Polygon Wikipedia: Polygon]

=Install Google Earth=
Skip this step if you already have Google Earth installed.

# Visit the [http://www.google.com/earth/ Google Earth website] to download the installer.
# Follow the install instructions particular to your Operating System.
# Launch Google Earth and proceed to the next section.

=Zoom to an Area=
Use the '''Navigation Controls''' or your mouse to zoom in to a location. If you are unfamiliar with navigation in Google Earth, take a moment to go through the [http://support.google.com/earth/bin/answer.py?hl=en&answer=176674 Navigation in Google Earth tutorial].

=Create map geometry=
A placemark is a point, line, or polygon that is used to indicate a specific, or general, location. We will look at the general procedure to create any type of placemark (point, line, or polygon).

==Type==
First, choose the type of placemark you would like to add.
* [[File:GoogleEarth-pushpin.png]] Placemark (Point)
* [[File:GoogleEarth-path_button.png]] Path (Line)
* [[File:GoogleEarth-polygon_button.png]] Polygon

If you choose a '''Placemark''' (Point), you simply click once on the map to add your mark.

If you choose a '''Path''' or '''Polygon''' you will click multiple times along the geometry you wish to add. Polygons are closed by default, while paths are open. With the path or polygon tools you can either
* click multiple times to define ''regular'' geometry, or
* click and drag to define ''free-form'' geometry.

===Example Usage===
* '''Points''' are good to indicate singular locations such as an address point, fire hydrant, or other small feature.
* '''Lines''' are useful to indicate roads, rivers, trails, etc..
* '''Polygons''' can be used for features such as building footprints, wildlife areas, bodies of water, etc..

==Geometry attributes==
Once you begin adding geometry (a point, or points in a line or polygon), a dialogue box will appear. This dialogue box has several sections, depending on the geometry type you are creating.

===Description===
The description tab contains a large text area where you add notes about the geometry. Your description can be any length, and can contain some HTML tags, including accompanying styles (CSS), such as
* Styles
** Font
** Size
** Color
* Tables (Table tag <table>)
* Images (Image tag <img ...>)
* Hyperlinks (Anchor tag <a ...>)
[[File:descriptions_screenshot.png]]

===Style===
You can change the display style for the geometry on the '''Style''' tab. Style attributes vary depending on the geometry type and include
* Marker style
* Line color
* Line width
* Fill color

===Altitude===
The '''Altitude''' tab enables you to
* declare the geometry altitude in several ways
** absolute
** relative to ground
** relative to sea floor
* clamp your geometry to the Earth's surface
** ground
** sea floor

'''Further reading:''' [http://support.google.com/earth/bin/answer.py?hl=en&answer=148078 Google Earth: Setting altitude]

===Measurements===
Lines and polygons have inherent measurements. The measurement tab allows you to see literal measurement values.
====Line====
* Distance

====Polygon====
* Perimeter
* Area

=Exporting KML=
OK, we've made it! We are this close ( -> | | <- ) to having a KML file.
==Single Placemarker==
To export a single placemarker as a KML file
# Click on the desired place
# On the top menu, click '''File''' > '''Save''' > '''Save Place As...'''
# Choose a '''location''' on disk
# Check the '''Filename'''
# Under '''Save as type''' select '''KML'''
# Click '''Save'''

==Grouped Placemarkers==
===Create a folder===
# Select '''My Places''' by clicking on it in the places sidebar
# On the top menu, click '''Add''' > '''Folder'''
# Name your folder and click '''OK'''

===Drag and Drop Placemarkers===

# Drag one or more placemarker geometries into the folder
# Select your folder by clicking on it
[[File:places_screenshot.png]]
===Export Folder as KML===

# On the top menu, click '''File''' > '''Save''' > '''Save Place As...'''
# Choose a '''location''' on disk
# Check the '''Filename'''
# Under '''Save as type''' select '''KML'''
# Click '''Save'''

=References=
* [http://support.google.com/earth/bin/answer.py?hl=en&answer=148072 Google Earth: Drawing paths and polygons]
* [http://support.google.com/earth/bin/answer.py?hl=en&answer=148142 Google Earth: Creating a new place mark]
* [http://support.google.com/earth/bin/answer.py?hl=en&topic=2376990&ctx=topic&answer=148075 Google Earth: Writing Descriptions]

[[Category:Google Earth]][[Category:Geospatial]][[Category:GIS]][[Category:Tutorials]]

Creating KML Files

2013-01-15T07:24:15Z

Camrog11: /* Description */

{{TOC_right}}
=Introduction=
This tutorial covers the basics of creating KML files. We will be using Google Earth to create KML files containing points, lines, and polygons, the three basic geometries involved in vector-based GIS.

= Geometry types=
A quick description of the basic geometry of GIS will be helpful.

There are three primary geometric types in most GIS applications.
==Point==
A point is a single 'spot' in space. It has no dimension, i.e. no length, width, or height. Points are typically defined by a set of coordinates, also known as a coordinate tuple. Two examples of coordinate sets include:
* (X, Y)
** (Longitude, Latitude)
* (X, Y, Z)
** (Longitude, Latitude, Altitude)

'''Further reading:''' [http://en.wikipedia.org/wiki/Point_%28spatial%29 Wikipedia: Point]

==Line==
A line is built of points. A sequence of points will form a line, or linestring. For example:
* ((X, Y), (X, Y), (X, Y))

'''Further reading:''' [http://en.wikipedia.org/wiki/Line_%28mathematics%29 Wikipedia: Line]

==Polygon==
A polygon is similar to a line, except that its start and end points are the same. In effect, polygons are closed loops. Polygons form an area, and can have loops cut out of them.

'''Further reading:''' [http://en.wikipedia.org/wiki/Polygon Wikipedia: Polygon]

=Install Google Earth=
Skip this step if you already have Google Earth installed.

# Visit the [http://www.google.com/earth/ Google Earth website] to download the installer.
# Follow the install instructions particular to your Operating System.
# Launch Google Earth and proceed to the next section.

=Zoom to an Area=
Use the '''Navigation Controls''' or your mouse to zoom in to a location. If you are unfamiliar with navigation in Google Earth, take a moment to go through the [http://support.google.com/earth/bin/answer.py?hl=en&answer=176674 Navigation in Google Earth tutorial].

=Create map geometry=
A placemark is a point, line, or polygon that is used to indicate a specific, or general, location. We will look at the general procedure to create any type of placemark (point, line, or polygon).

==Type==
First, choose the type of placemark you would like to add.
* [[File:GoogleEarth-pushpin.png]] Placemark (Point)
* [[File:GoogleEarth-path_button.png]] Path (Line)
* [[File:GoogleEarth-polygon_button.png]] Polygon

If you choose a '''Placemark''' (Point), you simply click once on the map to add your mark.

If you choose a '''Path''' or '''Polygon''' you will click multiple times along the geometry you wish to add. Polygons are closed by default, while paths are open. With the path or polygon tools you can either
* click multiple times to define ''regular'' geometry, or
* click and drag to define ''free-form'' geometry.

===Example Usage===
* '''Points''' are good to indicate singular locations such as an address point, fire hydrant, or other small feature.
* '''Lines''' are useful to indicate roads, rivers, trails, etc..
* '''Polygons''' can be used for features such as building footprints, wildlife areas, bodies of water, etc..

==Geometry attributes==
Once you begin adding geometry (a point, or points in a line or polygon), a dialogue box will appear. This dialogue box has several sections, depending on the geometry type you are creating.

===Description===
The description tab contains a large text area where you add notes about the geometry. Your description can be any length, and can contain some HTML tags, including accompanying styles (CSS), such as
* Styles
** Font
** Size
** Color
* Tables (Table tag <table>)
* Images (Image tag <img ...>)
* Hyperlinks (Anchor tag <a ...>)
[[File:descriptions_screenshot.png]]

===Style===
You can change the display style for the geometry on the '''Style''' tab. Style attributes vary depending on the geometry type and include
* Marker style
* Line color
* Line width
* Fill color

===Altitude===
The '''Altitude''' tab enables you to
* declare the geometry altitude in several ways
** absolute
** relative to ground
** relative to sea floor
* clamp your geometry to the Earth's surface
** ground
** sea floor

'''Further reading:''' [http://support.google.com/earth/bin/answer.py?hl=en&answer=148078 Google Earth: Setting altitude]

===Measurements===
Lines and polygons have inherent measurements. The measurement tab allows you to see literal measurement values.
====Line====
* Distance

====Polygon====
* Perimeter
* Area

=Exporting KML=
OK, we've made it! We are this close ( -> | | <- ) to having a KML file.
==Single Placemarker==
To export a single placemarker as a KML file
# Click on the desired place
# On the top menu, click '''File''' > '''Save''' > '''Save Place As...'''
# Choose a '''location''' on disk
# Check the '''Filename'''
# Under '''Save as type''' select '''KML'''
# Click '''Save'''

==Grouped Placemarkers==
===Create a folder===
# Select '''My Places''' by clicking on it in the places sidebar
# On the top menu, click '''Add''' > '''Folder'''
# Name your folder and click '''OK'''

===Drag and Drop Placemarkers===

# Drag one or more placemarker geometries into the folder
# Select your folder by clicking on it

===Export Folder as KML===

# On the top menu, click '''File''' > '''Save''' > '''Save Place As...'''
# Choose a '''location''' on disk
# Check the '''Filename'''
# Under '''Save as type''' select '''KML'''
# Click '''Save'''

=References=
* [http://support.google.com/earth/bin/answer.py?hl=en&answer=148072 Google Earth: Drawing paths and polygons]
* [http://support.google.com/earth/bin/answer.py?hl=en&answer=148142 Google Earth: Creating a new place mark]
* [http://support.google.com/earth/bin/answer.py?hl=en&topic=2376990&ctx=topic&answer=148075 Google Earth: Writing Descriptions]

[[Category:Google Earth]][[Category:Geospatial]][[Category:GIS]][[Category:Tutorials]]

WordPress-GeoMashup

2013-01-15T07:22:21Z

Camrog11: /* Importing a KML */

{{TOC right}}
=Introduction=
Wordpress is remarkably capable at 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
# 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 need 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.

=Creating a post=
# Go to the WordPress dashboard.
# Go to '''Posts''' > '''Add New'''
# Enter a title and body text

==Add a location==
While you are on the post edit page
# Scroll the page to the '''Location''' section
# Look for a world map
# Drag the map (left click and hold while moving the mouse) to center it on 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
[[File: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

# Click the '''Saved Name''' field and give your location a name
# 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.

[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=
To change the location for a post:
# Click to '''Edit''' the post
# On the edit page, scroll down to '''Location'''
# Click the map to select a new location
# '''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.

# Go to the WordPress Dashboard
# Click Pages > Add New
# Add a title
# 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.
# Go to the WordPress Dashboard
# Go to '''Settings'' > '''Geo Mashup'''
# 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

=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.
[[File:mashupoptions_screenshot.png]]
==Add category descriptions==
Here is how to add descriptions to your categories.

# Go to the WordPress Dashboard
# Go to '''Posts''' > '''Categories'''
# Hover your mouse over a category and click '''Edit'''
# Add a description, anything really
# 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:
# Click the '''Add Media''' button
# 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.
[[File: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:
# Go to the WordPress Dashboard
# Go to '''Media''' > '''Library'''
# Locate the media, KML file in this case, that you want to delete
# Hover your mouse over the File and click '''Delete Permanently'''
# Click '''OK''' to accept the warning

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

[[Category: WordPress]][[Category:Tutorials]][[Category:Geospatial]][[Category:KML]]

WordPress-GeoMashup

2013-01-15T07:20:38Z

Camrog11: /* Category maps */

{{TOC right}}
=Introduction=
Wordpress is remarkably capable at 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
# 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 need 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.

=Creating a post=
# Go to the WordPress dashboard.
# Go to '''Posts''' > '''Add New'''
# Enter a title and body text

==Add a location==
While you are on the post edit page
# Scroll the page to the '''Location''' section
# Look for a world map
# Drag the map (left click and hold while moving the mouse) to center it on 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
[[File: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

# Click the '''Saved Name''' field and give your location a name
# 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.

[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=
To change the location for a post:
# Click to '''Edit''' the post
# On the edit page, scroll down to '''Location'''
# Click the map to select a new location
# '''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.

# Go to the WordPress Dashboard
# Click Pages > Add New
# Add a title
# 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.
# Go to the WordPress Dashboard
# Go to '''Settings'' > '''Geo Mashup'''
# 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

=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.
[[File:mashupoptions_screenshot.png]]
==Add category descriptions==
Here is how to add descriptions to your categories.

# Go to the WordPress Dashboard
# Go to '''Posts''' > '''Categories'''
# Hover your mouse over a category and click '''Edit'''
# Add a description, anything really
# 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:
# Click the '''Add Media''' button
# 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:
# Go to the WordPress Dashboard
# Go to '''Media''' > '''Library'''
# Locate the media, KML file in this case, that you want to delete
# Hover your mouse over the File and click '''Delete Permanently'''
# Click '''OK''' to accept the warning

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

[[Category: WordPress]][[Category:Tutorials]][[Category:Geospatial]][[Category:KML]]

File:Mashupoptions screenshot.png

2013-01-15T07:19:53Z

Camrog11: uploaded a new version of "File:Mashupoptions screenshot.png"

WordPress-GeoMashup

2013-01-15T07:16:32Z

Camrog11: /* Add a location */

{{TOC right}}
=Introduction=
Wordpress is remarkably capable at 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
# 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 need 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.

=Creating a post=
# Go to the WordPress dashboard.
# Go to '''Posts''' > '''Add New'''
# Enter a title and body text

==Add a location==
While you are on the post edit page
# Scroll the page to the '''Location''' section
# Look for a world map
# Drag the map (left click and hold while moving the mouse) to center it on 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
[[File: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

# Click the '''Saved Name''' field and give your location a name
# 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.

[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=
To change the location for a post:
# Click to '''Edit''' the post
# On the edit page, scroll down to '''Location'''
# Click the map to select a new location
# '''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.

# Go to the WordPress Dashboard
# Click Pages > Add New
# Add a title
# 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.
# Go to the WordPress Dashboard
# Go to '''Settings'' > '''Geo Mashup'''
# 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

=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==
Here is how to add descriptions to your categories.

# Go to the WordPress Dashboard
# Go to '''Posts''' > '''Categories'''
# Hover your mouse over a category and click '''Edit'''
# Add a description, anything really
# 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:
# Click the '''Add Media''' button
# 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:
# Go to the WordPress Dashboard
# Go to '''Media''' > '''Library'''
# Locate the media, KML file in this case, that you want to delete
# Hover your mouse over the File and click '''Delete Permanently'''
# Click '''OK''' to accept the warning

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

[[Category: WordPress]][[Category:Tutorials]][[Category:Geospatial]][[Category:KML]]

File:Locations screenshot.png

2013-01-15T07:13:37Z

Camrog11:

File:Mashupoptions screenshot.png

2013-01-15T07:12:50Z

Camrog11:

File:Descriptions screenshot.png

2013-01-15T07:12:34Z

Camrog11:

File:Places screenshot.png

2013-01-15T07:12:18Z

Camrog11:

File:Upload screenshot.png

2013-01-15T07:11:49Z

Camrog11: