*** UPDATE ***

J-Mail v4.0 IS HERE!

This script was written by Jamie Martino, and all rights are reserved. You may use this script, and modify for use on your web site, but you can not claim it as your own.. Please feel free to share this script with your friend's and enjoy! I claim no responsibility for any damage from use of this script. I have fully tested it on my server and have found no major problems with it. If you come across any bugs, please send them along to me. Thank you.

Welcome to my Newsletter script.. I wrote this script because my boss wanted the ability to send HTML Newsletters, and realize there weren't many decent ones out there.. So here is J-Mail!! Named after me, Jamie Martino.. I will update this script whenever I can.. However, if you wish to make an update to it, and send me the changes I will give you credit in here and in the scripts..

Click Here to download version 4.0!
Click Here to be notified of new versions!

New in Version 4.0!
  • Email-In Newsletters - You simply assign an email address to a database and then you can send newsletters by composing them in your favorite email program and sending it to the assigned email address. This is been tested with Outlook Express 6.0 and works perfectly. If you use another program and experience any problems, please let me know. (this requires crontab access)
  • Email-In Removal - Your users can now be removed from newsletters by emailing a blank email with the subject "REMOVE ME" to the assigned email address for the newsletter and the software will automatically remove them. (this requires crontab access)
  • Easier to use Cron Manager - The cron manager has been made easier to read and use. You can now easily update your J-Mail Crontab settings with the click of a mouse.
  • Added Template Support - You can now fully customize the look of J-Mail through the use of templates! Simply edit the template file and leave the !DOMAIN! and !OUTPUT! alone, and you're on your way! You can even customize the table colors in J-Mail in the 'jmail.cfg' file.
  • Minor Bug-Fixes - Fixed several bugs that I have come across lately due to the many changes I've been implementing.

Batch Job Processing is a way to get around those spam control limits on outgoing mail. For those of you unfamiliar with what I am talking about, there are some servers which put a cap on how many emails you can send in an hour or day or whatever they choose. With batch job processing, your newletters are sent out as often as you allow, and only in blocks of the number of emails you choose.

And now you can setup the cron job for J-Mail right from the Admin Panel!! It is located under the Batch Job menu.

For example:
You have a limit of 100 emails per hour, and you have 1000 emails in your database to send to. Normally, the script would attempt to send them all at the same time, starting with 1 and working until it got to 1000. With the Batch Job Processing in J-Mail, you can setup a crontab to run a special "Batch" script (included) once every hour, and tell it to only send out 100 emails per batch/hour.

 
Rate this Script @ The CGI Resource Index!
Script Rating:

Click Here to try a DEMO of version 4.0!
Everything works exactly as the real thing, except it won't actually send any mail
or change my current crontab for obvious security reasons.

Now, on to setup..
SETUP
OK, first, the files:
jmail.cfg ----------------> The Configuration File.. This is the file you edit to for setup. This is where you specify all your configuration options. Needs to be in the same folder as "jmail.cgi" and also a copy of it needs to be placed in the same folder as "j-subscribe.cgi". Remember to change both files if you need to change it at all.
jmail.cgi ----------------> The Administration Script.. Use this for sending/managing Newsletters. This should be in a password protected folder.
j-subscribe.cgi --------> The Subscription Script for adding/removing people from your Newsletter.
jmail-batch.cgi -----------------> The script for running Batch Jobs. This goes in the same directory as jmail.cgi. You will need to have access to your crontab to use this feature. This setting is adjusted using the Cron Manager in J-Mail.
jmail-check.cgi -----------------> The script for utilizing the Email-In features of J-Mail. This goes in the same directory as jmail.cgi. You will need to have access to your crontab to use this feature. This setting is adjusted using the Cron Manager in J-Mail.
Next, open the 'jmail.cfg', 'jmail-batch.cgi', and 'jmail-check.cgi' file in a text editor and set them up accordingly depending on your web site. The configuration file is very well commented, and you should have no problems.
Now, you need to add a small form to the web page you wish people to subscribe/unsubscribe from. The HTML should look something like this:

<FORM NAME="j-mail" METHOD="post" ACTION="cgi-bin/j-subscribe.cgi">
<INPUT TYPE="radio" NAME="action" VALUE="subscribe" CHECKED>Subscribe
<INPUT TYPE="radio" NAME="action" VALUE="unsubscribe">Unsubscribe
<INPUT TYPE="text" NAME="email" SIZE="20" VALUE="Email Address">
<INPUT TYPE="hidden" NAME="database" SIZE="20" VALUE="maillist.db">
<INPUT TYPE="submit" NAME="Submit" VALUE="Join">
</FORM>

