MuMail Script ver.

Installation Instructions
  1. Download MuMail & unpack the zip file.
  2. Open and configure the mmconfig.php file.
    • Set the variable site_name to your site url.
    • Set the variable site_short to your site short name (i.e. without "http://www.".
    • Set the variables site_add1-4 to the email addresses where YOU will receive emails. These variables have two purposes. They are where "test" emails are sent and are also the addresses that will appear on recipients' emails as the sender.
    • Set the variables site_add1-4n to the corresponding "friendly names" for the email addresses in site_add1-4.
    • Set the variable sub_dir to the name of the subdirectory on your website where the program files will reside, or leave blank for the root directory.
    • Set the variable templates_dir to the name of the subdirectory (of sub_dir) on your website where you will keep email templates.
    • Change the names of email recipients' groups. Note that if you specify two groups when sending emails, the system will only send to people who are members of BOTH groups
    • Set the [message_info] and [config_info]details as required.
  3. Edit the maillist.php file to set up your pseudo-database, leaving the first line (<?php die(); >) and the last line (Zz...) as they are.
  4. Upload all files in the same folder (sub_dir) on your server.

Email Fields

You can include various fields in both the text typed in at send time (mmsend.php) and in htm templates.

* Those marked above with an asterisk, if required, must be in an email template as well as in the text typed to the screen in mmsend.php. If entered on the screen in mmsend.php, they are used for text-only emails but are stripped out from the on-screen text for htm emails. This is to avoid them appearing twice in htm email.

Note that you cannot, of course, have "{footer}" inside the footer itself - results would be unpredictable. If the application discovers such an instance, it is stripped out of the footer.

Recipient Selection

If you select recipients by group, note that the selection is exclusive rather than inclusive. In other words, if you select both group 1 and group 2, the system will send ONLY to people who are members of BOTH groups 1 and 2. If you want to send to people who are members of Group 1 OR group 2, send one email to all members of Group 1, and once that email is sent, uncheck Group 1, check Group 2 and send the email again.

If you want to select only a few recipients who are not homogenous members of a group, select "Individuals", and Ctrl/Click each name in the list to select them.

If you select "Test", the system will send email ONLY to the address chosen in the "From:" drop-down list. If an htm template has been chosen, the system will send two emails to that address - one in htm, one in plain text. If "Text only" is selected, it will send only one, text-only, email to that address.

Mailing Method

You can select how to send your emails. You can (a) send one email to each recipient (resulting in as many emails sent as recipients) or (b) send one email to all recipients (resulting in only one or two - text and htm - emails being sent), with each email address showing in the "To:" field or (c) send one email to all recipients (also resulting in only one or two - text and htm - emails being sent) with their addresses going into the "Bcc:" field and "Undisclosed Recipients" showing in the "To:" field, thus hiding people's email addresses from each other. Selecting the "Bcc yourself" option does what it says, with one exception - if you use the third option (c) above, of sending to everyone via the Bcc field, your sending email address is automatically included, and another Bcc copy is NOT sent, so you will receive one copy automatically. You also need to note that the "Unsubscribe" and "Change to htm/text version" links will not appear on emails sent out by either of the latter two methods above, only if sent out "Singly".

Maling List

The system uses an unindexed, plain-text file. Because it is unindexed, you can have only one recipient with a particular combination of Given name and Surname, and only one recipient with any given email address. If you want to send two copies to one person at two different email addresses, you will have to vary the name for the second address (e.g. John Smith / J. Smith).

For the same reason, you cannot change someone's name at the same time as changing their email address - you will have to change them twice, once for the name, once for the email address.

Important - please note

Some desktop email applications (notably Outlook 2007, GMail and Lotus Notes) mangle html emails horribly, and it is a major pain to write email templates that can accommodate them all. Most significant among the problems is inconsistent interpretation of <style> lines and use of CSS, ignoring "float" attributes and background images. Unless you are going to send only emails that people cannot reply to, in which case you can use something like this, I recommend very strongly that you write your templates in plain html such as this, setting font styles with a <font> statement rather than setting a style, etc.

Also important

Take a moment to look at the source code for the two sample email templates linked to in the paragraph above. You will see two html comment lines, <!--first here--> and <!--last here-->. These tell the mail composition program where it can place the various system messages such as the "Do not reply to this email" message. If you omit these, the program will place those messages right at the top of the <body> section before any other code and immediately before the </body> statement, which might result in a rather unattractive email.
It is also important that each of these two appear on separate lines by themselves, without any other text either before or after within the line.
Examples of the two email templates are included in the zip file you receive when you buy the application.

Is something not working?

If, when trying to send html email, you find what appears to be message header in the body of the email, you can try editing the mmconfig.php file where you see the line emailcrlf = "\r\n". Please note - this line MUST show either emailcrlf = "\r\n" or emailcrlf = "\n". If anything else apears here, the email sending system WILL NOT WORK.

Please feel free to contact us or ask a question. Remember to leave details and specifics of your problem, simply stating "It doesn't work" doesn't help me help you solve the problem!