This section is intended for site designers.

Overview: This section covers the top part of the Configuration Table, which is primarily the selection of programs used to handle the catalog.  For sites w/o a catalog just enter 'N/A' in each of the sections. Note: your page may look slightly different as professional web developers have the option of changing the look, but not the function, of this page.

Note: When the site is configured the following file is added to either to document root of the site or the sub-directory under the site's document root which will be the top of the content system index.stm and it need to contain only one of following lines
{!--#include virtual="/cgi-bin/cNc/showPage.plx?db=databaseName"--}

{!--#include virtual="/cgi-bin/cNc/showPage.plx?db=databaseName&pid#"--}
where # is the page ID of the home page.

• Domain Name:
  
  • The fully qualified domain name of the site without HTTP:// in front of it or a trailing '/'
  • An IP address is used when a domain actually exists on another server but will be moved here eventually. However, it will require going back and changing reverences to use the domain when the site moves to domain based hosting.
• Client's Email Address: this is the email address from which order status notifications will come.  For sites which use PayPal, this must be the address which PayPal recognizes as the site owner's.  (e.g., info@csz.com)
• Sub-directory: {optional} if the system is setup to be in a sub directory under the site's document root directory, place the name of the directory here.  Note: it is up to the site designer to create this sub-directory.
• Prog. to List Categories: this program lists of the categories in the catalog. Use:
  
  • /cgi-bin/sc-v4/catlist2.pl?client=|.dbname.| to display a complete tree.
  • /cgi-bin/sc-v4/catprodC.pl?client=|.dbname.| to display only the top level categories.
• Prog. to List Products in Categories
  • Actually lists first all the categories under the specified category and then the products under that category.
  • See Category Help page for how the listing are displayed
  • See Products and Product Line Templates section for how product listings are displayed.
  • /cgi-bin/sc-v4/catprodC.pl is the current standard.  Special purpose programs can be substitute for this.
• Program to Display Products:
  
  • /cgi-bin/sc-v4/proddisp.pl is the current standard.
  • This program will try to find a template page called either product.tmp or product.tpl in the site's document root.  If neither is present it will use the catalog shell (see next help section for an explanation of that).
  • The following tags are suppressed: |.pContent:#.|, |.SC_CATBODY.|, and |.SC_CATNAME.|.
  • The program uses the |.SC_CONTENT.| tag to determine where to list the product(s) (either standalone or parent and children). The following tags are suppressed in the Product Line (they can be used in the page template however): |.PrGraphic.|, |.PrSpare1.|, |.PrSpare2.|, and |.ProdPage.|.  It is assumed that they will be used in the main body of the template.
  • If a field is configured as a graphic field the system will automatically build a proper HTML image tag  (e.g., {img src='/cNcgraphics/Product_1_PrSpare2.gif'}) in place of the field name if the contents of the field in the database ends in ".png", ".jpg", ".jpeg" or ".gif" (i.e., it is a valid image type).   This means that if the data in the table is not the address of an image, the browser will not display a missing image tag).  Note: if you want to have the contents displayed without and image tag being created around the data use  /cgi-bin/sc-v4/proddisp.plx In practice this means the maintainer will always supply and image with each product if this program is used to avoid the missing image tag.
• Secure Buy Page: this is the program on our secure server which will be used to manage the purchase of product.  The standard is csb4.pl as of this writing.
• Called after Buy: this can either be a program or a static web page.
  
  • It needs to be the full URL (e.g., begin with https://) since an warning will be displayed if it is not on the secure server. 
  • If the site plans to support order tracking you can use: https://secure2.csz.com/cgi-bin/cNc/thanks.plx?db=|.dbname.|&oid=|.OID.|
    • This program will look for either thanks.tmp or thanks.tpl in the site's document root and use that as the template for the page.  If neither template file exists it will use a simple internal template.  Although the template files exist in document root, they should not contain external references (e.g., graphic files or style sheet files until special arrangements are made with the hosting company as to the file's location on the server and the apparent path from the secure server's document root. 
    • This program supports a limited set of tags, including some special purpose ones: |.pContent:#.|, |.OrderCode.| (a slighly obscured version of the Order Number), |.OEmail.| (the email address which has been configured in). |.OrderDate.| (the date the order was received), |.OIPOC.| (who ordered the product), |.SIPOC.| (who gets the merchandize), |.BillingAddress.|, |.ShippingAddress.|, |.OOID.| (order number), |.SINum.| {shipment number, normally '1'), |.ShipMethod.| (how its being shipped, note if the site uses the simple single method this will read 'by table'), |.SIShipCost}.| (cost of the shipment as reflected in the shipment table, may be $0.00),|.OIShipCost.| (shipment cost as reflected in the order table, normally this is the most usefull), |.OITotal.| (total cost of the order), |.OICost.| (order cost before tax and shipping), |.SITax.| (tax if any), |.SITotSum.| (table containing the cost lines for a shipment, |.OITotSum .| (table containing the cost lines for the entire shipment).
• Shop Cart Prog: program called when a buy button is pressed.  The current standard is: doscartDisQ.pl 
  • This program supports sites which have inventory tracking as well as those that do not. It also supports sites with child products.
    • Unless a flag in the site's product configuration file specifies otherwise, each product listed in the shopping cart will link back to the Category/Product list page which contains that product.  In the case of child products, the page which holds the parent product.
    • In site's with inventory management, the program will attempt to remove sufficient product from inventory and place it in the shopping cart on an Add or adjust the inventory in the case of an Update.  If less than the requested product is available, all available product will be placed in the cart and a warning message displayed. 
  • The site processes the Add or Update, adjusting each product's inventory as needed.
  • It also updates the timer in the shopping cart. 
  • This program removes any carts which have not been touched in more than 6 hours unless the site uses PayPal in which case it will wait 18 hours.  If the system tracks inventory, the items in abandoned carts will be returned to inventory.
  • After adjusting the contents of the cart, it displays the lines of a shopping Cart followed by the pre-shipping total costs. When a destination is specified, a tax line is added.
    
    • If the site  has taxable products it will ask for the shipping destination. Once this is selected it will display a button to go to checkout (/std-img/checkout.gif).
    • It will always display a Update quantity button (i.e., /std-img/upquant.gif) and a continue shopping button (/std-img/cont_shop.gif). 
    • If the site supports discounts it will display a box to accept discount code with an image to its left (/std-img/DiscountRequest.gif). When a code is entered or changed the cart will refresh and if applicable a line indicating the applied discount will appear. An error will be displayed if an invalid discount code is entered.
  • The parts making up the displayed shopping cart placed in |.SC_CONTENT.| tag in the catalog template.  See the next page for information about the template.
    
    • The entire cart is contained in a table with the class shopcart.
    • The line: 'To remove an item change the quantity to 0 and click Update' is in a table row with a class name of sc-1.
    • The title row above the shopping carts detail rows has a class of sc-h.
    • Each row in the cart has a class of sc-4.  This same class is used to display the Tax and discount lines.
    • The Order Total is in a table row with class sc-5
    • The order destination line is also in a table row sc-4.  Note if the value is changed. form auto-resubmits so that taxes can be adjusted, if javascript is blocked a update destination button is available (/std-img/chgstate.gif)

Go to top

May you enjoy peace and growth.