=== OS OpenSpace Maps ===
Contributors: jonlynch
Tags: maps, Ordnance Survey, OpenSpace
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=SGTW6GCCWAD7G
Requires at least: 3.0
Tested up to: 3.3.1
Stable tag: 1.2

A plugin to display UK Ordnance Survey maps with markers and tracks.

== Description ==
A plugin to display UK Ordnance Survey [OpenSpace](http://openspace.ordnancesurvey.co.uk/openspace/) maps with markers and tracks.

This plugin works using the `[osmap]` shortcode anywhere in your post, page or custom post type content. It allows maps with markers and `gpx` or `kml` files to be shown. Examples are available at [ButNoIdea.co.uk](http://www.butnoidea.co.uk) and [my blog](http://jonlynch.co.uk/category/outdoor/walking/).

The following parameters can be passed:

* `height="xxx"` sets the height of the map div
* `width="xxx"` sets the width of the map div
* `colour="red"` or `colour="#ff0000"` (`color` is also acceptable) sets the colour of the track shown from a file.
* `gpx="http://www.example.com/myfile.gpx"` specifies a gpx file to be displayed
* `kml="http://www.example.com/myfile.kml"` specifies a kml file to be displayed
* `markers="NY1234512345;Marker 1|54.454198,-3.211527;Marker 2"` a list of positions and labels separated by `|` with a `;` between the position and label. Positions can be 6, 8 or 10 figure grid references or decimal lat long.

To upload a kml or gpx file just use the WordPress media uploader and then copy the address of the uploaded file into the shortcode.

= Examples =
* `[osmap height="300" width="300" color="yellow" gpx="http://www.example.co.uk/myfile.gpx"]` displays a 300px by 300px window containing a yellow track from the file specified.

* `[osmap markers="NY2000008000;Wasdale"]`shows a default size and zoom window with a marker placed and the popup text "Wasdale"

== Installation ==

1. Go to the Plugins page in the admin area, search for `openspace` navigate to the plugin page and click `install`.
1. Or download and extract `os-openspace-maps.zip` into the `/wp-content/plugins/` directory. This will create a subfolder called `os-openspace-maps` containing the plugin files.
1. Activate `OS OpenSpace Maps` through the 'Plugins' menu in WordPress
1. Before the plugin will work you need to add your API key to the settings page on the dashboard.
1. If you are running WordPress Multisite you (or your network administrator) will have to add KML and GPX files to the allowed file types under 'Network Settings'.

== Frequently Asked Questions ==

= Where can I get support? =

In the comments section at the [plugin page](http://www.jonlynch.co.uk/wordpress-plugins/os-openspace-maps/)

= Where is the rest of the FAQ? =

This will be extended in due course.

= Planned for the future =
* Multiple kml and gpx files
* A Shortcode Generator

== Screenshots ==

1. A map embedded in a WordPress post
2. The settings page

== Changelog ==

= 1.2 =
* Multiple markers with auto zoom
* API key checking
* New help tabs added to options and post editing screens
* Add multiple maps to post or pages
* Able to use lat long for markers

= 1.1.1 =
* Bug Fix

= 1.1 =
* Only adds one row to the options table
* Fixed feed bug

= 1.0 =
* Initial Release

== Upgrade Notice ==
= 1.2 =
* New Features
* More Help

= 1.1 =
* Bug Fix

= 1.0 =
* Fixes feed bug