7aa22276 |
1 | Mail Fetch |
d622d38a |
2 | |
3 | Downloads mail from a pop3 server to your SquirrelMail account. |
4 | |
5 | Features |
6 | ======== |
7 | |
8 | * Copies messages from remote server |
9 | * Saves server, alias, username, and password in prefs file... |
598294a7 |
10 | * Remembers where to resume downloading messages if |
d622d38a |
11 | your pop server supports UIDL. |
12 | * Optionally deletes mail from the remote server. |
13 | * Allow an infinite amount of remote servers |
14 | * Optional to not save password - prompt on check |
15 | * Save messages into a local IMAP folder instead of INBOX |
598294a7 |
16 | * Check mail during login (Needs SM 1.1.3 or older). |
d622d38a |
17 | * Check mail during folder refreshes. |
18 | * Allows gettext translations. |
19 | |
20 | |
21 | Description |
22 | =========== |
23 | |
24 | Feel like grabbing your messages from a different mail server into |
25 | SquirrelMail? This might be able to help. |
26 | |
27 | |
28 | Configuration |
29 | ============= |
30 | |
31 | Under the options you can add, delete or modify server list where |
32 | fetching mail. For each server you can set also username and password; |
33 | if you leave password blank, the password whore required when you fetch |
598294a7 |
34 | mail. Make sure "Leave Mail On Server" is checked if you do not want |
d622d38a |
35 | Mail_Fetch to delete it from the remote server. Once configured, |
36 | click 'Fetch' in the SquirrelMail menu to get your mail; you can fetch |
37 | mail from all server instead or from only one by selecting the options |
38 | dispayed. |
39 | |
40 | If you want to check mail periodicaly choose "Check mail during login" |
41 | or "Check mail during folder refresh". Of course passwords have to be |
42 | entered in order for this to work. |
43 | |
44 | In order to secure a little bit the system, pop3 passwords can be encrypted. |
45 | The encryption key may be defined in to places. The first, and more secure, |
598294a7 |
46 | is in the httpd configuration as an enviromental variable called MF_TIT |
47 | only accesible from the SquirrelMail directory. |
48 | |
49 | the way you can do this from apache is adding the following directives to |
50 | httpd.conf (supposing that SquirrelMail is located at /usr/local) or an |
d622d38a |
51 | included configuration file: |
52 | |
53 | <Directory "/usr/local/squirrelmail"> |
54 | SetEnv MF_TIT "MailFetch Secure for SquirrelMail 1.x" |
55 | </Directory> |
56 | |
57 | Of course, you should replace the text inside double quotes with the key |
598294a7 |
58 | you want to (some kind of secret text). A please remember that the file |
d622d38a |
59 | where you decided to place this must be root only readable. |
60 | |
61 | The second way is to edit functions.php and look for: |
62 | |
63 | if( !isset( $MF_TIT ) ) { |
64 | $MF_TIT = "MailFetch Secure for SquirrelMail 1.x"; |
65 | } |
66 | |
7aa22276 |
67 | Once again change the text "MailFetch Secure for SquirrelMail 1.x" |
d622d38a |
68 | with a secret text. |
69 | |
70 | Please note that you must redefine passwords each time you change the key. |
71 | |
72 | To maintain compatibilty with older systems, mail_fetch can work with old |
73 | pref files, with no encrypted passwords. If this occurs, you'll see that |
74 | the "Encrypt Password" checkbox in the option page is not checked. If you |
75 | reenter account's passwords the system will switch to encrypted mode. |
76 | |
77 | |
78 | Future Work |
79 | =========== |
80 | |
81 | * Add IMAP server stealing |
598294a7 |
82 | |
d622d38a |
83 | * Limit number of pop accounts |
84 | |
85 | |
86 | Installation |
87 | ============ |
88 | |
7aa22276 |
89 | Go back to the main directory, run configure and add the plugin. |
d622d38a |
90 | |
91 | |
92 | Translations |
93 | ============ |
598294a7 |
94 | Translation is made in the same manner as SquirrelMail's core. |
d622d38a |
95 | You need to take <plugin_name>.po file, fill the template, store it |
96 | in the appropriate locale folder under the plugin and compile the po |
97 | file. Better than this fill the po file and send it back to the author. |
98 | The translation will be included in the next release of the plugin. |
99 | |
100 | |
101 | Note for mod_gzip users |
102 | ======================= |
103 | |
104 | As fetching module shows information while fetching is taking place, it |
105 | is a good idea to disable compression for that operation. The way to do |
106 | this with mod_gzip is: |
107 | |
108 | mod_gzip_item_exclude file fetch.php |
109 | |
110 | |
111 | Note for Newmail Plugin users |
112 | ============================= |
113 | |
114 | In order to Newmail plugin detect new mails during folder refreshes |
115 | make sure that Mail_Fetch is listed first that Newmail in the |
116 | SM configuration. To do so you only have to remove Newmail plugin |
117 | and then add it again. |
118 | |
119 | |
7aa22276 |
120 | Credits |
121 | ======= |
122 | |
123 | This plugin has been originally created by Tyler Akins, with contributions |
124 | from Philippe Mingo, Tomaso Minelli and Joshua Pollak. It's now maintained |
125 | by the SquirrelMail Project Team. |
126 | |