DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:geonav

geonav Plugin

Compatible with DokuWiki

Binky

plugin Geographic wiki page navigation

Last updated on
2013-11-24
Provides
Syntax, 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.

Tagged with experimental, geo, maps, navigation

Description

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.

Installation

:!: 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. Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. 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

Examples/Usage

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 Clean.GlocalFocal.com FIXME. From the sitemap select Hunger:earth.

Syntax

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

~~NOCACHE~~
<geonav></geonav>

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

dokuwiki__content

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.

Development

:!: 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.

FAQ

None

Discussion

plugin/geonav.txt · Last modified: 2014-05-23 16:52 by 77.222.112.130