About

This page contains information about how to download and install DOMA, a digital orienteering map archive, on your PHP+MySQL-equipped web server. The digital orienteering map archive helps you display your and your friends' orienteering maps and route choices on the web. Since the first version was released in the end of 2008, DOMA has been installed on over 700 web servers, where 2 000 users have added more than 40 000 maps. The software is developed by Mats Troeng and Michal Besta. To see it in use, take a look at OK Linné's digital orienteering map archive.

Screenshot 1: map list
Screenshot 2: overview map for all maps
Screenshot 3: show single map including overview map
Screenshot 4: Google Earth integration
Screenshot 5: edit map
Screenshot 6: edit user profile

Features

Terms of use

You may use and modify this software freely. However, to encourage further development we would be happy if you donate an amount of your choice.

Installation requirements

Roles

Download

Current version

If you are upgrading from DOMA version 2.x to DOMA 3.x, please read the upgrading instructions!

Older versions

Installation

It is possible to install multiple digital orienteering map archives on one single server, as long as each archive's installation folders and database tables are unique.

  1. Download the current installation package from the link under the Download header above. The installation package is a zip file containing all the necessary files.
  2. Use an FTP client to copy all the files and folders in the zip file to some folder (the root folder or another folder that you create) on the server.
  3. This instruction is not applicable when upgrading from a previous version! The config_original.php file contains various settings such as database and language settings. Make a copy of this file, rename the copy to config.php, edit config.php file in a text editor according to the instructions given, and save the changes to the server. IMPORTANT! Use UTF-8 text encoding without byte order mark (BOM) when saving. Note that some text editors (e.g. Notepad) by default add a BOM to the beginning of the file when saving in UTF-8. DOMA will not work if a BOM is present, so make sure to use a proper text editor. The free Notepad++ is an excellent choice.
  4. Open your web browser and navigate to http://www.yourdomain.com/yoursubfolder/index.php, where www.yourdomain.com and yoursubfolder are to be replaced with your actual settings.
  5. A message telling you that the site was successfully created is hopefully displayed. If there are error messages, make the necessary adjustments and try again.
  6. The digital orienteering map archive is now installed, and the start page is http://www.yourdomain.com/yoursubfolder/index.php.

Usage

Web service / QuickRoute integration

A web service interface makes it possible for other software to upload and edit maps in the digital orienteering map archive. The web service address is http://www.yourdomain.com/yoursubfolder/webservice.php.

The QuickRoute software, www.matstroeng.se/quickroute, uses this web service to provide integration with your digital orienteering map archive. Version 2.2 or higher of QuickRoute is required. Select Tools > Publish map in the QuickRoute menu, and provide the web service address together with your user name and password.

Customization

You may customize the site to suit your needs. This requires a bit of web design and/or programming skills (HTML, CSS, PHP, MySQL, Javascript, jQuery). Before modifying any of the files, it is highly recommended to make a backup.

Project home at Google Code

The DOMA project is hosted at Google Code, where also the latest source code can be found. Please drop an email to doma@matstroeng.se if you are interested in contributing to further development.

Support

No support whatsoever is provided. Use the digital orienteering map archive at your own risk.