Support Manual - Dansie Cart Form Examples

This Javascript . . .

<SCRIPT language="JavaScript1.2">
function Summary()
{
SummaryWindow=window.open("http://www.dansie.net/cgi-bin/scripts/cart.pl?summary", "Summary", "width=300,height=200,titlebar=no,status");
}
document.write('<FORM><INPUT TYPE=BUTTON VALUE="Cart Summary" OnClick="Summary();"></FORM>');
</SCRIPT>

Would Create a Button like this . . .

This button will properly demonstrate when you are connected to the internet.

4 Search Engine Forms (for flat file database):

Dansie Shopping Cart version 3.0 has been upraded with new powerful search features. Make sure you add Database Variable #25 and #26 to your vars.dat file to take advantage of these new powerful features. Also, make sure you have lang.dat #91 through 96 and 149 and 150 from the 3.0 lang.dat file. If you wish to use the 3.0 search engine, then set Database Variable #25 in your vars.dat file to "3.0". If you want to remain with the old 2.0 search format, then just leave DBV#25 blank or set it to "2.0".

The form below shows you how the Dansie Shopping Cart can search your flat-file databases for the products. Copy and paste it into one of your web pages. Make sure you change the FORM ACTION to the URL to the cart.pl script on your site. It will be the same URL as you have in Host Variable #1 in your vars.dat file.

The location of your database file is either in the same directory as your vars.dat file (default), or a different directory that you set in Database Variable #1 in your vars.dat file. With the Mall Version database files need to be located in the merchants directory and don't forget to use the "merchant" tag like so:
<INPUT TYPE=HIDDEN NAME="merchant" VALUE="MerchantName">
Feel free to name your database files whatever you like and use as many as you need.

You will find 7 form variables below. db, category, search, method, price, display and return. The only variable that is required is db because you must tell the script which file to search. The rest are optional. If you do not define category, then all categories in the database file will be searched. If you do not define search (with key words) then all items will be displayed. By using the price variable you can search for specific price ranges. If you omit price then all items can be matched regardless of their price. The method variable allows your shoppers to search for "any words", "all words" or a "phrase". If you omit the method variable the default search method will be "any words". The display variable allows your shoppers to control how many items are displayed per page. The return variable allows you to tell the cart what URL to take a shopper to when they click the "Continue Shopping" button. If you omit this variable, the cart will use the URL you put in Database Variable #23 and if you have that blank, the return URL will be a link right back to the database display they just came from.

Foreign character search compatibility: If you have characters in your database such as any of these:
S¹s¹ŸÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜY´àáâãäåçèéêëìíîï

The cart will return a match for words with those characters in them even if the shopper didn't type in the exact character. For example, someone searches for "El Nino" but you have "El Niño" in your product database, the cart will match it with or without the tilde "~". The reverse is true too. If someone searches for "Alegría" and you have "Alegria" in your database without the accent, the cart will still match it.

HREF links can be used just as well. Here are some examples:

http://www.dansie.net/cgi-bin/scripts/cart.pl?db=stuff.dat
The only variable passed is db so all items are returned.

http://www.dansie.net/cgi-bin/scripts/cart.pl?db=stuff.dat&category=Books
category is defined so the script only returns items in that category.

http://www.dansie.net/cgi-bin/scripts/cart.pl?db=stuff.dat&category=Books&search=Boy+Scout
Now "Boy Scout" is the key word search criteria so the script only returns matches for that in the "Books" category. Notice that you use plus signs (+) for spaces inside URLs.

This HTML . . .

<FORM METHOD=POST ACTION="http://www.dansie.net/cgi-bin/scripts/cart.pl"> <INPUT TYPE=HIDDEN NAME=db VALUE="stuff.dat"> <INPUT TYPE=HIDDEN NAME=return VALUE="http://www.dansie.net/search_form_source.html"> Category: <SELECT NAME=category> <OPTION VALUE="">All Categories <OPTION>Books <OPTION>Clothing <OPTION>Hotel </SELECT> <BR> Search For: <INPUT TYPE=TEXT NAME=search SIZE=30 MAXLENGTH=30> <BR> Method: <SELECT NAME=method> <OPTION VALUE="any_words">Any Words <OPTION VALUE="all_words">All Words <OPTION VALUE="phrase">As A Phrase </SELECT> <BR> Price Range: <SELECT NAME=price> <OPTION VALUE="">Any price <OPTION VALUE="10">Less than $10 <OPTION VALUE="10-20">$10 to $20 <OPTION VALUE="20-10000">$20 to $10000 </SELECT> <BR> Items per page: <SELECT NAME=display> <OPTION VALUE="5">5 Items per page <OPTION VALUE="10">10 Items per page <OPTION VALUE="25">25 Items per page <OPTION VALUE="50">50 Items per page </SELECT> <BR> <INPUT TYPE=SUBMIT VALUE="Search!"> </FORM>

Creates this form . . .

5 Helpful JavaScript examples:

Required Fields:
This requires the use of JavaScript. Make sure to change the ACTION attribute in the FORM tag of this form to match the full URL to where your cart.pl script is located. It needs to match Host Variable #1 in your vars.dat file exactly. If a shopper has JavaScript enabled in their browser, the two text fields will be required. If they don't, the fields wont be required, but the form will still work. Try clicking the "Order Now!" button below without entering a first or last name. It will prevent you from moving to the next page until you enter those required fields.

Copy and paste the JavaScript function into the top of your document.
Put NAME="form1" in your FORM tag.
Use the purple tags below in place of your submit button.

This Javascript and HTML . . .

<SCRIPT LANGUAGE="JavaScript">
   function RequiredFields()
   {
      if (!document.form1.custom3.value ||
          !document.form1.custom4.value
         )
      {
         alert("Please enter all required fields.");
      }
      else
      {
         document.form1.submit();
      }
   }
</SCRIPT>

<FORM NAME="form1" METHOD=POST ACTION="http://www.dansie.net/cgi-bin/scripts/cart.pl">

<B>
Black Leather purse with leather straps<BR>
Price: $20.00<BR>
</B>

<INPUT TYPE=HIDDEN NAME=name     VALUE="Black Leather Purse">
<INPUT TYPE=HIDDEN NAME=price    VALUE="20.00">
<INPUT TYPE=HIDDEN NAME=sh       VALUE="1">
<INPUT TYPE=HIDDEN NAME=img      VALUE="purse.jpg">
<INPUT TYPE=HIDDEN NAME=img2     VALUE="purse_large.jpg">
<INPUT TYPE=HIDDEN NAME=return   VALUE="http://www.dansie.net/demo.html">
<INPUT TYPE=HIDDEN NAME=custom1  VALUE="Black Leather purse with leather straps">
<INPUT TYPE=HIDDEN NAME=custom2  VALUE="First and last name to be embroidered on purse:">
Name to be embroidered on purse:<BR>
First Name: <INPUT TYPE=TEXT NAME=custom3 SIZE=20 MAXLENGTH=30><BR>
Last Name: <INPUT TYPE=TEXT NAME=custom4 SIZE=20 MAXLENGTH=30><BR>

<SCRIPT LANGUAGE="JavaScript">
document.write('<INPUT TYPE=HIDDEN NAME="add" VALUE="1">\n<INPUT TYPE=BUTTON VALUE="Order Now!" OnClick="RequiredFields()";>');
</SCRIPT>
<NOSCRIPT>
<INPUT TYPE=SUBMIT NAME="add" VALUE="Order Now!">
</NOSCRIPT>

</FORM>

Creates this form . . .