====== GeoTag Plugin ======

---- plugin ----
description: Allow a user to annotate pages with a geotag
author     : Mark Prins
email      : mprins@users.sf.net
type       : syntax, action, helper
lastupdate : 2023-07-14
compatible : Greebo, Hogfather, Igor, Jack Jackrum
depends    : geophp
conflicts  : 
similar    : geourl, tag
tags       : tags, geo, meta, annotations, seo spatial

downloadurl: https://github.com/mprins/dokuwiki-plugin-geotag/archive/master.zip
bugtracker : https://github.com/mprins/dokuwiki-plugin-geotag/issues
sourcerepo : https://github.com/mprins/dokuwiki-plugin-geotag
donationurl: https://github.com/sponsors/mprins

screenshot_img: 
----

This plugin will render a geotag as a visible and styled [[http://microformats.org/wiki/geo|geo microformat]] and [[http://schema.org/geo|schema.org geo element]] as well as render it as [[http://geotags.com/geo/geotags2.html|meta tags]] and [[WP>ICBM_address|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 =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

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 [[https://dokuwikispatial.sourceforge.io/dokuwiki/doku.php?id=startt|on the demonstration site]] and [[https://wild-water.nl/dokuwiki/blog/2013/0827_nieuwe_wildwaterbaan_donau_insel_wenen|here]]. The [[https://dokuwikispatial.sourceforge.io/dokuwiki/doku.php?id=geotag:start|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 ([[WP>WGS84]]).
  * **lon** longitude, required. This must be in unprojected decimal degrees ([[WP>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 [[WP>ISO_3166-2]] code for this.
  * **country** the country, optional. Use the [[WP>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 [[http://www.geo-tag.de/generator/en.html|Geo Tag Generator website]] (at some point in time the plugin may provide this lookup functionality by itself)

==== Configuration and Settings ====

There are several configuration options:
  * **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 [[WP>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 ====

The [[https://github.com/mprins/dokuwiki-plugin-geotag/commits/master|complete changelog is available]] on GitHub


{{rss>https://github.com/mprins/dokuwiki-plugin-geotag/commits/master.atom date}}