DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:geotag

This is an old revision of the document!


GeoTag Plugin

Compatible with DokuWiki

Rincewind, Angua, Adora Belle, Weatherwax, Binky, "Ponder Stibbons", Hrun, Detritus, 2016-06-26, 2017-02-19

plugin Allow a user to annotate pages with a geotag

Last updated on
2018-01-22
Provides
Syntax, Helper, Action
Repository
Source

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Similar to geourl, tag

Tagged with annotations, geo, meta, seo, spatial, tags

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 (deprecated/ads).

Installation

Search and install the plugin using the Extension Manager or manually with the download from the SourceForge Mirror. 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.11

  • Russian translation provided by Козлов Алексей (Aleksej Kozlov)
  • fix parsing of Cyrillic names (thanks Aleksej)

version 1.10

  • PHP 7 fixes

version 1.9

  • allow unicode characters with umlaut in placenames

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

Known Bugs and Issues

Please see the support requests

ToDo/Wish List

Please see the feature requests tracker

plugin/geotag.1516617775.txt.gz · Last modified: 2018-01-22 11:42 by mprins

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki