About

This page contains information about how to download and install 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 software is developed by Mats Troeng. To see it in use, take a look at my personal digital orienteering map archive.

Features

• Support for multiple users on a single installation.
• The administrator can add and edit user profiles in a simple interface.
• Users can create user profiles by theirselves by entering a code provided by the administrator.
• Simple user interface for adding and editing maps and traning/competition information.
• Maps can be grouped in customizable categories, e. g. competition or training.
• Page listing all users and the latest added maps.
• Automatic generation of thumbnail images for the start page.
• A visitor can zoom in and out of a map.
• RSS feed.
• Integration with QuickRoute.
• Available in English, Swedish, Norwegian, Danish, Spanish, German, Czech, Hungarian, Estonian and Italian language versions by default, but all texts are customizable.
• Customizable web site design using style sheets.

Terms of use

You may use and modify this software freely.

Requirements

• Some computer knowledge.
• Web server with PHP 5 with the GD library, MySQL 5, and some hundred megabytes of disk space (if you plan to add a lot of maps). If you don't have a web server, I'd like to recommend One.com, www.one.com, that offers affordable web hosting starting from €1.25/month.
• Write access to the map_images folder for the server user account under which PHP runs.

Roles

• The administrator (probably you) installs DOMA on the web server, edits the configuration file and adds and edits users.
• The users (you and your friends) can add and edit maps using their favorite web browser. No programming skills are needed.

Download

Current version

• DOMA version 2.1.5 (July 16, 2010)
  • Added Italian translation.

Older versions

• DOMA version 2.1.4 (May 30, 2010)
• DOMA version 2.1.3 (January 24, 2010)
• DOMA version 2.1.2 (May 30, 2009)
• DOMA version 2.1.1 (May 12, 2009)
• DOMA version 2.1 (January 24, 2009)
• DOMA version 2.0 (January 11, 2009)
• DOMA version 1.0 (December 22, 2008)

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. The config.php file contains the database and appearance and language settings. Edit this file in a text editor (e.g., Notepad), and save the changes to the server.
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

• Follow the Administrator log in link at the top of the page to log in using your admin user name and password as entered in the config.php file. You are now able to add and edit users.
• As a logged-in administrator, create a new user by clicking the Create new user link at the top of the page, and fill out the form.
• To log in as a user, go to the user start page and click the Log in link at the top of the page. To add a new map, click the Add map link and enter the requested information.
• To edit or delete an existing map, click the Edit link next to the map.

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 administration user name and password as entered in the config.php file.

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). Before modifying any of the files, it is highly recommended to make a backup.

Support

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