MAIL_FWX: Filesystem plugin for Total Commander.
Purpose: Working with mail accounts.
Version: 0.91a (07.01.2007)
Author: Pavel Dubrovsky aka Antikiller.D1P (UIN 215168320)

Description:
The plugin is intended to work with mail boxes under POP3 directly in Total Commander.

In the current version the following operations are supported:
- Viewing information about the messages in the user columns without messages delivery (download only headers -> reduction of traffic).
- Removing messages from the server (DEL).
- Messages delivery with removing from the server (F6) and without removing (F5).
- Viewing size of a mail box without uploading messages.
- All messages are kept in *.eml format (see below).

Known restrictions:
- There is no confirmation on any operations, include existing files rewriting.
- Only basic operations are supported - that is no complex authentification, etc.
- All passwords store in plaintext. If you are afraid about your passwords safety - do not store it in a plugin!
- There is no problems diagnostics. That is plugin distinguishes only two connection mode: everything is all right or nothing works. The last can mean everything: mistypes in user data, broken connection, etc.
- The plugin is not able to work through a proxy.
- Time of last access for mailboxes showed as current (because there is no way to receive the true value).
- Messages encoding in plugin isn't processed in any way (i.e. messages with non-latin symbols can be viewed and saved incorrectly).


Plugin isn't tested on TC < 7.0, but, i think, no problems should be there.

Plans for future:
- Add password encryption.
- Add work with SMTP (sending of messages) and, may be, with IMAP4 (work with mail directly on the server).
- Add support of various ways of POP3 authentification (NTLM/RPA/MD5/etc), also  make SMTP-authentification (it is required for some servers).
- Add support of GMail (through POP3/SMTP TLS).
- Add support of work through a proxy.
- Add email editor (to work with messages directly in a plug-in).

---

Plugin installation:

Use autoinstall function in Total Commander or install plugin manually in Total Commander configuration.

Plugin setup:
Go to Network neighborhood in Total Commander and select MAIL item, press Alt+Enter, plugin options window will be shown. It is possible to choose plugin interface language in the list on the bottom of the window (selected language is applied at once).
It is necessary to add one mailbox for work with the plugin. Press "Add" button, and enter new mailbox name. Created mailbox will be selected in the mailbox list. Enter mailbox parameters in corresponding fields and press "Apply".

Note:
2. Also in the current version all passwords stored in plain text, so, if you are afraid about your passwords safety, DO NOT save any passwords in this plugin! Just leave password field blank, and it will be requested each time, at you tried get access to this mailbox.

After you enter all necessary parameters, you can close this window, or add one more mailbox in the same way.

Hint: you can use these hotkeys shortcuts for mailbox editing (mailbox list should be focused):
Insert: add mailbox.
Delete: remove selected mailbox.
F2, Shift+F6 or double click: rename selected mailbox.
F5: copy selected mailbox.

After one or more mailboxes added, enter plugin file system. List of mailboxes will be accessible as directories. If you use TC 7.0 + the user columns mode (see further) will be used by default.
Further the following operations are possible:
Alt+Enter on the directory: editing of parameters of a mailbox.
Space on the catalogue: a calculation of the size occupied on a mailbox. This operation demands connection to the server, however transfer of messages does not occur.
F7 (MkDir): create new mailbox.
F8, Del: delete selected mailbox.

Enter to the directory, and messages headers will be downloaded. You can see all possible information about messages (sender, size, date, etc). You can work with messages like with simple files - copy, move, view with Lister and delete operations are supported. Copying files into plugin virtual file system are not supported.

Note: 
If operation require connection to the server, the corresponding parameters specified for this mailbox are used. If password wasn't saved in mailbox parameters, then it will be requested at first connection attempt.
You can check "Save password" option in request dialogue, and password will be saved in mailbox parameters (like as you enter it in options window). If this option will not checked, the password will be kept in memory up to the end of session (until you press "Disconnect" button).

Work with the user columns:
The plugin supports user columns. This function required Total Commander 7.0 or higher.
Default set of columns is automatically applied at the first start of a plugin. So, it is possible to create own set of columns from the following:

