It's better when it's simple

User Tools

Site Tools


geonav Plugin

Compatible with DokuWiki


plugin Geographic wiki page navigation

Last updated on
Syntax, Action

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

Tagged with experimental, geo, maps, navigation


This plugin provides a way to navigate a section of your wiki based on geography. The designated pages would use a sidebar Google Earth map to drill down to a geographic area. Users can create or edit pages along the way. I see it as being used to document topics at various geographic levels.


:!: External requirements: This plugin uses

  • Google Earth Plugin - this needs to be installed on the user's computer. Accessing the wiki page that uses it should ask the user to install it if it is not already installed. Google Earth can be found at Google Earth
  • A supplied SQLite database in the /db folder

:!: * A modified version of the template:starter: also included. If you are using a template called starter then either manually install geonav or backup your starter template.

  1. Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
  2. Copy the supplied startermap template to your templates folder.
  3. Create a sidebar page containing <geonav></geonav>
  4. In the Admin Configuration page set
    • template → startermap
    • sidebar page name → sidebar


To use the plugin create any page on any topic followed by :earth such as topic:earth. Go to that a page and use the map to focus down to lower geographic regions.

:!: The page actually remains at the top level page. So selecting the Edit this page button goes to the top level page. A Go to Edit button is provided to go to and either create or edit the page you are viewing.

See the plugin in action FIXME. From the sitemap select Hunger:earth.


The following syntax is placed in the sidebar page for the map.


Configuration and Settings

The plugin comes with a modified starter template. If you diff the two templates you can see the minor changes that were made to work better with this plugin. Then you should be able to make similar changes to your desired template. The changes were:

  1. Key off the :earth in the page name to not use the sidebar if not present. This is the major change.
  2. Widen the sidebar to enlarge the map.
  3. Lessen the content width to compensate the wider sidebar

:!: The plugin displays the viewed page content within the


div in main.php of the template. If you use a different <div id=…> for your content you need to modify the code in /js/getLocations.js to replace all occurrences of it with your content div id name.


:!: The code uses Http GET requests to communicate between the client and the server when drilling down to exchange the location level and the associated page content.

Change Log

Known Bugs and Issues

  1. Some issues with plugins working on sub-pages.
  2. Sometimes the Google Earth is slow to load.

ToDo/Wish List

I have nothing planed at this time.




plugin/geonav.txt · Last modified: 2018-05-31 00:28 by Klap-in

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