TDE personal information management applications
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Slávek Banko 72b5adf49c
Add CMakeL10n rules.
8 months ago
..
pics Fix invalid headers in PNG files and optimize for size 3 years ago
samples Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
CMakeL10n.txt Add CMakeL10n rules. 8 months ago
CMakeLists.txt Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
Makefile.am LIB_QT -> LIB_TQT conversion to align to updated admin module 11 months ago
README Additional kde to tde renaming 7 years ago
cr16-app-kmailcvt.png Fix invalid headers in PNG files and optimize for size 3 years ago
cr32-app-kmailcvt.png Fix invalid headers in PNG files and optimize for size 3 years ago
cr48-app-kmailcvt.png Fix invalid headers in PNG files and optimize for size 3 years ago
filter_evolution.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_evolution.hxx Trinity Qt initial conversion 9 years ago
filter_evolution_v2.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_evolution_v2.hxx Trinity Qt initial conversion 9 years ago
filter_kmail_archive.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_kmail_archive.hxx * Massive set of changes to bring in all fixes and enhancements from the Enterprise PIM branch 9 years ago
filter_kmail_maildir.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_kmail_maildir.hxx Trinity Qt initial conversion 9 years ago
filter_lnotes.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_lnotes.hxx Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
filter_mailapp.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_mailapp.hxx Trinity Qt initial conversion 9 years ago
filter_mbox.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_mbox.hxx Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
filter_oe.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_oe.hxx rename the following methods: 8 years ago
filter_opera.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_opera.hxx Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
filter_outlook.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_outlook.hxx Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
filter_plain.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_plain.hxx Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
filter_pmail.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_pmail.hxx rename the following methods: 8 years ago
filter_sylpheed.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_sylpheed.hxx Trinity Qt initial conversion 9 years ago
filter_thebat.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_thebat.hxx Trinity Qt initial conversion 9 years ago
filter_thunderbird.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filter_thunderbird.hxx Trinity Qt initial conversion 9 years ago
filters.cxx Rename additional header files to avoid conflicts with KDE4 6 years ago
filters.hxx Remove additional unneeded tq method conversions 7 years ago
kimportpage.cpp Rename common header files for consistency with class renaming 6 years ago
kimportpage.h Remove spurious TQ_OBJECT instances 7 years ago
kimportpagedlg.ui Rename obsolete tq methods to standard names 7 years ago
kmailcvt.cpp Rename common header files for consistency with class renaming 6 years ago
kmailcvt.h Rename common header files for consistency with class renaming 6 years ago
kselfilterpage.cpp Rename additional header files to avoid conflicts with KDE4 6 years ago
kselfilterpage.h Remove spurious TQ_OBJECT instances 7 years ago
kselfilterpagedlg.ui Rename obsolete tq methods to standard names 7 years ago
main.cpp Rename common header files for consistency with class renaming 6 years ago
uninstall.desktop Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago

README

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 tdepim 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 *parent(); // The parent 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.