"Fly Pages"
July 3, 2000
-------------

Notes:
1)  Also see the parsed HTML document in the DOCS directory!
2)  Note: As of version 4.0i, the token %%scripturl%% is often used instead
of agora.cgi in href urls, and %%scriptposturl%% for method=post forms.

As of version 3.2, there is a new way to display cart contents.  If the
system detects display_cart=1 (or dc=1) in the URL or in POST form data
then the cart will be displayed.  Formerly syntax such as

  <A HREF="agora.cgi?add_to_cart_button.x=yes&%%href_fields%%&viewOrder=yes">
  <FONT FACE=ARIAL>View Cart</FONT>

was used to view the cart.  With the simplified view cart code it becomes

  <A HREF="agora.cgi?dc=1&%%href_fields%%"><FONT FACE=ARIAL>View Cart</FONT>

This simplifies the HTML and prevents false error messages about reloaded
pages.  

The producPage.inc file options have changed considerably since agora.cgi
was first released.  Agorascript has greatly enhanced the ability to
display products.  With the ppinc= option, there are many ways to mix and
match the display of product information.

Here are some of the files available for displaying products "on-the-fly":

  productPage.inc       current standard display, 2 across, agorascript
  productPage-1a.inc    early standard, no agorascript, 1 item across
  productPage-2a.inc    agorascript, 2 items across, same as standard
  productPage-2a0.inc   agorascript, 2 items across, another way
  productPage-2a1.inc   agorascript, 2 items across, yet another way

Here are a couple other files to look at:
  productPage-agorascript_example.inc   agorascript example of table format
  productPage-search.inc                used in search displays
  productPage-search2.inc               ditto

*******************************************************

This file describes the HTML for the dynamically created product pages
that can be designed to the users tastes. Tokens are used here to display
the values generated from the database and the script. Simply place the
appropriate tokens in the customizable productPage.inc HTML file and
the fields will appear there on your pages!

The following tokens are REQUIRED! Please take a look at how they are used
below, and be careful not to break them when you edit the file.

%%cartID%%
%%itemID%%
%%make_hidden_fields%%
%%scriptURL%%

The following fields are optional and can be used if desired. Remember, the
token called %%optionFile%% will display all of the HTML from the option
file assigned to the product being displayed.

%%description%%
%%image%%
%%name%%
%%optionFile%%
%%price%%
%%shipping%%

The following fields are optional, they are the user defined fields set in
the Store Manager.

%%userFieldOne%%
%%userFieldTwo%%
%%userFieldThree%%
%%userFieldFour%%
%%userFieldFive%%

#################################################

Sample productPage.inc file shipped with 3.0a:

<TR>
<TD COLSPAN = "3"><HR></TD>
</TR>
<TR WIDTH="550">
<TD ALIGN="CENTER" WIDTH="160" VALIGN="MIDDLE">
<FONT FACE="ARIAL" SIZE="2">
<FORM METHOD = "post" ACTION = "%%scriptURL%%">
%%make_hidden_fields%%
<BR>
%%optionFile%%
<BR>
<P>
<!--BEGIN SELECT QUANTITY BUTTON-->
<TABLE>
<TR ALIGN="CENTER">
 <TD VALIGN="MIDDLE"><INPUT TYPE="TEXT" NAME="%%itemID%%" SIZE="3"
 MAXLENGTH="3" VALUE="1"></TD><TD VALIGN="MIDDLE"><INPUT TYPE="IMAGE"
 NAME="add_to_cart_button" VALUE="Add To Cart"
 SRC="%%URLofImages%%/add_to_cart.gif" BORDER="0">
 </TD>
</TR>
</TABLE>
<!--END SELECT QUANTITY BUTTON-->
</TD>
<TD ALIGN="CENTER" WIDTH="150">%%image%%</TD>
<TD WIDTH="265">
<FONT FACE="ARIAL" SIZE="2">
<b>%%name%%</b>
<br>
%%description%%
<br>
<font color="#FF0000">%%price%%</font>
<br>
</FONT>
</TD>
</FORM>
</TR>
<TR>
<td>&nbsp;</td>
<td>&nbsp;</td>
<td align="right">
<A HREF="agora.cgi?add_to_cart_button.x=yes&%%href_fields%%&viewOrder=yes">
<FONT FACE=ARIAL>Check Out</FONT>
</A>
</TD>
</TR>