Or you can choose to display it how ever you want, just remember there are 3 required variables:
action -------------------> can be either 'subscribe' or 'unsubscribe'.
email --------------------> the user's email address.
database ---------------> the database (list) to subscribe to.
After you have done all that, upload the scripts to the appropriate directories!
j-subscribe.cgi --------> Usually goes in the 'cgi-bin' folder. Don't forget to include a copy of 'jmail.cfg' in the same folder.
jmail.cgi ----------------> Needs to go into a folder that only the administrator has access to!! THIS IS VERY IMPORTANT!! IF SOMEONE ELSE GAINS ACCESS TO THIS SCRIPT, THEY CAN SEND MASS SPAM AND HAVE IT APPEAR TO COME FROM YOU!!
jmail.cfg ----------------> A copy needs to go into the same folders that "jmail.cgi" and "j-subscribe.cgi" are in!! THIS IS VERY IMPORTANT!! THE SCRIPTS WON'T WORK IF IT ISN'T!!
jmail-batch.cgi -------------> This goes in the same directory as "jmail.cgi". This goes in the same directory as jmail.cgi. You will need to have access to your crontab to use this feature. This setting is adjusted using the Cron Manager in J-Mail.
jmail-check.cgi -----------------> This goes in the same directory as "jmail.cgi". This goes in the same directory as jmail.cgi. You will need to have access to your crontab to use this feature. This setting is adjusted using the Cron Manager in J-Mail.

You will need to adjust the "template.htm" file in the "templates" folder to match your site. The "templates" folder will need to go into your Data folder. Leave the !DOMAIN! and !OUTPUT! alone, the script needs these and replaces them with the appropriate values. !OUTPUT! will output all script output and the !DOMAIN! will output only the domain name.

If you are using the Batch Job Processing or Email-In features, and have access to your crontab, now you add a line to your crontab that runs this however often you wish. I reccomend once an hour, but it is entirely up to you. You will only have to setup the crontab ONCE. Once it is setup, it will run every hour (or however often you choose) and check for any batches awaiting to go out. If no Batch Jobs exist, then it stops and waits to check again when scheduled. You can do this from the J-Mail admin panel.

If you are upgrading, backup your Newsletter Database files in the data folder first. The filenames are given to you in the dropdown boxes of J-Mail admin. Then, after you have backed up your datafiles, delete everything in your data folder. Then simply overwrite the main program files with the ones mentioned above and then replace your Newsletter Database files back into the data folder and then add them in using the J-Mail Admin panel. As long as you use the same names when adding them back in, the program will see files and use the existing data rather than create a new database.

Well, that's it, enjoy!!
Please send all inquiries to me using the Contact Me link on the left... If are writing because of any problems you are having, please send me as much information as possible, including any error messages you are receiving, what operating system your website is using, not your personal computer, (i.e. Windows with Microsoft IIS, Linux with Apache, etc.) and what browsers you are using.

This script has been tested as much as possible on a Linux web server running Apache. This is the only web server I can guarantee at the moment due to lack of access to a windows or other type of server. If anyone knows of a good "FREE" windows hosting site, please forward the information on to me. This script has also been test greatly with Outlook Express 6.0 and the Email-In features work perfectly. Again, if you notice any problems, please let me know. If they pertain to the Email-In feature, please let me know what email program you are using.

Click Here to be notified when a new version is released!

Limited Warranty and Disclaimer of Warranty

THIS SOFTWARE AND ACCOMPANYING WRITTEN MATERIALS, IF ANY (INCLUDING INSTRUCTIONS FOR USE) ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. FURTHER, JAMIE MARTINO DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF USE, OF THE SOFTWARE OR WRITTEN MATERIALS IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, CURRENTNESS, OR OTHERWISE. THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU. IF THE SOFTWARE OR WRITTEN MATERIALS ARE DEFECTIVE YOU, AND NOT JAMIE MARTINO OR ITS DEALERS, DISTRIBUTORS, AGENTS, ASSOCIATES, OR EMPLOYEES, ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

THE ABOVE IS THE ONLY WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, THAT IS MADE BY JAMIE MARTINO, ON THIS JAMIE MARTINO PRODUCT. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY JAMIE MARTINO, ITS DEALERS, DISTRIBUTORS, AGENTS OR EMPLOYEES SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY AND YOU MAY NOT RELY ON ANY SUCH INFORMATION OR ADVICE. YOU MAY HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE.

NEITHER JAMIE MARTINO NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION OR DELIVERY OF THIS PRODUCT SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL OR INCIDENTAL DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, AND THE LIKE) ARISING OUT OF THE USE OR INABILITY TO USE SUCH PRODUCT EVEN IF JAMIE MARTINO HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

This Limited Warranty shall be governed and construed in accordance with the laws of the State of Florida.