This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | Next revisionBoth sides next revision | ||
experimentalmodules:imapinstructions [2007/04/30 09:35] – sbernheart | experimentalmodules:imapinstructions [2007/11/13 12:08] – manni | ||
---|---|---|---|
Line 4: | Line 4: | ||
===== What IMAP.pm does (or tries to do) ===== | ===== What IMAP.pm does (or tries to do) ===== | ||
+ | |||
IMAP.pm, unlike POPFile' | IMAP.pm, unlike POPFile' | ||
+ | |||
IMAP.pm not only checks for new incoming mail, it also scans its output folders for mail that you moved there. For example, if you have created IMAP folders " | IMAP.pm not only checks for new incoming mail, it also scans its output folders for mail that you moved there. For example, if you have created IMAP folders " | ||
+ | |||
To summarize: | To summarize: | ||
* IMAP.pm will try to classify new messages and move them accordingly | * IMAP.pm will try to classify new messages and move them accordingly | ||
Line 11: | Line 14: | ||
===== What IMAP.pm (currently? | ===== What IMAP.pm (currently? | ||
+ | |||
* It cannot talk to multiple IMAP servers. | * It cannot talk to multiple IMAP servers. | ||
* It will not modify the subject (according to classification) or add any of the X-POPFile-Link or X-Text-Classification headers to messages. | * It will not modify the subject (according to classification) or add any of the X-POPFile-Link or X-Text-Classification headers to messages. | ||
Line 17: | Line 21: | ||
===== What you need to run IMAP.pm ===== | ===== What you need to run IMAP.pm ===== | ||
- | The IMAP module is not included in the default distribution of POPFile 0.22.2. A special [[http:// | + | All you need is a mail client with IMAP capabilities and an IMAP account at your ISP. The rest of the functionality is distributed along with POPFile. |
- | + | ||
- | If you are not on Windows, you can download the latest version of the IMAP module that works with POPFile 0.22.2, 0.22.3 or 0.22.4 | + | |
- | + | ||
- | If you are using the cvs version of POPFile, you should download the module [[http:// | + | |
- | + | ||
- | Of course, you will also need a mail client with IMAP capabilities and an IMAP account at your ISP. | + | |
===== How to get it running ===== | ===== How to get it running ===== | ||
Line 37: | Line 35: | ||
You do not have to make any changes to your mail client configuration to work with POPFile' | You do not have to make any changes to your mail client configuration to work with POPFile' | ||
+ | |||
===== Configuring IMAP.pm ===== | ===== Configuring IMAP.pm ===== | ||
- | To configure the module, go to the Configuration tab in the POPFile UI. Before you do that, however, you might want to use your mail client to create folders on your IMAP server that will receive the classified messages. For ex., you might want to create a folder named " | ||
- | First, enter the connection details for your IMAP server, i.e. the server' | + | To configure the module, go to the Configuration tab in the POPFile UI. Before you do that, however, you might want to use your mail client to create folders on your IMAP server that will receive the classified messages. For example, you might want to create a folder named " |
+ | |||
+ | First, enter the connection details for your IMAP server, i.e. the server' | ||
In the next configuration step, you need to tell the module about the IMAP folder that receives incoming messages (usually the INBOX folder), and the output folders where the classified messages should go. You need to use your mail client to create new folders on the server that correspond to your buckets. Click the " | In the next configuration step, you need to tell the module about the IMAP folder that receives incoming messages (usually the INBOX folder), and the output folders where the classified messages should go. You need to use your mail client to create new folders on the server that correspond to your buckets. Click the " | ||
Line 48: | Line 48: | ||
For each of your buckets, the UI should show a drop-down menu that lets you select an output IMAP server for that bucket. You can redirect the output of one bucket back to your INBOX, so that ham messages will simply stay there, while spam messages get moved to another folder. Click " | For each of your buckets, the UI should show a drop-down menu that lets you select an output IMAP server for that bucket. You can redirect the output of one bucket back to your INBOX, so that ham messages will simply stay there, while spam messages get moved to another folder. Click " | ||
- | |||
Line 60: | Line 59: | ||
! The number of bytes/ | ! The number of bytes/ | ||
? Debug level | ? Debug level | ||
- | ! In the latest versions on cvs there is no longer an IMAP specific debug level. | + | ! POPFile has a global debug level that can be changed via the Advanced Tab -- change the variable " |
Clicking on " | Clicking on " | ||
===== Reporting bugs ===== | ===== Reporting bugs ===== | ||
+ | |||
If you find any bugs (or have any questions), go to the [[http:// | If you find any bugs (or have any questions), go to the [[http:// | ||
===== Links ===== | ===== Links ===== | ||
+ | |||
We have started a [[ExperimentalModules: | We have started a [[ExperimentalModules: | ||
If you would like to know about the proposed future of the POPFile IMAP module, checkout the [[ExperimentalModules: | If you would like to know about the proposed future of the POPFile IMAP module, checkout the [[ExperimentalModules: | ||
Should you find anything in the documentation that is incomplete, unclear, outdated or just plain wrong, please let us know and leave a note in the Documentation Forum.