=== OS OpenSpace Maps ===
Contributors: jonlynch
Tags: maps, Ordnance Survey, OpenSpace
Requires at least: 3.0
Tested up to: 3.3.1
Stable tag: 1.1.1

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 content.

Currently the plugin displays one marker from an OS grid reference or a gpx file or a kml
file. Multiple markers will be possible in an upgrade very soon.

The following parameters can be passed:

* `height="xxx"` sets the height of the map div
* `width="xxx"` sets the width of the map div
* `color="red"` or `color="#ff0000"` sets the colour of the lines note the US spelling
* `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
* `grid="ab1234512345"` places a marker at ab1234512345 (only if there is no gpx file specified) this can be a 6, 8 or 10 figure grid reference but must include the two letters.
* `zoom="x"` sets the zoom level (unless a gpx file is displayed when the map auto zooms) try starting at 7 and have a play adjusting it to suit
* `label="text here"` sets the text for a popup for a marker

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 grid="NY2000008000" label="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.

== 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.

= Coming *very* soon: =
* Multiple markers
* Automatic zoom to fit for markers
* API key checking
* Better help

= Coming a little later: =
* Multiple kml and gpx files
* A Shortcode Generator


== Screenshots ==

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

== Changelog ==

= 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.1 =
* Bug Fix

= 1.0 =
* Fixes feed bug