Table of Contents
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.
- Copy the supplied
startermaptemplate to your templates folder.
- Create a sidebar page containing
- 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 Clean.GlocalFocal.com . 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:
- Key off the :earth in the page name to not use the sidebar if not present. This is the major change.
- Widen the sidebar to enlarge the map.
- 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.
Known Bugs and Issues
- Some issues with plugins working on sub-pages.
- Sometimes the Google Earth is slow to load.
I have nothing planed at this time.