The Geo-Task-Tracker (GTT) plugin adds spatial capabilities to Redmine:
- Locate your issues as point, line or polygon
- Show and filter issues on a map
- Specify a project area
- Store the location of a user
- Extends Redmine API
- Geocoding
- and more
Redmine GTT plugins require PostgreSQL/PostGIS and will not work with SQLite or MariaDB/MySQL!!!
- Redmine >= 4.0.0
- PostgreSQL >= 9.6
- PostGIS >= 2.4
- NodeJS v14
- yarn
Create a PostGIS-enabled database:
createdb -U postgres -O redmine redmine
psql -U postgres -d redmine -c "CREATE EXTENSION postgis;"
To install Redmine GTT plugin, download or clone this repository in your Redmine installation plugins directory!
cd path/to/plugin/directory
git clone https://github.com/gtt-project/redmine_gtt.git
cd redmine_gtt
yarn
npx webpack
Then run
export GEM_PG_VERSION=your-pg-version # skip this line if redmine use pg 1.2.2.
export GEM_RGEO_ACTIVERECORD_VERSION=your-rgeo-activerecord-version # skip this line if using rgeo-activerecord 6.2.2.
export GEM_ACTIVERECORD_POSTGIS_ADAPTER_VERSION=your-activerecord-postgis-adapter-version # skip this line if using activerecord-postgis-adapter 5.2.3.
bundle install
bundle exec rake redmine:plugins:migrate
Before restarting Redmine, you need to set postgis adapter instead of postgres adapter in your config/database.yml.
After restarting Redmine, you should be able to see the Redmine GTT plugin in the Plugins page.
More information on installing (and uninstalling) Redmine plugins can be found here: http://www.redmine.org/wiki/redmine/Plugins
- Go to plugin configuration for global settings
- Configure at least one tile source
- Enable
GTTmodule in a project - Define the project boundary in
GTTproject settings - Create a new issue with a point, line or polygon
For more information with screenshots see the Getting Started guide.
The GTT Project appreciates any contributions! Feel free to contact us for reporting problems and support.
You can debug frontend by running the following command on another console:
npx webpack --watch --mode=development
You can run the plugin test on rails test environment by the following command:
bundle exec rake db:create
RAILS_ENV=test bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake redmine:plugins:migrate
RAILS_ENV=test NAME=redmine_gtt bundle exec rake redmine:plugins:test
See all releases with release notes.
This program is free software. See LICENSE for more information.