wp-gpx-maps/readme.txt

296 lines
10 KiB
Plaintext
Raw Normal View History

2012-02-15 16:04:18 +00:00
=== WP GPX Maps ===
2012-09-12 13:59:14 +00:00
2011-12-14 10:35:25 +00:00
Contributors: bastianonm
2012-03-17 11:46:00 +00:00
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=8VHWLRW6JBTML
2012-10-18 13:10:05 +00:00
Tags: maps, gpx, gps, graph, chart, google maps, track, garmin, image, nextgen-gallery, nextgen, exif, OpenStreetMap, OpenCycleMap, Hike&Bike, heart rate, heartrate, cadence
2011-12-14 10:35:25 +00:00
Requires at least: 2.0.0
Tested up to: 3.8
Stable tag: 1.2.5
2011-12-14 10:35:25 +00:00
2012-05-11 18:47:32 +00:00
Draws a gpx track with altitude graph. You can also display your nextgen gallery images in the map.
2011-12-14 10:35:25 +00:00
== Description ==
2012-03-05 07:57:36 +00:00
2012-02-15 16:25:40 +00:00
This plugin has, as input, the GPX file with the track you've made and as output it shows the map of the track and an interactive altitude graph (where available).
2011-12-20 15:37:26 +00:00
2012-06-21 13:29:17 +00:00
Fully configurable:
- Custom colors
- Custom icons
2012-06-21 14:45:12 +00:00
- Multiple language support
2012-03-05 07:57:36 +00:00
2012-07-02 12:51:45 +00:00
NextGen Gallery Integration:
Display your NextGen Gallery images inside the map!
Even if you don't have a gps camera, this plugin can retrive the image position starting from the image date and you gpx file.
2012-03-17 11:46:00 +00:00
2012-07-31 14:34:27 +00:00
Old NGGallery Images (without gps data) and gpx: <a href="http://www.pedemontanadelgrappa.it/mappe/itinerario-3-alta-via-degli-eroi/">http://www.pedemontanadelgrappa.it/mappe/itinerario-3-alta-via-degli-eroi/</a>
2011-12-20 15:37:26 +00:00
Translated into 14 languages:
2012-08-01 11:47:11 +00:00
- Catalan ca
- Dutch nl_NL
2012-07-31 14:34:27 +00:00
- English (default)
- French fr_FR
2012-07-31 14:34:27 +00:00
- German de_DE
- Hungarian hu_HU
- Italian it_IT
- Polish pl_PL
- Portuguese (Brazilian) pt_BR
- Russian ru_RU
2012-07-31 14:34:27 +00:00
- Spanish es_ES
- Swedish sv_SE
- Turkish tr_TR
- Bulgarian bg_BG
2012-08-01 11:47:11 +00:00
(many thanks to all guys who helped me with the translations)
2011-12-20 15:37:26 +00:00
2012-07-31 14:34:27 +00:00
- iphone/ipad/ipod Compatible
2011-12-20 15:37:26 +00:00
2012-07-31 14:34:27 +00:00
Try this plugin: <a href="http://www.pedemontanadelgrappa.it/category/mappe/">http://www.pedemontanadelgrappa.it/category/mappe/</a>
2012-03-01 06:53:31 +00:00
2012-08-06 09:54:48 +00:00
<a href="http://www.devfarm.it/forums/forum/wp-gpx-maps/">Support Forum</a>
2011-12-20 15:37:26 +00:00
2012-02-15 16:25:40 +00:00
Supported gpx namespaces are:
2011-12-20 15:37:26 +00:00
1. http://www.topografix.com/GPX/1/0
1. http://www.topografix.com/GPX/1/1
1. http://www.garmin.com/xmlschemas/GpxExtensions/v3
2011-12-14 10:35:25 +00:00
2012-04-07 09:11:37 +00:00
1. http://www.garmin.com/xmlschemas/TrackPointExtension/v1
2012-09-12 13:59:14 +00:00
Thanks to: <a href="http://www.securcube.net/">www.securcube.net</a>, <a href="http://www.devfarm.it/">www.devfarm.it</a>, <a href="http://www.pedemontanadelgrappa.it/">www.pedemontanadelgrappa.it</a>
Up to version 1.1.15 [Highcharts-API](http://www.highcharts.com/) is the only available rendering engine. Please respect their license and pricing (only Free for Non-Commercial usage).
2012-07-31 14:34:27 +00:00
2011-12-14 13:36:56 +00:00
== Installation ==
2011-12-20 15:37:26 +00:00
2011-12-14 10:35:25 +00:00
1. Use the classic wordpress plugin installer or copy the plugins folder to the `/wp-content/plugins/` directory
2011-12-20 15:37:26 +00:00
2011-12-14 10:35:25 +00:00
1. Activate the plugin through the 'Plugins' menu in WordPress
2011-12-20 15:37:26 +00:00
2012-01-24 17:05:59 +00:00
1. Add the shortcode [sgpx gpx="&gt;relative path to your gpx&lt;"] or [sgpx gpx="&gt;http://somesite.com/files/yourfile.gpx&lt;"]
2011-12-14 10:35:25 +00:00
== Frequently Asked Questions ==
2011-12-20 15:37:26 +00:00
2011-12-19 13:27:22 +00:00
= what are all available shortcode attributes? =
2011-12-20 15:37:26 +00:00
2011-12-19 13:27:22 +00:00
The attributes are:
2011-12-20 15:37:26 +00:00
2011-12-19 13:27:22 +00:00
1. gpx: relative path to gpx
2011-12-20 15:37:26 +00:00
2011-12-19 13:27:22 +00:00
1. width: width in pixels
2011-12-20 15:37:26 +00:00
2011-12-19 13:27:22 +00:00
1. mheight: map height
2011-12-20 15:37:26 +00:00
2011-12-19 13:27:22 +00:00
1. gheight: graph height
2011-12-20 15:37:26 +00:00
1. mtype: map available types are: HYBRID, ROADMAP, SATELLITE, TERRAIN, OSM1 (Open Street Map), OSM2 (Open Cycle Map), OSM3 (Hike & Bike), OSM4 (Open Cycle Map - Transport), OSM5 (Open Cycle Map - Landscape), OSM6 (MapToolKit - Terrain)
2011-12-20 15:37:26 +00:00
2011-12-24 14:37:05 +00:00
1. waypoints: print the gpx waypoints inside the map (default is FALSE)
2012-02-15 16:25:40 +00:00
1. donotreducegpx: print all the point without reduce it (default is FALSE)
2012-01-03 09:53:36 +00:00
2012-02-15 16:25:40 +00:00
1. pointsoffset: skip points closer than XX meters(default is 10)
2012-01-03 09:53:36 +00:00
1. uom: distance/altitude possible unit of measure are: 0, 1, 2, 3, 4 (0 = meters, 1 = feet/miles, 2 = meters/kilometers, 3 = meters/nautical miles, 4 = meters/miles)
2012-01-28 11:56:52 +00:00
1. mlinecolor: map line color (default is #3366cc)
2012-02-15 16:04:18 +00:00
1. glinecolor: altitude line color (default is #3366cc)
2012-01-28 11:56:52 +00:00
2012-02-15 16:04:18 +00:00
1. showspeed: show speed inside the chart (default is FALSE)
2012-04-07 09:11:37 +00:00
1. showhr: show heart rate inside the chart (default is FALSE)
1. showele: show elevation data inside the chart (default is TRUE)
2012-04-12 14:49:22 +00:00
1. showcad: show cadence inside the chart (default is FALSE)
1. showgrade: show grade inside the chart (default is FALSE)
2012-02-15 16:04:18 +00:00
1. glinecolorspeed: speed line color (default is #ff0000)
2012-04-12 14:49:22 +00:00
1. glinecolorhr: heart rate line color (default is #ff77bd)
1. glinecolorcad: cadence line color (default is #beecff)
2012-04-07 09:11:37 +00:00
1. glinecolorgrade: grade line color (default is #beecff)
1. uomspeed: unit of measure for speed are: 0, 1, 2, 3, 4, 5 (0 = m/s, 1 = km/h, 2 = miles/h, 3 = min/km, 4 = min/miles, 5 = Nautical Miles/Hour (Knots))
2011-12-14 10:35:25 +00:00
2012-03-05 07:57:36 +00:00
1. chartFrom1: minimun value for altitude chart
1. chartTo1: maxumin value for altitude chart
1. chartFrom2: minimun value for speed chart
1. chartTo2: maxumin value for speed chart
1. startIcon: Start track icon
1. endIcon: End track icon
1. currentIcon: Current position icon (when mouse hover)
2012-06-21 13:29:17 +00:00
1. waypointicon: waypoint custom icon
2012-03-17 11:46:00 +00:00
1. nggalleries: NextGen Gallery id or a list of Galleries id separated by a comma
1. ngimages: NextGen Image id or a list of Images id separated by a comma
2012-08-06 09:54:48 +00:00
1. dtoffset: the difference (in seconds) between your gpx tool date and your camera date
2012-06-11 15:24:58 +00:00
1. zoomonscrollwheel: zoom on map when mouse scroll wheel
2012-04-07 09:11:37 +00:00
2012-06-13 14:22:12 +00:00
1. download: Allow users to download your GPX file
2012-07-31 14:34:27 +00:00
1. skipcache: Do not use cache. If TRUE might be very slow (default is FALSE)
1. summary: Print summary details of your GPX (default is FALSE)
1. summarytotlen: Print Total distance in summary table (default is FALSE)
1. summarymaxele: Print Max Elevation in summary table (default is FALSE)
1. summaryminele: Print Min Elevation in summary table (default is FALSE)
1. summaryeleup: Print Total climbing in summary table (default is FALSE)
1. summaryeledown: Print Total descent in summary table (default is FALSE)
1. summaryavgspeed: Print Average Speed in summary table (default is FALSE)
1. summarytotaltime: Print Total time in summary table (default is FALSE)
2012-04-07 09:11:37 +00:00
2011-12-14 10:35:25 +00:00
= What happening if I've a very large gpx? =
2012-02-15 16:25:40 +00:00
This plugin will print a small amout of points to speedup javascript and pageload.
2011-12-20 15:37:26 +00:00
2011-12-14 12:08:18 +00:00
= Is it free? =
Yes!
2011-12-14 10:35:25 +00:00
== Screenshots ==
2011-12-24 14:37:05 +00:00
1. Simple Gpx
1. Gpx with waypoints
2012-05-30 09:14:42 +00:00
1. Admin area - List of tracks
1. Admin area - Settings
1. Altitude & Speed
1. Altitude & Speed & Hearth rate
2011-12-14 10:35:25 +00:00
== Changelog ==
= 1.2.5 =
* Added Catalan translation, thanks to Edgar
* Updated Spanish translation, thanks to Dani
* Added different types of distance: Normal, Flat (don't consider altitude) and Climb distance
= 1.2.4 =
* Added Bulgarian translation, thanks to Svilen Savov
* Added possibility to hide the elevation chart
= 1.2.2 =
* Smaller map type selector
* New map: MapToolKit - Terrain
* Fix: Google maps exception for NextGen Gallery
2013-10-20 13:42:35 +00:00
= 1.2.1 =
* Fix: NextGen Gallery 1.9 compatibility
= 1.2.0 =
* NextGen Gallery 2 support
* NextGen Gallery Pro support
= 1.1.46 =
* Added meters/miles chart unit of measure
* Added Russian translation, thanks to G.A.P
= 1.1.45 =
* Added nautical miles as distance (Many thanks to Anders)
= 1.1.44 =
* Added Chart zoom feature
* Some small bug fixes
= 1.1.43 =
* Added Portuguese (Brazilian) translation, thanks to Andr<64> Ramos
* new map: Open Cycle Map - Transport
* new map: Open Cycle Map - Landscape
2013-04-03 14:51:40 +00:00
= 1.1.42 =
* qTranslate compatible
= 1.1.41 =
* Added Polish translation, thanks to Sebastian
* Fix: Spanish translation
* Minor javascript improvement
= 1.1.40 =
* Improved italian translation
* Added grade chart (beta)
2012-12-21 13:46:55 +00:00
= 1.1.39 =
* Added French translation, thanks to Herv<72>
* Added Nautical Miles per Hour (Knots) unit of measure
2012-10-18 13:10:05 +00:00
= 1.1.38 =
* Fix: garmin gpx cadence and heart rate
* Updated Turkish translation, thanks to Edip
* Added Hungarian translation, thanks to Tami
2012-09-18 16:50:29 +00:00
= 1.1.36 =
* Even Editor and Author users can upload their own gpx. Administrators can see all the administrators gpx. The other users can see only their uploads
2012-09-12 13:59:14 +00:00
= 1.1.35 =
* Fix: In the post list, sometime, the maps was not displaying correctly ( the php rand() function was not working?? )
* Various improvements for multi track gpx. Thanks to GPSracks.tv
* Summary table is now avaiable even without chart. Thanks to David
2012-08-20 15:06:29 +00:00
= 1.1.34 =
* 2 decimals for unit of measure min/km and min/mi
* translation file updated (a couple of phrases added)
* File list reverse order (from the newer to the older)
* nggallery integration: division by zero fixed
2012-08-06 09:54:48 +00:00
= 1.1.33 =
* Decimals reducted to 1 for unit of measure min/km and min/mi
* map zoom and center position is working with waypoints only files
* automatic scale works again (thanks to MArkus)
2012-07-31 14:34:27 +00:00
= 1.1.32 =
* You can exclude cache (slower and not recommended)
* You can decide what show in the summary table
* German translation (thanks to Ali)
2012-07-06 15:40:38 +00:00
= 1.1.31 =
* Fixed fullscreen map image slideshow
2012-07-02 12:51:45 +00:00
= 1.1.30 =
2012-07-02 13:15:01 +00:00
* Multi track gpx support
* Next Gen Gallery images positions derived from date. You can adjust the date with the shortcode attribute dtoffset
2012-07-02 12:51:45 +00:00
* If you set Chart Height (shortcode gheight) = 0 means hide the graph
* Fix: All images should work, independent from browser cache
2012-06-27 13:48:34 +00:00
= 1.1.29 =
* Decimal separator is working with all the browsers
* minutes per mile and minutes per kilometer was wrong
2012-06-25 12:59:57 +00:00
= 1.1.28 =
* Decimal and thousand separator derived from browser language
* Added summary table (see settings): Total distance, Max elevation, Min elevation, Total climbing, Total descent, Average speed
* Added 2 speed units of measure: minutes per mile and minutes per kilometer
2012-06-21 13:29:17 +00:00
= 1.1.26 =
* Multilanguage implementation (only front-end). I've implemented the italian one, I hope somebody will help me with other languages..
* Map Full screen mode (I'm sure it's not working in ie6. don't even ask!)
* Added waypoint custom icon
2012-06-19 11:40:24 +00:00
= 1.1.25 =
* Added possibility to download your gpx
2012-06-11 19:43:04 +00:00
= 1.1.23 =
* Security fix, please update!
2012-06-11 15:24:58 +00:00
= 1.1.22 =
* enable map zoom on scroll wheel (check settings)
* test attributes in get params
2012-06-04 12:31:21 +00:00
= 1.1.21 =
* google maps images fixed (templates with bad css)
* upgrade to google maps 3.9
2012-05-30 09:14:42 +00:00
= 1.1.20 =
* google maps images fixed in <a href="http://wordpress.org/extend/themes/yoko">Yoko theme</a>
2012-05-11 18:47:32 +00:00
= 1.1.19 =
* include jQuery if needed
2012-04-23 08:06:21 +00:00
= 1.1.17 =
* Remove zero values from cadence and heart rate charts
* nextgen gallery improvement
2012-04-12 14:49:22 +00:00
= 1.1.16 =
* Cadence chart (where available)
* minor bug fixes
2012-04-07 09:11:37 +00:00
= 1.1.15 =
* migration from google chart to highcharts. Highcharts are much better than google chart! This is the base for a new serie of improvements. Stay in touch for the next releases!
* heart rate chart (where available)
2012-04-04 15:38:07 +00:00
= 1.1.14 =
* added css to avoid map bars display issue
2012-03-20 07:31:51 +00:00
= 1.1.13 =
* added new types of maps: Open Street Map, Open Cycle Map, Hike & Bike.
* fixed nextgen gallery caching problem
2012-03-18 10:44:11 +00:00
= 1.1.12 =
* nextgen gallery display bug fixes
2011-12-15 16:03:29 +00:00
2011-12-19 13:27:22 +00:00
== Upgrade Notice ==