das-peter / redmine2mite Goto Github PK

mite is a sleek time tracking tool for teams and freelancers.

Redmine2mite connects your Redmine account with your mite.account. Track your time easily on issues within Redmine and get them automatically send to mite.

Projects from Redmine can be bundled with mite.projects. Furthermore, you can specify which mite.services should be available in Redmine on a per-project basis.

• Redmine >= 0.9
• Ruby on Rails >= 2.3
• a mite.account (you can easily signup for a free 30 days trial account )
• the Ruby Gem json (min. 1.6.5)

Please note: For Redmine versions prior to 0.9 use the plugin version 1.0.

The following commands are intended to be executed on the command line.

1. Change to plugins directory: $ cd /path/to/redmine/vendor/plugins
2. Clone source code from GitHub: $ git clone http://github.com/thomasklein/redmine2mite
3. Change to redmine root directory: $ cd /path/to/redmine/
4. Install the plugin schema by calling rake db:migrate_plugins
5. Restart your Redmine web server (e.g. Mongrel, Thin, WEBrick)
6. Voilá!

Login to Redmine. You should now see on the top right corner the link “mite”. Click on it.

After providing your account data you can now interconnect your mite.projects and mite.services with a specific Redmine project. The selected values will appear on top of the list, if you create a new time entry in the respective project.

Precondition is having Redmine projects assigned to your user, of course :-)

Once the connection to your mite.account was verified, sending your time entries to mite is very easy. The two fields mite.project and mite.service have been added to the time logging mask. When creating or updating a time entry the plugin sends those values to your mite.account.

Version 1.5 added the possibility to use the time tracker feature of mite directly in Redmine.

Your user role must have the permission to “Edit own time logs”.

First of all, you have to activate this feature in the Redmine2mite preferences (link “mite” on the top right corner) by checking the option “Activate tracker functionality, if time entries are booked without effort”. It is by default deactivated.

From now on, if you book leave the value for the amount of time empty or “0h0m” (as it is set automatically) and save a new time entry in Redmine, the tracker is started is Redmine and in mite simultaneously. You can see its status in the title bar of the current window and right beside the Redmine2mite preferences link.

Click on the orange timer right beside the Redmine2mite preferences link. It links to the list of time entries of the associated ticket. Beside the active time entry is a rotating clock. Click on it to stop the time tracker and save the current time both to Redmine and to mite.

Well, currently there is no easy way doing this.

• remove the directory redmine2mite out of the /vendor/plugins directory.
• manually delete all of the plugins database tables and newly added fields to existing tables
  • tables: mite_bindings, mite_rsrcs
  • added fields in table user_preferences: mite_account_name, mite_api_key, mite_note_pattern, mite_connection_updated_on, mite_tracker_option, mite_tracker_data
  • added fields in table time_entries: mite_time_entry_id, mite_project_id, mite_service_id, mite_time_entry_updated_on
• all entries “redmine_mite” in table schema_migrations

Redmine2mite is licensed under the terms of the MIT License, see the included MIT-LICENSE file.