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 microformat 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.
Examples/Usage
See the plugin in action here 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.
Change Log
- Mark committed [r774] (2021-04-21 14:45)
- Mark committed [r773] (2021-04-16 16:52)
- Mark committed [r772] (2021-04-16 16:51)
- Mark committed [r771] (2021-04-16 16:49)
- Spatial plugins for Dokuwiki updated /openlayersmap/openlayersmap.tar.gz (2020-09-12 01:25)
- Spatial plugins for Dokuwiki updated /openlayersmap/openlayersmap.zip (2020-09-12 01:25)
- Spatial plugins for Dokuwiki released /openlayersmap/openlayersmap-4.15.zip (2020-09-12 01:25)
Known Bugs and Issues
Please see the bug tracker and the support requests
ToDo/Wish List
Please see the feature requests tracker