README.md

Level0 OpenStreetMap Editor

This is a text-based in-browser editor for OSM data. See its wiki page and language guide.

Installation

You will need PHP with mod_gettext.

1. Point your DocumentRoot to the www directory.

2. Run composer install.

3. Open this link and register your instance of Level0. It needs permissions for reading user details and modifying the map. When asked for a redirect URL set $your_installation/index.php?action=callback (the public instance uses https://level0.osmz.ru/index.php?action=callback)

4. Create www/config.php from www/config.php.sample, inserting both OAuth keys.

5. Create data directory and give writing permissions for it to web server process. Check path in config.php. Maybe you'll also need httpd_sys_rw_content SELinux tag.

You're set: download some data in the editor and login to OSM.

Oh, one more thing: the database would accumulate a lot of obsolete base files. To clean them, run crontab -e for a user that has write permissions to the database, and add this line (change path accordingly):

0 4 * * * sqlite3 /var/www/level0/data/level0.db "delete from base where created_at < datetime('now', '-1 day'); vacuum;"

Translation

Localization strings are managed with Transifex. There are not many of them, please add a translation for your language when you have time.

To update localizations in the code, configure Transifex CLI and do tx pull -a

Development

Run tests using phpunit --display-warnings test/

License and authors

Level0 is written by Ilya Zverev and published under WTFPL license.

Thank you to OpenCage for sponsoring work on Level0!