= DragonTalk userobservation for Thunderbird =

This extension observes the user actions in the Thunderbird mail client, like mail selection, mail movement, creation or deletion of a folder etc. (for als events see the list below). If the user does one of the observed actions, the extension will send a XML-RPC.
To protect the privacy of the user, it is possible to deactivate the sending of the XML-RPC in the settings dialog .


== About the XML-RPC ==

For general information about XML-RPC look at [http://www.xmlrpc.com/]

The <methodName> consists of two parts separated by a dot. the first part is the service name witch can be changed in the settings dialog. The second part is the name of the event witch is associated with the action of the user.   

== Download the extension ==

click the link to download the xpi file
=== Thunderbird 1.0.x ===
[https://dragontalk.opendfki.de/cgi-bin/trac.cgi/file/trunk/dragontalk_userobs_thunderbird/build/dragontalk_userobs_thunderbird.xpi dragontalk_userobs_thunderbird.xpi]
=== Thunderbird 1.5 ===
[https://dragontalk.opendfki.de/cgi-bin/trac.cgi/file/trunk/dragontalk_userobs_thunderbird/build/dragontalk_userobs_thunderbird-M1.5.xpi dragontalk_userobs_thunderbird-M1.5.xpi]

[[BR]]
[[BR]]
== The following part describes the actions, methods and there parameters. ==

folder_URI = URI of imap folders has the form !imap://$username@$server/$foldername [[br]]
message_URI = URI of imap messages has the form: !imap://$username@$server/$foldernames/;UID=$messageKey


'''Mathod:''' eventFolderSelected [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||folderURI||the URI of the selected folder||

[[BR]]

'''Mathod:''' eventAddFolder [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||parentFolderURI||the URI of the parent folder of the added folder||
||childFolderURI||the URI of the added folder||

[[BR]]

'''Mathod:''' eventEmailSelected [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||FolderURI||the URI of the folder in which the email is placed||
||EmailURI||the URI of the email||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||
'''Comment:''' the boddy is always empty

[[BR]]

'''Mathod:''' eventDeleteEmail [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||FolderURI||the URI of the folder in which the email is placed||
||EmailURI||the URI of the email||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||
'''Comment:''' the boddy is always empty

[[BR]]

'''Mathod:''' eventViewEmail [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||FolderURI||the URI of the folder in which the email is placed||
||EmailURI||the URI of the email||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||
'''Comment:''' the boddy is always empty

[[BR]]

'''Mathod:''' eventMoveEmailToFolder[[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||FolderURI||the URI of the folder in which the email is placed||
||EmailURI||the URI of the email||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||
'''Comment:''' the boddy is always empty


[[BR]]

'''Mathod:''' eventSendEmail [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||FolderURI||the URI of the folder in which the email is placed||
||EmailURI||the URI of the email||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||

[[BR]]

'''Mathod:''' eventReceiveEmail [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||FolderURI||the URI of the folder in which the email is placed||
||EmailURI||the URI of the email||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||
'''Comment:''' the boddy is always empty

[[BR]]

'''Mathod:''' eventForwardEmail [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||OriginalMsgURI||the URI of the email which is forwarded||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||

[[BR]]

'''Mathod:''' eventReplyToEmail [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||OriginalMsgURI||the URI of the email which is replied||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||

[[BR]]

'''Mathod:''' eventPrintEmail [[BR]]
'''Parameters:''' 

||'''Key'''||'''Value'''||
||Subject||the subject of the selected email||
||FolderURI||the URI of the folder in which the email is placed||
||EmailURI||the URI of the email||
||Sender||the sender of this email name and email address (name <email-address>)||
||bccRecipients||the bind carbon copy recipients||
||ccRecipients||the carbon copy recipients||
||toRecipients||the to recipients||
||Body||the body of the email||
'''Comment:''' the boddy is always empty, works only via File -> Print... and with the print button in the toolbar of the main window.