|
|
|
|
The KDE Mail Import tool - KMailCVT
|
|
|
|
|
===================================
|
|
|
|
|
|
|
|
|
|
This directory contains the sources for the kmailcvt program. It communicates
|
|
|
|
|
with KMail via its DCOP interface to add messages.
|
|
|
|
|
|
|
|
|
|
Writing a filter
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
...is very easy. Create two files filter_myformat.cxx and filter_myformat.hxx
|
|
|
|
|
and add "filter_myformat.cxx" to the end of the kmailcvt_SOURCES line in
|
|
|
|
|
Makefile.am and "filter_myformat.cxx filter_myformat.hxx" to the end of the
|
|
|
|
|
EXTRA_DIST line in Makefile.am. Now run "make -f Makefile.cvs; ./configure" in
|
|
|
|
|
your kdepim source directory.
|
|
|
|
|
|
|
|
|
|
In the import method of your filter you are passed a FilterInfo object. This has
|
|
|
|
|
the following methods that you may want to use:
|
|
|
|
|
|
|
|
|
|
void setFrom( const QString& from ); // Set to file importing from
|
|
|
|
|
void setTo( const QString& to ); // Set to folder importing into
|
|
|
|
|
void setCurrent( const QString& current ); // What we are doing
|
|
|
|
|
void setCurrent( int percent = 0 ); // Set percentage of current file
|
|
|
|
|
void setOverall( int percent = 0 ); // Set overall percentage
|
|
|
|
|
void addLog( const QString& log ); // Add a message for the user to see
|
|
|
|
|
void alert( const QString& message ); // Tell user something has gone wrong
|
|
|
|
|
QWidget *tqparent(); // The tqparent widget
|
|
|
|
|
|
|
|
|
|
bool removeDupMsg; // true, if user selected 'remove duplicated messages'
|
|
|
|
|
|
|
|
|
|
Also, every now and again you should check to see if the shouldTerminate method
|
|
|
|
|
returns true, if it does the user has pressed cancel and your import method
|
|
|
|
|
should return.
|
|
|
|
|
|
|
|
|
|
To add messages, extract the email (including all headers) into a KTempFile.
|
|
|
|
|
Then use the following:
|
|
|
|
|
|
|
|
|
|
if(info->removeDupMsg) addMessage( info, folderName, tempfilepath );
|
|
|
|
|
else addMessage_fastImport( info, folderName, tempfilepath );
|
|
|
|
|
|
|
|
|
|
For a simple example, look at filter_plain
|
|
|
|
|
|
|
|
|
|
Finally for the filter to appear in the combo box in the wizard you need to edit
|
|
|
|
|
kselfilterpage.cpp and add an appropriate addFilter() function call.
|
|
|
|
|
|
|
|
|
|
Danny Kukawka, February 2005
|
|
|
|
|
Laurence Anderson, April 2003.
|
