crackerMail v1.0.1 (Release Candidate 2)

Created by Craig (Big Cracker) McNaughton
www.bigcracker.ca


This is a really basic webmail system, using PHP's IMAP functionality. It was designed for use in a
password-protected folder, since POP3 mailbox usernames and passwords are stored, making mailboxes
available to anyone with access to the folder.


Installation:
1. unzip the contents of crackerMail_101_rc2.zip into a password-protected folder
	- or unzip the contents and upload them into a password-protected folder
2. in the same folder, create a file called email_config.php with CHMOD 007 (or 777 or 667,
as long as 'Everyone' has read, write and execute permissions)
	- if you had previously installed crackerMail v1.0, you can simply copy your existing
	email_config.php file (ensure permissions are still correct)
3. open index.php in you favourite browser
4. select 'Manage Mailboxes'
5. add your mailboxes
6. click on 'Back to Mailboxes' to return to index.php
7. click on mailbox to view messages


The capabilities of crackerMail are as follows:
1. handles any number of POP3 mailboxes
2. delete messages
3. download attachments
4. options to Reply, Reply All, and Forward
5. option to Reply from another mailbox, if other mailboxes are created in 'Manage Mailboxes'
6. option to view 'full headers' of messages
7. option to modify mailbox information
8. lists all mailboxes and messages in 1 table
9. sort list of messages by 'From', 'Subject' or 'Date'
10. option to go to another mailbox without returning to home page
11. includes HTML editor for composing messages in HTML format
	- using Cross-Browser Rich Text Editor by Kevin Roth (http://www.kevinroth.com/rte/demo.htm)

There may be other capabilities not specifically listed.


The limitations of crackerMail are as follows:
1. no option for customizing reply format
2. no option for editing original message on Reply, Reply All or Forward
3. no option for automatically adding signature
4. no capability for adding attachments to outgoing mail
5. no capability for modifying server port for mail server, standard POP3 mail server uses port 110 (e.g., mail.example.com:110)
6. IMAP mailboxes are not supported
7. server must have PHP compiled with IMAP support and valid sendmail parameters 

There may be other limitations that have yet to be identified.

Manual changes:
1. In the index.php file, the default 'Exit' option is to the root folder. This can be changed on line 8.
2. In the default.php file, the default sort option is by Received Date in descending order (putting
new messages at the top). This can be changed on line 227:
	- sortTable("date","desc","date");
	- Parameters: Column, Direction, Field
	- Column: from, subject, date
	- Direction: asc, desc (ascending = lowest to highest, descending = highest to lowest)
	- Field: from, subject, date
		- This parameter keeps track of the last field sorted, for default sort options, Column
		and Field should be the same.
3. In the compose_msg.php file, the default mail format is 'html'. This can be changed to 'plain' on line 287.

What changed between RC1 and RC2?
1. Added an option to "Check for New Messages" on index.php.
2. Modified the mailboxes to be accessed by clicking on a "View" button, rather than on the line
	- This allowed for more obvious navigation.
3. Corrected JavaScript error occurring when page loaded with no messages or did not connect to mail server.
4. Corrected variance where the Original Message was not being attached to the Reply, Reply All
or Forward Message.
	- While this seems to be resolved, please report any problems.
5. Added feature to replace obvious links (e.g., http://www.example.com) with actual links when viewing text-formatted messages.
6. Removed extraneous files from /rte/ folder.

If you have any questions or suggestions, feel free to email me at cracker@bigcracker.ca

- Craig