| | 1 | = Trac2mite = |
| | 2 | |
| | 3 | [[PageOutline]] |
| | 4 | |
| | 5 | == Description == |
| | 6 | Trac2mite connects your Trac account with your ''mite''.account. Track your time easily on issues within Trac and get them automatically send to ''mite''. |
| | 7 | |
| | 8 | == Requirements == |
| | 9 | * [http://trac.edgewall.org/wiki/TracDownload Trac] >= v0.11 |
| | 10 | * [http://trac-hacks.org/wiki/TracHoursPlugin TracHoursPlugin] >= r7148 |
| | 11 | * a mite.account (you can easily signup for a [https://signup.mite.yo.lk/signup/en free 30 days trial account]) |
| | 12 | |
| | 13 | == Installation == |
| | 14 | '''Please note:''' Currently there’s 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. |
| | 15 | |
| | 16 | 1. Make sure the TracHoursPlugin is installed and enabled. |
| | 17 | 2. Place all source files of the Trac2mite plugin into the plugin directory of your Trac environment. |
| | 18 | 3. Change to `/path/to/your/projenv/plugins/Trac2mite/0.11` via console and run the command |
| | 19 | {{{ |
| | 20 | python setup.py develop -md /path/to/your/projenv/plugins |
| | 21 | }}} |
| | 22 | 4. 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. |
| | 23 | 5 You are prompted to upgrade your Trac environment via the trac-admin tool. Do so and restart your webserver. |
| | 24 | |
| | 25 | == Setup == |
| | 26 | '''Please 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. |
| | 27 | |
| | 28 | Go to `Preferences > mite` and try to connect to your ''mite''.account. |
| | 29 | |
| | 30 | After providing your account data you can now select your ''mite''.projects and ''mite''.services that will appear when you create a new time entry with the TracHoursPlugin. |
| | 31 | |
| | 32 | == Tracking time == |
| | 33 | Once the connection to your ''mite''.account is verified, you should now 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. |
| | 34 | |
| | 35 | == Download and reporting bugs == |
| | 36 | The plugin is hosted on Github: http://github.com/thomasklein/Trac2mite |
| | 37 | |
| | 38 | 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]. |
| | 39 | |
| | 40 | == Author == |
| | 41 | [thomas.klein83@gmail.com thomasklein] |
| | 42 | |
| | 43 | == License == |
| | 44 | Trac2mite is licensed under the terms of the MIT License, see the included MIT-LICENSE file. |
