This is an old revision of the document!
Table of Contents
geotag Plugin
Compatible with DokuWiki
2010-11-07 "Anteater", Rincewind, Angua, Adora Belle, Weatherwax, Binky, "Ponder Stibbons"
This plugin will render a geotag as a visible and styled geo microformat and schema.org geo element as well as render it as meta tags and ICBM in the page header. The rendering of the microformat may be suppressed by the wiki admin. A comprehensive summary on geotagging is given on http://www.geotagicons.com.
Installation
Install the plugin using the Plugin Manager and the download URL1) above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually. Alternate locations and archives for the plugin as well as older versions are available at: http://sourceforge.net/projects/dokuwikispatial/files/geotag/
It's not required, but having the geophp will enable calulation, storage and tagging of geohashes, having the spatialhelper plugin will enable searching for nearby pages.
Examples/Usage
See the plugin in action on the demonstration site and here. The sample pages show all the styles available with the plugin.
Syntax
Minimal syntax:
{{geotag>lat:51.565696, lon:5.324596}}
Full syntax:
{{geotag>lat=52.132633, lon=5.291266, alt=9, placename:Sint-Oedenrode, region:NL-NB, country:NL, hide}}
- lat latitude, required. This must be in unprojected decimal degrees (WGS84).
- lon longitude, required. This must be in unprojected decimal degrees (WGS84).
- alt altitude, optional. This must be in meter above (or below) mean sealevel.
- placename the placename, optional. A descriptive placename, eg. the name of a town or landmark.
- region the region, optional. Use the ISO_3166-2 code for this.
- country the country, optional. Use the ISO_3166-1_alpha-2 code for this.
- hide|unhide use to override the
geotag_hide
configuration property, optional ( does not take a value)
The lat
and lon
elements are mandatory, the other elements are optional and may be omitted. Elements must be separated by a comma (,
) either a colon (:
) or an equals sign (=
) may be used to separate the values (lat:21.2
is the same as lat=21.2
). Since the comma is used as a delimiter you cannot use it in the text (the placename would be the only one where that makes sense anyway).
If you need to look up the values for a tag you can use the Geo Tag Generator website (at some point in time the plugin will provide this lookup functionality by itself)
Configuration and Settings
There are two configuration options:
- geotag_pinggeourl pings the geourl.org website with the page url for indexing
- geotag_location_prefix the default text to show in front of as part of a geotag, ie. the
placename
value; - geotag_showlocation shows the
placename
value as part of the microformat, note that if you use a comma this string will be truncated at the comma - geotag_hide when checked geotags will be hidden from view using css (they are still rendered)
- geotag_prevent_microformat_render when this option is checked rendering of the geotag microformat is prevented (the meta tags are still added to the page), this is for certain a11y scenario's.
- geotag_showsearch make the geotag a link to the
findnearby
action provided by the spatialhelper - toolbar_icon whether to show a button in the editing toolbar
- displayformat the format for display of the coordinates, either decimal degrees (DD) or degrees, Minutes, Seconds (DMS)
Changes
version 1.8
- use microformats2
h-geo
classes - settings/translations update
- fix a bug of a non-closed span
version 1.7
- render schema.org microformats
- link geotag to findnearby if the spatialhelper plugin is available
- add an option to toggle display between DD and DMS format
sourcecode updates
- relocate moved subprojects (2021-04-21 14:45)
- geophp moved to github (2021-04-16 16:52)
- geophp moved to github (2021-04-16 16:51)
- geophp moved to github (2021-04-16 16:49)
- [maven-release-plugin] prepare for next development iteration (2020-09-12 00:48)
- [maven-release-plugin] copy for tag openlayersmap-4.15 (2020-09-12 00:48)
- [maven-release-plugin] prepare release openlayersmap-4.15 (2020-09-12 00:48)
- revert closure compiler update (2020-09-12 00:42)
- base64 encode inline scripts so they can be deferred (2020-09-11 23:50)
- Update pom files (2020-09-11 23:43)
Known Bugs and Issues
Please see the support requests
ToDo/Wish List
Please see the feature requests tracker