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.
tdepim/kmailcvt
Michele Calgaro 3a75bdfe83
Renaming of files in preparation for code style tools.
4 years ago
..
pics Fix invalid headers in PNG files and optimize for size 8 years ago
samples Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 years ago
CMakeL10n.txt It is no longer necessary to explicitly specify *.cxx and *.hxx 4 years ago
CMakeLists.txt Renaming of files in preparation for code style tools. 4 years ago
Makefile.am Renaming of files in preparation for code style tools. 4 years ago
README Renaming of files in preparation for code style tools. 4 years ago
cr16-app-kmailcvt.png Fix invalid headers in PNG files and optimize for size 8 years ago
cr32-app-kmailcvt.png Fix invalid headers in PNG files and optimize for size 8 years ago
cr48-app-kmailcvt.png Fix invalid headers in PNG files and optimize for size 8 years ago
filter_evolution.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_evolution.h Renaming of files in preparation for code style tools. 4 years ago
filter_evolution_v2.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_evolution_v2.h Renaming of files in preparation for code style tools. 4 years ago
filter_kmail_archive.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_kmail_archive.h Renaming of files in preparation for code style tools. 4 years ago
filter_kmail_maildir.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_kmail_maildir.h Renaming of files in preparation for code style tools. 4 years ago
filter_lnotes.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_lnotes.h Renaming of files in preparation for code style tools. 4 years ago
filter_mailapp.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_mailapp.h Renaming of files in preparation for code style tools. 4 years ago
filter_mbox.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_mbox.h Renaming of files in preparation for code style tools. 4 years ago
filter_oe.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_oe.h Renaming of files in preparation for code style tools. 4 years ago
filter_opera.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_opera.h Renaming of files in preparation for code style tools. 4 years ago
filter_outlook.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_outlook.h Renaming of files in preparation for code style tools. 4 years ago
filter_plain.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_plain.h Renaming of files in preparation for code style tools. 4 years ago
filter_pmail.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_pmail.h Renaming of files in preparation for code style tools. 4 years ago
filter_sylpheed.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_sylpheed.h Renaming of files in preparation for code style tools. 4 years ago
filter_thebat.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_thebat.h Renaming of files in preparation for code style tools. 4 years ago
filter_thunderbird.cpp Renaming of files in preparation for code style tools. 4 years ago
filter_thunderbird.h Renaming of files in preparation for code style tools. 4 years ago
filters.cpp Renaming of files in preparation for code style tools. 4 years ago
filters.h Renaming of files in preparation for code style tools. 4 years ago
kimportpage.cpp Rename common header files for consistency with class renaming 12 years ago
kimportpage.h Remove spurious TQ_OBJECT instances 13 years ago
kimportpagedlg.ui Rename obsolete tq methods to standard names 13 years ago
kmailcvt.cpp Renaming of files in preparation for code style tools. 4 years ago
kmailcvt.h Rename common header files for consistency with class renaming 12 years ago
kselfilterpage.cpp Renaming of files in preparation for code style tools. 4 years ago
kselfilterpage.h Remove spurious TQ_OBJECT instances 13 years ago
kselfilterpagedlg.ui Rename obsolete tq methods to standard names 13 years ago
main.cpp Rename common header files for consistency with class renaming 12 years ago
uninstall.desktop Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 15 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.cpp and filter_myformat.h
and add "filter_myformat.cpp" to the end of the kmailcvt_SOURCES line in
Makefile.am and "filter_myformat.cpp filter_myformat.h" 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.