Ok now the Installation
Ok the most important file is the conn.asp, why because that is the page you need to go into and change a few things. Just use Note Pad or other editor.

Now the most important variable to change is the path to you email.mdb file......
If you publish to your site with FrontPage, it will ask to configure the mdb file, go yes, then it will ask if you wish to put it in the fpdb directory or leave it where it is...that's your choice, just make sure you reflect the path in the conn.asp file. And that's your full path not the url...for example c:/inetpub/wwwroot/yoursite/fpdb/email.db. If your not sure of the path then ask your Host.

This is what you will see in the conn.asp page, change whats in red.

' Change the Data Source to where your email.mdb is, do not change anything else.

Dim ConnectString, conn
ConnectString = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source= c:/inetpub/wwwroot/doitasp/fpdb/email.mdb"
Set conn = Server.CreateObject("ADODB.Connection")
conn.open ConnectString

%>

<%
'Various variables needed for the operation of the Scripts.

Dim sitename, url, listname, adminemail, scripturl, component, mailserver
sitename = "yoursitename" 'Change this to the title of your web site.
url = "urlofyoursite" ' Change this to the url to your web site. ( No trailing slash)
scripturl = "urltoyourscriptdirectory" 'Change this to the url of the directory that ListMail is in, should be called listmail. ( No trailing slash)
listname = "yourlistname" ' Change this to what you wish to call your mail list, advisable to keep it short.
adminemail = "youremail" ' Change this to your email address.
component = "mail component" ' this is where you choose which mail component to use either type in "CDONTS" , "Jmail", "ASPemail" , "ASPMail" or "DundasMailer".
mailserver = "mail.server.com" 'this is where you place your mail server must have for Jmail, ASPemail, ASPMail and DundasMailer.
%>

<%
' Password and Username variables.

Dim password, username
username = "username" ' Change this to your preferred username.
password = "password" ' Change this to your preferred password.

%>

Also some hosts have a special directory to put db files in, if so upload it to there and change the path in the conn.asp page accordingly.

The rest of the variables are pretty straight forward and there are notes in the conn.asp page explaining what to do, so I won't repeat myself.

The Program uses the w3Jmail, ASPemail, DundasMailer, ASPMail or CDONTS  component that comes with IIS Server, we here recommend w3Jmail if your host has it installed, if you have your own server you can obtain it from here http://www.dimac.net

Ok know that's all done all you have to do is in your browser go to the admin.asp page log in, (should have put your username and password in the conn.asp page)  and you will come to the page where there is a form you can paste onto your page's so people can subscribe and unsubscribe.

IMPORTANT - Make sure the folder that all the files are in is called listmail, which is what they were all in when you unzipped it.

Ok now play around with it add a few emails, send a email text or html, just play around with it till you see that it all works.

VARIOUS FUNCTIONS IN ADMIN

Home - Home is the page you will come to after you log in, this as the form code that you can copy/paste to your pages. It also shows you the total subscribers and the number that have subscribed that day.

Send Email - This is where you actually do the sending of your newsletters, updates so-forth. The From Email will automatically appear using your Admin Email, you can change this, but a word of warning most hosts require that the from email be the same domain as the domain you are sending from or it will not send. Subject is where you place the heading for your Message. And of course the Message area is where you place your message either in text or html, for html just do you newsletter in a html editor like FrontPage and copy/paste it, now with text if your using CDONTS then be warned to not go over 75 characters per line less CDONTS will break it to a new line. Remember to click html if sending html. The Test option allows you to send a email to the email you put in the variable "adminemail", this allows you to view the email as others will see it, before you send it to all your users. This allows you to fix any errors.

Add - This is where you can add emails to your List, it will first check that is a valid email if not will send you back to the page with a error try again, then it will check to see that it is not already there if it is it will send you back to the page tell you so, if passes all this it will then add it to your List.

Delete - Does the same checking as add except it will check if its there, if not send you back to the page saying not found, if passes will delete it.

View List - This is where you can view all the records in your database, it will show 50 records per page with the email, date entered and IP address of each record. You have also the ability to do multi deletions by checking the box beside each record you wish to delete. You should check this on a regular basis and delete all obvious invalid emails, although we do a valid check on emails before they go into the database its only a syntax check so emails like asdl@asdl.com can still get through. Hosts very much dislike receiving bounced emails back to there mail server.

Log Out - This is what you click once you have finished with Admin it destroys the password, username cookie on your computer. You should make it a habit of logging out instead of just closing.

Help - This Page.

If you have any problems or find a bug then visit our Forums or Help Desk.

 DOITASP.COM ListMail 2.0™

Copyright 2002 DOITASP.COM All Rights Reserved. 

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version.

All copyright notices must remain intact in the scripts and the outputted HTML.

You may not pass the whole or any part of this application off as your own work.

The Logo with link back to DOITASP.COM must remain visible when the pages are viewed.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 

No official support is available for this program but you may post support questions at our Forum
http://www.doitasp.com/forum  or how Help Desk http://www.doitasp.com/helpdesk   
Support questions are NOT answered by e-mail ever!

For correspondence or non support questions contact: - info@doitasp.com