AutoSave allows a user to automatically save messages as individual files upon receipt or upon send
The filenames of these individual files are specified by userprefs
Firstly, the user prefs
autosave.defaultExt dictates the default extension of filenames
autosave.filename_style dictates how the filename will be arranged
so for sender - date - subject
user_pref("autosave.defaultExt", ".eml");
user_pref("autosave.filename_style", "%sndr - %dat - %subj");
will produce a filename like "Jim@someisp.com - <dateFormat> - The pics I promised.eml"
That way any permutation can be used..
for sender=subj=recipient
user_pref("autosave.filename_style", "%sndr=%subj=%recp");
will produce "Jim@someisp.com=The pics I promised.eml=me@myisp.com"
outgoing_filename_style dictates how outgoing filenames will be formatted
..in case you want the outgoing filenames formatted different to incoming... follows the same rules as filename_style
autosave.date_style dictates how the %dat variable will look
user_pref("autosave.date_style", "%dd.%mm.%yyyy");
will produce a date like 04.11.2005
user_pref("autosave.date_style", "%mm%dd%yyyy");
will produce a date like 11042005
hours minutes seconds and ampm are supported as well ( NOTE minutes is %mn )
%hr, %mn, %ss, %ampm
...if %ampm is present, hrs will be 12 hr format
...if %ampm is NOT present, hrs will be 24 hr format
%now will insert your current system date in a filename, formatted according to autosave.date_style
A complete list of variables > %sndr, %dat, %subj, %recp, %now, %yyyy, %mm, %dd, %hr, %mn, %ss, %ampm
A "Rules" file dictatates what will be autosaved and to where ( an example is in the xpi )
Breifly, the rules file lists headers ( of the message ) first, then a path string..
Each header can have a regexp - not all headers need be included in a rule
if all headers' regexps for a rule match, the corresponding 'fileto' path will be used no further rules will be considered
Now for the fun bit..
IF the regexp produces two substring matches, the second will fill in a %r var which can be used in the fileto path
example: this rule will take messages whose subject has the string '#' in it and will file it in c:\docs\XXXXX\<filename_style>.eml
...where XXXXX are the characters that follow the # in the subject line, ending at the first space character
subject:(#)([^ ]*)
fileto:c:\docs\%r\
headers that can be regexped (so far) are
from
to
subject
NOTE: the fileto path that you want to be used MUST EXIST or the autosave will fail.. This can be a benefit as you can have a rule that matches messages that you DO NOT want autosaved use a path that does NOT exist
The combo of a rules file and the userprefs can be very powerful..
If you put slashes in the filename_style ( or outgoing_filename_style ) , those get used as directory specifiers when the file is eventually saved
- for example -
if your filename style looks like this %dat-%sndr-%subj"
and you have your datestyle pref look like this %yyyy\\%mm\\%mm%dd%yyyy~%hr:%mn
and your rule specifies a path of C:\archive\projectX\
then your filename and path will be C:\archive\projectX\2005\06\06152005~15:04-todd@jams.org-project Specs revision 111.eml
it also is able to import one/many emls from File...Import Messages
and is able to import one/many emls when you double click an eml file in explorer or block select a bunch of emls in explorer and right-click 'open' them
...changes to your registry are required !!! ( instructions here > www.supportware.net/mozilla/TB_AutoSaveHelp.txt )
get it from from www.supportware.net/mozilla/AutoSave.xpi
