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. The first version was released in the end of 2008. As of November 2018 DOMA has been installed at 2 200 web servers, where 7 500 users have added 195 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.

Installation requirements

Roles

Download

Current version

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.

Upgrading

You are strongly encouraged to make a backup of all files before upgrading DOMA to a new version.

If you are upgrading from DOMA version 3.x to DOMA 3.y, just copy the new files to the web server, overwriting the old ones.

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

Compare the config.php file (your current configuration file) with the config_original.php file (the default configuration file for the new version) and add any newly introduced settings in config_original.php to config.php. DOMA will fallback to default behaviour if the newly introduced settings are not added to config.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 GitHub

The DOMA project is hosted at GitHub, 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

Sorry, but we do not have the time to provide help with issues related to configuration or debugging of DOMA installations. Use the digital orienteering map archive at your own risk.