Attachment encoding: identifies the default encoding mechanism used for message parts.
Recipients: carbon copy recipients for the message.
Date: the date and time a message was sent in a dd-mm-yy:hh.mm format.
Attachment MIME: identifies the MIME media type for the message.
Flags: flags of the message in format AFDXSR. It means: A) Answered - a reply has been sent for the message; F) Flagged - the watch flag has been set for a message or thread; D) Deleted - message has been deleted in the Mailbox; X) Draft - message is a draft and has not been sent; S) Seen - message has not been retrieved and read by the mail client; R) Recent - message has been added to the mailbox since the last time it was accessed.
From: identifies the original author of the message.
Organization: identifies the organizational affiliation for the message author.
Priority: identifies the message priority.
ReplyTo: identifies the delivery address for message replies.
Sender: identifies the sender of the message.
Subject: identifies the subject for the message.

Work with *.eml:
All messages in a plugin are submitted in a eml format. Eml is a simple text format, which can be looked through lister without any plugins installed (but you can't understand anything :))
The next ways possible to work with eml-messages:
1) Use internal viewer (Enter or Alt+Enter on selected message, depends on plugin options). This tool allow to see messages and work with attachments.
2) Press Enter on the message (in file system of a plugin (if corresponding option enabled), or on a eml-file in local file system). If some application (usually it is default e-mail client) is associated with this file extension, this application will be started and open this file.
3) Install wlx_eml plugin from Ivan aka Atlanoff. This plugin allows to look eml in a "readable" kind, and extract attachments from eml.
4) Use cm_Encode command on the eml-file. Total Commander will "unpack" the message, including all attachments. There we have some inconvenience - it is impossible to use the command inside plugin virtual file system, and it is impossible to apply the command on many files at once.

The additional information:
For work acceleration and traffic economy, plugin cached all received message headers. Cache updates each time at you open mailbox, so any out-of-date headers will not be used.
Cached headers can be found at the following path: plugin_dir\cache\mailbox_name\. You can see headers via Lister, or change files extension to .eml and use Lister with wlx_eml plugin.
Downloaded messages caching also possible. If corresponding option enabled, then all downloaded messages cached like a headers. In result there is an acceleration of repeated access to message, and traffic economy.
Messages don't cached on moving (F6) from server (because any operation with this message on the server are impossible) and on view via external application (because it is WFX API restriction).

---

History:

v. 0.91a (08.01.2007)
* Fixed list index out of bounds bug on options saving.
* Fixed bug with directory selection dialog.
* Messages caching bugfixes.
* Some interface bugfixes.
* Internal viewer bugfixes.
* Some other bugfixes.

v. 0.9a (07.01.2007)
* "Apply" button in mailbox options become activated only after modifications.
* Sorting on all user columns works.
* Language files extension changed to *.mpl (to avoid problems with user columns translation).
* SMTP options unlocked (though do nothing).
+ XP style support.
+ Mailbox copying (via F5 or context menu).
+ Make directory in plugin filesystem makes a new mailbox.
+ Removing directory in plugin filesystem removes a selected mailbox.
+ Messages caching (optional): all downloaded messages cached like a headers -> mail access acceleration and traffic economy.
+ Progress displayed at an entering to mailbox. Operation can be cancelled, thus work with already received letters will be possible (very useful for slow and unstable connections).
+ Message viewer added.
+ Viewing and saving attachments in internal viewer added.
+ Plugin behaviour on messages opening (Enter) and on properties viewing (Alt+Enter) can be adjusted.

v. 0.7b (05.01.2007)
* Empty mailbox list showed correctly.
* Options window changed, and Alt+Tab window loss bug fixed.
* Now possible to add additional info (like "about author") in localization file.
* All standart input dialogs changed to self-written.
* Shift+F6 shortcut added to rename mailbox.
* Default user columns view changed.

v. 0.7a (05.01.2007)
+ POP3 support.
+ Work with unlimited mailboxes amount.
+ Password request, if it is not stored.
+ Uploading progress showed.
+ Show some info in TC log panel.
+ Viewing the information on messages in  columns (TC 7.0 +).
+ Message headers caching.
+ Localization via .lng files.

---

Wishes and bug reports are accepted on ICQ UIN 215168320.