[[PageOutline(2-5,Contents,pullout)]]

= Track time using the mite web service

== Description

This plugin connects Trac with [http://mite.yo.lk/en mite], a web-based time tracking tool. Track your time easily on issues within Trac and get them automatically sent to your mite.account. The time entries are sent via https to the central mite server, where they are then stored.

== Bugs / Feature requests

If you encounter any bugs or problems, I would appreciate it if you let me know through the [http://github.com/thomasklein/Trac2mite/issues issue system on Github].

== Download

The plugin is hosted on Github: http://github.com/thomasklein/Trac2mite.

== Installation

This plugin requires the following:
 * [trac:TracDownload Trac] >= v0.11
 * TracHoursPlugin >= r7148
 * a ''mite''.account; you can signup for a [https://signup.mite.yo.lk/signup/en free 30 days trial account]

'''Note:''' Currently there is a problem when installing the plugin the normal way. Until this issue is resolved you have to install the plugin in development mode as described in the steps below.

 1. Make sure the TracHoursPlugin is installed and enabled.
 1. Place all source files of the Trac2mite plugin into the plugin directory of your Trac environment.
 1. Change to `/path/to/your/projenv/plugins/Trac2mite/0.11` via console and run the command:
 {{{#!sh
python setup.py develop -md /path/to/your/projenv/plugins
}}}
 1. Login as a user with admin privileges and go to `Admin > Plugins` to enable all components for 'trac2mite', which should now be listed as a available plugin.
 1. You are prompted to upgrade your Trac environment via the trac-admin tool. Do so and restart your webserver.

== Configuration

'''Note:''' Only users with the permission `TICKET_ADD_HOURS` can use the features of the TracHoursPlugin and Trac2mite. The following steps assume you have this permission.

Go to `Preferences > mite` and connect to your ''mite''.account. After providing your account credentials you can then start to select your ''mite''.projects and ''mite''.services that will appear when you create a new time entry with the TracHoursPlugin.

== Tracking time

Once the connection to your ''mite''.account is verified, you should have the possibility to assign one of your ''mite''.projects and ''mite''.services to every new and existing time entry. When saving the time entry, Trac2mite will send this data to your ''mite''.account.

== Author

[mailto:thomas.klein83@gmail.com thomasklein]