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

= Synchronize Trac tickets to Remember the Milk task manager

== Description

A plugin that synchronizes Trac tickets and [http://www.rememberthemilk.com/ Remember the Milk] tasks.

Key features:
 * When a ticket is created, a RTM task also will be added.
 * When you close a ticket, the associated RTM task will be completed.

This hack is hosted externally.  I have also added the code here in case the external page goes away, but you may find a more up to date version at the external page.  See [http://blog.deadbeaf.org/2008/01/18/ticket2rtm-01-en/ Ticket2RTM] and [http://github.com/mootoh/ticket2rtm/tree/master github] for more info.  I'm just adding a stub here to point to the author's page.

== Bugs/Feature Requests

Existing bugs and feature requests for TicketToRtmPlugin are 
[report:9?COMPONENT=TicketToRtmPlugin here].

If you have any issues, create a 
[/newticket?component=TicketToRtmPlugin new ticket].

[[TicketQuery(component=TicketToRtmPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:tickettortmplugin here].

== Source

You can check out TicketToRtmPlugin from [/svn/tickettortmplugin here] using Subversion, or [source:tickettortmplugin browse the source] with Trac.

== Installation

=== Build

 1. edit Makefile and set PLUGINS_DIR to your Trac plugin dir
 1. make

or:

 1. python setup.py –bdist_egg
 1. copy dist/TracTicket2RTMPlugin*.egg into your Trac plugin dir

=== RTM API key, token

This plugin requires a RTM API key, shared secret and write-permitted token. You can obtain your API key and shared secret from [http://www.rememberthemilk.com/services/api/requestkey.rtm here].

After acquired key and shared secret, you can get your token by using bundled script. Run as follows:

{{{#!sh
$ python get_token.py <api key> <shared secret>
}}}

== Configuration

 1. Copy/paste contents of trac_ini_sample.txt to your `trac.ini` file.
 1. Set rtm_api_key, rtm_api_secret, rtm_api_token to the ones acquired above.

== Recent Changes

[[ChangeLog(tickettortmplugin, 3)]]

== Author/Contributors

'''Author:''' mootoh [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''