The Real Soft Shopping Cart Form Mailer Read Me.

Current versions this readme file pertains to:

REGISTERED Version 1.1
DEMO Version 98b - Demo


These scripts are provided AS IS without warranty of any kind.

--------------------------------------------------------------
The formmail directory contains a popular FREEWARE UNIX CGI script 
that should work with your server(s). If you experience trouble 
with the scripts included in this download, send your modified script
to us as an email attachment so we can troubleshoot it on our end.
--------------------------------------------------------------
CartMail.CGI is a script sent to us by a user. It seems to work
OK on his site and it too is provided without warranty. Enjoy.
--------------------------------------------------------------


Different email servers and web servers can be configured in
such a way as to prevent the indluded forms from working 
properly. Since it is much more likely that your ISP has 
approved of and uses a particlar form to email mailer, you
will have better luck using your ISP's form to email program
than you will of CHANGING YOUR ISP'S SERVER CONFIGURATION.

It's funny, but MOST ISP's I've run into LIKE the way they 
have their email server configured. "CHANGING IT is NOT an 
option" is something I've heard MY ISP tell me over and over
and over.

The lesson here is this:

If your ISP has a Form to Email program running on their servers
complete with instructions on how to make your form work with it
THEN TRY THEIR OPTION FIRST!!	

Since these provided scripts assume certain things about the
server's configuration and if you have a stubborn web host 
you may not get them to re-configure just for you...

then use their mailer.

If you already HAVE an on-line ORDER FORM, just paste the 
following javascripts into your order form and you can use
your existing form as the PAY.HTML. (just remember to rename
it to PAY.HTML and put it in the cart directory.

HERE IS THE JAVASCRIPT FOR TURNING YOUR EXISTING FORM INTO 
A CART READY PAY.HTML CHECKOUT FORM. 

Put the following script between your <HEAD> and </HEAD> tags.

vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
= = = = = = = = = = = = = CUT'N PASTE BELOW THIS LINE  = = = = = = = = = = = 


<script language="JavaScript">
<!-- // hide script from older browsers

// Make sure you use the right frame name for .app. below.
// example. if your cart frame name is "order" then the next
// line would be "var orderTtl = parent.order.document.cart.GetTotal();"

var orderTtl = parent.app.document.cart.GetTotal();

if (orderTtl == 0)
{
	var ordered = "<nobr>Your Shopping Cart</nobr> <nobr>is empty.</nobr>";
	var empty = "yes";
} else {

// Make sure you use the right frame name for .app. below.
	var ordered = parent.app.document.cart.GetOrderString();
}

// end hiding -->
</SCRIPT>

= = = = = = = = = = = = = CUT'N PASTE ABOVE THIS LINE  = = = = = = = = = = = 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^


This is the script that displays the contents of your cart on your PAY.HTML
order form page. 

Put the following script where ever you want the contents of the cart to
appear. (Usually you will want it towards the top.)

vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
= = = = = = = = = = = = = CUT'N PASTE BELOW THIS LINE  = = = = = = = = = = = 

<H3>Your order is as follows:</H3>

<script language=JavaScript>
<!-- // hide script from older browsers

document.writeln("<table width=55%>");

if (orderTtl == 0)
{
	document.writeln("<td align=center><hr><font face=\"Verdana, Arial, Helvetica\" color=red size=3><b>");
	document.write(ordered); 
	document.write("</b></font><hr>");
	document.write("</td></tr></table>");
	document.write("<br><input type=\"button\" name=\"shopping\" value=\"To buy something, click this button\" onClick=\"back2shop()\"><font size=6><br><br><br><br><br><br><br><br><br></font>");
} else {

	document.writeln("<td align=right><font face=courier size=3 color=navy><hr>");
	document.write("<PRE>" + ordered); 
	document.write("</PRE></font><hr>");
	document.write("</td></tr></table>");
	document.write("<br><input type=\"button\" name=\"shopping\" value=\"To make corrections, click this button\" onClick=\"back2shop()\">");
	document.write("<br><br>Otherwise, proceed with your order information...<br>");
}

// end hiding -->
</SCRIPT>


= = = = = = = = = = = = = CUT'N PASTE ABOVE THIS LINE  = = = = = = = = = = = 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

For additional (constantly updated) information about this topic see our FAQ page
at http://www.RealSoft.com/FAQ/email.html

Thanks for your interest in our cart!