$default_setup_file = 'outlet.setup';

Database Category and Search Result Tables

 

@vertical_numbers | @display_numbers | %fields_array

$table_border | $spc_width | $spc_height

$table_title

$table_width

$item_separator

$max_items

$display_category

Image Display

 

$img_spacing

$img_border | $img_padding

$outer_clr_width | $outer_img_clr

$inner_clr_width | $inner_img_clr

View/Modify Tables

 

@modify_display_numbers | %modify_fields_array

$modify_table_border | $modify_spc_width | $modify_spc_height

$data_file = 'outlet.data';

$global_page_title = 'RDC Software';

@company = (

  'RDC Software',
  'Route 3, Box 29B',
  'Grapeland, Texas 75844',
  'Phone: 936.687.2400',
  'Fax:   936.687.9057'

); # DO NOT REMOVE - terminates @company

$currency = '$';

$frontpage_file = 'outlet_frontpage.html';

$frameset_file = 'Frameset.html';

      Frameset.html
      Frameset_banner.html

$duplicate_buttons = '1';

$button_1_txt = 'View Cart';     # Go to View/Modify table
$button_2_txt = 'Front Page';    # Go to Store's Front Page
$button_3_txt = 'Previous Page'; # Go to Previous Category or HTML Page
$button_4_txt = 'Order Form';    # Go to Order Form
$button_5_txt = 'Add to Cart';   # Add item to shopping cart

$add_cart_button = 'ac.Add_to_Cart.gif:BORDER="0" WIDTH="63" HEIGHT="15"';

$return_link_url = 'http://www.YourDomain.xxx';

$return_link_title = 'Home Page';

$email_link_url = "WebStore\@YourDomain.xxx";

$email_link_title = 'Mail to: '.$email_link_url;

@field_names = (

# Field Name     Dbase Field

  'Color',       #   0
  'Size',        #   1
  'Shipping',    #   2
  'Item',        #   3
  'Category',    #   4
  'Price',       #   5
  'Name',        #   6
  'Description', #   7
  'Image',       #   8
  'Id',          #   9

); # DO NOT REMOVE - terminates @field_names

$category_fld_num = '4';

$item_fld_num = '3';

$price_fld_num = '5';

$image_fld_num = '8';

0|0|Item|Category|Price|Name|Description|Image|Id
First Color list in %DD1_FIELDS - First Size list in %DD2_FIELDS

6|3|Item|Category|Price|Name|Description|Image|Id
Last Color list in %DD1_FIELDS - Last Size list in %DD2_FIELDS

|3|Item|Category|Price|Name|Description|Image|Id
No Color list - Last Size list in %DD2_FIELDS

6||Item|Category|Price|Name|Description|Image|Id
Last Color list in %DD1_FIELDS - No Size list

||Item|Category|Price|Name|Description|Image|Id
No Color list - No Size list

%DD1_FIELDS = (

  '0'   =>  [ 'Blue',        'Black',        'Navy',        'Red' ],
  '1'   =>  [ 'Light Blue',  'Light Brown',  'Red',         'White' ],
  '2'   =>  [ 'Blue/Black',  'Green/Black',  'Pink/Black',  'Red/Black' ],
  '3'   =>  [ 'Cadetblue',   'Coral',        'Cornsilk',    'Crimson' ],
  '4'   =>  [ 'Dark Blue',   'Dark Cyan',    'Dark Gray',   'Dark Green' ],
  '5'   =>  [ 'Brown',       'Gray',         'Green',       'White' ],
  '6'   =>  [ 'Gold',        'Goldenrod',    'Gray',        'Green' ],

); # DO NOT REMOVE - terminates %DD1_FIELDS.

%DD2_FIELDS = (

  '0'  =>  [ '15 x 32',      '15 x 34',      '15 x 36',      '15 x 38',
             '15 1/2 x 32',  '15 1/2 x 34',  '15 1/2 x 36',  '15 1/2 x 38',
             '16 x 32',      '16 x 34',      '16 x 36',      '16 x 38',
             '16 1/2 x 32',  '16 1/2 x 34',  '16 1/2 x 36',  '16 1/2 x 38',
             '17 x 32',      '17 x 34',      '17 x 36',      '17 x 38',
             '17 1/2 x 32',  '17 1/2 x 34',  '17 1/2 x 36',  '17 1/2 x 38',
             '18 x 32',      '18 x 34',      '18 x 36',      '18 x 38',
             '18 1/2 x 32',  '18 1/2 x 34',  '18 1/2 x 36',  '18 1/2 x 38',
             '19 x 32',      '19 x 34',      '19 x 36',      '19 x 38' ],

  '1  =>'  [ 'Small',    'Medium',  'Large',       'X-Large',      'XX-Large' ],
  '2  =>'  [ 'Small',    'Medium',  'Large',       'X-Large',      'XX-Large',  'XXX-Large' ],
  '3  =>'  [ 'Regular',  'Tall',    'Extra-Tall',  'Big Regular',  'Big Tall' ],

); # DO NOT REMOVE - terminates %DD2_FIELDS.

$password_file = 'Access.Restrict.Phone.setup';

$def_username = "demo\@YourDomain.xxx";
$def_password = 'demo1234';

$deny_access_url = 'http://www.YourDomain.xxx/Web_store/Html/denied.html';

$client_file = 'Access.Client.Phone.setup';

$retrieve_file = 'Client.Retrieve.Phone.setup';

$client_delete_age = '24';

@client_fields = (

# Form Name        Field Label

  'nameFirst',     #  First Name
  'nameLast',      #  Last Name
  'name',          #  Name
  'company',       #  Company
  'addr1',         #  Address 1
  'addr2',         #  Address 2
  'addr3',         #  Address 3
  'city',          #  City
  'province',      #  Province
  'state',         #  State
  'country',       #  Country
  'zip',           #  Zip/Postal Code
  'phone',         #  Phone
  'fax',           #  Fax
  'email',         #  E-mail Address
  'shpNameFirst',  #  Ship First Name
  'shpNameLast',   #  Ship Last Name
  'shpName',       #  Ship Name
  'shpAddr1',      #  Ship Address 1
  'shpAddr2',      #  Ship Address 2
  'shpAddr3',      #  Ship Address 3
  'shpCity',       #  Ship City
  'shpProvince',   #  Ship Province
  'shpState',      #  Ship State
  'shpCountry',    #  Ship Country
  'shpZip',        #  Ship Zip/Postal Code
  'shpPhone',      #  Ship Phone
  'shpIns',        #  Shipping Instructions
  'password1',     #  Password
  'ship',          #  Shipping Method
  'tax',           #  Sales Tax

); # DO NOT REMOVE - terminates @client_fields

$usr_fld_name = 'email';

$pwd_fld_name = 'phone';

$access_attempts = '3';

$admin_file_email = '';

$reseller_data_file = 'Resellers.data';

$reseller_file = 'Form.Reseller.setup';

$reseller_spreadsheet = 'Resellers.data.txt';

%RESELLER_FIELDS = (

# KEY      Field Name   E-mail Label        Dbase Field

  '00' => ['rsc',       'Reseller Code'],   #   0
  '01' => ['name',      'Name'],            #   1
  '02' => ['company',   'Company'],         #   2
  '03' => ['addr1',     'Address 1'],       #   3
  '04' => ['addr2',     'Address 2'],       #   4
  '05' => ['city',      'City'],            #   5
  '06' => ['state',     'State'],           #   6
  '07' => ['country',   'Country'],         #   7
  '08' => ['zip',       'Zip/Postal Code'], #   8
  '09' => ['phone',     'Phone Number'],    #   9
  '10' => ['fax',       'Fax Number'],      #  10
  '11' => ['email',     'E-mail Address'],  #  11
  '12' => ['urlpage',   'Web Page URL'],    #  12

); # DO NOT REMOVE - terminates %RESELLER_FIELDS

@reseller_include_files = (

#  'include.reseller.txt',
#  'include.reseller.category_page.txt',
#  'include.reseller.item_page.txt',

); # DO NOT REMOVE - terminates @reseller_include_files

#                            Dbase Field    Field Label

$rsc_name_fld_num    = '2';  #  2           Company
$rsc_mail_fld_num    = '11'; # 11           E-mail Address
$rsc_urlpage_fld_num = '12'; # 12           Web Page URL

$merchant_file = '';

• Move the /Library sub-directoy to an area which can not be accessed using a web browser or place the /Library sub-directoy under HTACCESS.
• Rename the /Library sub-directoy defined in $libr_directory in WebStore's global setup file, ws_global.setup.
• Rename the merchant file.
  
  
• Store the merchant file under a sub-directory:
  1. Create a directory under the /Library sub-directory
  2. Store the merchant file under the newly created sub-directory
  3. Set $merchant_file = 'sub-directory/merchant.xxxx.cfg';

$country_file = 'outlet.state_country.setup';

$pre_form_file = 'Pre.OrderForm.setup';

%form_files = (

# Not using real-time processing:
#
# KEYS     zero - Filename                        one - Label
  '10' => ['OrderForm.CreditCard.setup',         'Credit Card'],
  '11' => ['OrderForm.Check.setup',              'Personal Check - US citizens'],
  '12' => ['OrderForm.FaxMail.setup',            'Fax or Mail your order'],
# '13' => ['OrderForm.CreditFaxMail.setup',      'Credit Card, Fax, or Mail'],
# '14' => ['Demo.OrderForm.CreditFaxMail.setup', 'Demo: Credit Card, Fax, or Mail'],


# Authorize.Net real-time processing:
#
# '20' => ['OrderForm.AuthorizeNet.CreditCard.setup',      'Credit Card'],
# '21' => ['OrderForm.AuthorizeNet.Check.setup',           'Personal Check - US citizens'],
# '22' => ['Demo.OrderForm.AuthorizeNet.CreditCard.setup', 'Demo Authorize.Net: Credit Card'],


# Surepay real-time processing:
#
# '30' => ['OrderForm.Surepay.CreditCard.setup',      'Credit Card'],
# '31' => ['OrderForm.Surepay.Check.setup',           'Personal Check - US citizens'],
# '32' => ['Demo.OrderForm.Surepay.CreditCard.setup', 'Demo Surepay: Credit Card'],
# '33' => ['Demo.OrderForm.Surepay.Check.setup',      'Demo Surepay: Personal Check'],

); # DO NOT REMOVE - terminates %form_files

$demo_form_file = 'Demo.OrderForm.CreditFaxMail.setup';

• Set $demo = '' in ws_global.setup.
• Access WebStore using ws400CS.cgi?demo=Y to place a test order.
  Administrative and client confirmation e-mail messages for submitted test orders are delivered to the e-mail address entered on the demonstration order form.
• Once all modifications have been made and reviewed for accuracy, rename the demonstration order form file to it's intended filename and store in an array in %form_files.
   
  When demonstration mode is activated, WebStore adds the demo form file to %form_files, immediately after the array with the most significant KEY, labeling the file Demonstration Form File. The demonstration order form becomes $form_files{13} in the WebStore distributions.
   
  WebStore adds .setup to the filename listed in $demo_form_file if the filename does not end in .setup.
   
  Setting $demo_form_file = '' disables the use of the demonstration forms file.
   
   
  Index

  ---

   

  $minimum_order = '25.00';

  $minimum_order is the minimum order subtotal allowed before WebStore will print the order form.
   
  $minimum_order is a fixed decimal number. Do not include a dollar sign or commas in $minimum_order.
   
  Setting $minimum_order = '' disables minimum order checking. WebStore's order form is available when the client's shopping cart contains one item.
   
   
  Index

  ---

   

  %DISCOUNT = (
  
           # Subtotal Discount       Discount     Subtotal Value
   '1' => ['Subtotal Discount',
           ' 75.00:0',           #   0%           $75.00 or less
           '100.00:.10',         #  10%           $75.01 - $100.00
           '125.00:.125',        #  12.5%        $100.01 - $125.00
           '150.00:.15',         #  15%          $125.01 - $150.00
           '175.00:.175',        #  17.5%        $150.01 - $175.00
           '175.01:.20',         #  20%          $175.01 or more
          ],
  
  
           # Quantity Discount       Discount     Items Purchased
  # '2' => ['Quantity Discount',
  #         ' 2:0',               #   0%           1 -  2
  #         ' 6:.10',             #  10%           3 -  6
  #         '12:.125',            #  12.5%         7 - 12
  #         '24:.15',             #  15%          13 - 24
  #         '36:.175',            #  17.5%        25 - 36
  #         '37:.20',             #  20%          37 or more
  #        ],
  
  ); # DO NOT REMOVE - terminates %DISCOUNT

  %DISCOUNT lists percentage discounts for client orders. Percentage discounts are based on the order's subtotal value or on the total number of items purchased.
   
  $DISCOUNT{1} lists order subtotal range values. Subtotal discounts are enabled in the WebStore distributions.
  $DISCOUNT{2} lists item quantity range values.
   
  Element zero of $DISCOUNT{1} and $DISCOUNT{2} is the field label printed to the client confirmation HTML page and to e-mail messages.
   
  The remaining elements of $DISCOUNT{1} and $DISCOUNT{2} are colon-delimited discount range values. Range values must be listed in ascending order.
   
  For $DISCOUNT{1} and $DISCOUNT{2}, the percentage discount is to the right of each colon. The value of percentage discount is a fixed decimal number. For example, .15 equals a 15% discount.
   
  For $DISCOUNT{1}, the value to the left of each colon is an order subtotal value. The percentage discount increases when the order's subtotal is greater than the subtotal value listed in an element of $DISCOUNT{1}.
   
  For $DISCOUNT{2}, the value to the left of each colon is an item quantity value. The percentage discount increases when the quantity of items ordered is greater than the item count listed in an element of $DISCOUNT{2}.
   
  Remove the discount array you will not be using or place # (pound signs) in column one of each element of the entire array ($DISCOUNT{1} or $DISCOUNT{2}), including the closing ] (square bracket).
   
  If you do not use discounts, %DISCOUNT may be removed from this file or you may place a # (pound sign) in column one for each line in the entire hash of arrays.
   
  $DISCOUNT{1} takes precedence over $DISCOUNT{2} when both arrays are defined. WebStore will calculate subtotal discounts according to the elements present in $DISCOUNT{1}, disregarding $DISCOUNT{2} entirely.
   
  To disable discounts, add # (pound signs) in column one of each element in $DISCOUNT{1} and $DISCOUNT{2}, including the closing ] (square bracket) or remove $DISCOUNT{1} and $DISCOUNT{2} from %DISCOUNT, setting %DISCOUNT = ();.
   
   
  Index

  ---

   

  %SHIPPING = (
  
  	# Determines type of shipping
  	# Database Field, Handling, Free Shipping
  	'1' => ['',   '',   ''],
  
  
  	# Domestic Shipping
  	'2' => ['319',  '10','11','12','13'],
  
  
  	# Universal Subtotal Ranges
  	'3' => [                 #  Order Subtotal        Shipping Charged
  	        '100.00:6.95',   #    $0.01 to $100.00     $6.95
  	        '150.00:9.95',   #  $100.01 to $150.00     $9.95
  	        '200.00:12.95',  #  $150.01 to $200.00    $12.95
  	        '300.00:15.95',  #  $200.01 to $300.00    $15.95
  	        '300.01:18.95',  #  $300.01 & up          $18.95
  	       ],
  
  
  	# Shipping Methods
  	# 10  UPS Ground or Priority Mail:   $3.95 plus  3% of order's subtotal
  	# 11  2nd Day Air:                  $12.00 plus  4% of order's subtotal
  	# 12  Standard Next Day Air:        $18.00 plus  5% of order's subtotal
  	# 13  Alaska & Hawaii:              $12.00 plus  4% of order's subtotal
  	# 14  Canadian Orders:              $10.00 plus 17% of order's subtotal
  	# 15  International Orders:         $20.00 plus  8% of order's subtotal
  
  	'10' => ['UPS Ground or Priority Mail', '3.95',   '.03'],
  	'11' => ['2nd Day Air',                 '12.00',  '.04'],
  	'12' => ['Standard Next Day Air',       '18.00',  '.05'],
  	# State Specific Shipping Method
  	'13' => ['Alaska & Hawaii',             '12.00',  '.04',  '11:21'],
  	# Country Specific Shipping Method
  	'14' => ['Canadian Orders',             '10.00',  '.17',  '132'],
  	'15' => ['International Orders',        '20.00',  '.08'],
  
  ); # DO NOT REMOVE - terminates %SHIPPING

  %SHIPPING is a hash of arrays listing all shipping variables.
   
  %SHIPPING array configurations and their explanations in this file are for Subtotal Range Shipping.
   
  Four types of shipping are available in WebStore.

  Example:  $SHIPPING{1}[2]
  
   {1}  An array's KEY value. KEY values will be referenced by their
        numeric value in the explanations below (0, 1, 2, etc.).
  
   [2]  An array's element reference. Element numeric values will
        be spelled in the explanations below (zero, one, two, etc.)
  
        Specific arrays will be referenced as $SHIPPING{1}.
  
        A specific element within a specific array will be referenced
        as $SHIPPING{1}[2].

  Arrays 1, 2, and 10 must exist in %SHIPPING. If any of these arrays are not present in %SHIPPING or the value of their KEY (1, 2, 10) is altered, shipping is disabled in WebStore.
   
  Numeric array KEYS allow the Webstore script to sort the shipping methods in ascending order for printing to the client's web browser.
   
  Arrays 0 and 3 - 9 are reserved and can not be used.
   

  Array 1 - $SHIPPING{1}

  $SHIPPING{1} must exist in %SHIPPING. If $SHIPPING{1} is removed or the numeric value of it's KEY (1) is altered, shipping is disabled in WebStore.
   
  $SHIPPING{1} consists of the following elements:

  
   KEY     zero  one     two
   '1' => ['',   '3.50', '150.00'],

  zero		Database Shipping Field
  		Element zero is not used for Subtotal Range Shipping and must be set to ''.
  one		Handling Charge
  		Element one is the labor charge for packaging an order for shipment.
  		Setting element one = '' disables the addition of a handling charge.
  		Do not include a dollar sign or commas in element one. Element one is a fixed decimal number.
  two		Free Shipping
  		When the value of an order's subtotal is greater than the value listed in element two, no shipping or handling is charged for the order. The shipping drop down select element is not printed to the client's web browser.
  		Setting element two = '' disables free shipping checks, all orders pay shipping.
  		Do not include a dollar sign or commas in element two. Element two is a fixed decimal number.

   
   
  %SHIPPING

  ---

   

  Array 2 - $SHIPPING{2} - Domestic Shipping

  $SHIPPING{2} must exist in %SHIPPING. If $SHIPPING{2} is removed or the numeric value of it's KEY (2) is altered, shipping is disabled in WebStore.
   
  $SHIPPING{2} consists of the following elements:

  
   KEY     zero    one   two   three four
   '2' => ['319',  '10', '11', '12', '13'],

  zero		Country Code
  		Your 3 digit country code from %countries in outlet.state_country.setup.
  one, two, three, etc.     Domestic Shipping Method KEYS
  		Elements one, two, three, etc. is a listing off all domestic (your country's) shipping method KEYS in %SHIPPING.
  		List as many domestic shipping methods as you require.

  Your 3 digit country code in element zero and the domestic shipping methods listed in elements one, two, three, etc. are used to determine if the client has chosen a shipping method which applies to their country of residence.

   
   
  %SHIPPING

  ---

   

  Array 3 - $SHIPPING{3} - Universal Subtotal Ranges

  $SHIPPING{3} is optional. If you do not use Universal Subtotal Ranges, $SHIPPING{3} may be deleted.
   
  $SHIPPING{3} example:

  
   '3' => [                 #  Order Subtotal        Shipping Charged
           '100.00:6.95',   #    $0.01 to $100.00     $6.95
           '150.00:9.95',   #  $100.01 to $150.00     $9.95
           '200.00:12.95',  #  $150.01 to $200.00    $12.95
           '300.00:15.95',  #  $200.01 to $300.00    $15.95
           '500.00:20.00',  #  $300.01 to $500.00    $20.00
           '750.00:30.00',  #  $500.01 to $750.00    $30.00
           '750.01:45.00',  #  $750.01 & up          $45.00
          ],
  

  If the client-selected shipping method contains subtotal ranges in element one, the shipping method's range values are used in place of the universal ranges.
   
  Each element of $SHIPPING{3} is colon delimited.
   
  Order subtotal values are left of the colon in each element and the corresponding base shipping cost is right of the colon in each element.
   
  The subtotal values must be listed in ascending order.
   
  For example, if an order's subtotal equals $32.95 (less than $100.00), the order's base shipping cost is $6.95.
   
   
  The base or universal shipping charge for an order are first calculated using the values listed in $SHIPPING{3}.
   
  The values placed in this array should equal the values of your least expensive shipping method, usually a ground shipping method within the borders of your country.
   
  After the base shipping value is determined, WebStore checks the contents of elements one and two of the client-selected shipping method for additional manipulations of the base shipping charges.
   
  When a dollar value is present in element one of the client-selected shipping method and no value is present in element two, element one's value is added to the base shipping charge to determine total shipping charges.
   
  When a value is present in element two of the client-selected shipping method, the base shipping charge is discarded. Shipping charges are calculated by multiplying the order's subtotal by the percentage value found in element two. If a dollar value is present in element one, it is added to the product to determine total shipping costs.
   
  If the charges for your shipping methods vary to the point that you can not use base or universal shipping values, delete $SHIPPING{3}. Subtotal ranges or a dollar value may be placed in element one of each shipping method or a percentage value must be placed in element two of each shipping method. If elements one and two of a shipping method are set to '' and $SHIPPING{3} does not exist, shipping costs will be set to 0.00.
   
   
  %SHIPPING

  ---

   

  Arrays 10 - XX $SHIPPING{10} - Shipping Methods

  $SHIPPING{10} must exist in %SHIPPING. If $SHIPPING{10} is removed or the numeric value of it's KEY (10) is altered, shipping is disabled in WebStore.
   
  $SHIPPING{10} is the first shipping method array.
   
  The default shipping method used by WebStore is defined in $SHIPPING{10}.
   
  $SHIPPING{10} remains the shipping method until the client selects an alternative shipping method.
   
  Each shipping method array (10, 11, 12, etc.) consists of a maximum of four elements.
   
  $SHIPPING{10} consists of the following elements:

  
   KEY     zero                           one  two  three
  '10' => ['UPS Ground or Priority Mail', '',  '',  ''],

  zero		Shipping Label
  		The shipping label used in the shipping drop down select element on the order form HTML page, confirmation of order HTML page, and e-mail messages.
  one		Add Value
  		When element one equals a dollar value, that value is added to the base shipping costs obtained using the universal subtotal range array, $SHIPPING{3}. When $SHIPPING{3} is not defined, element one's value becomes the total shipping cost for the shipping method.
  		Element one may contain a set of tilde delimited subtotal ranges: '15' => ['International Orders', '100.00:26.95~ 150.00:29.95~ 200.00:32.95~ 500.00:40.00~ 750.00:50.00~ 800.00:65.00', '', ''], Subtotal ranges present in a shipping method array take precedence over subtotal ranges in the universal subtotal range array, $SHIPPING{3}.
  		Do not include dollar signs or commas in element one. Element one is a fixed decimal number.
  two		Multiply Value
  		The Multiply Value takes precedence over the universal subtotal range array, $SHIPPING{3}, and any value present in element one of the shipping method.
  		The order's subtotal is multiplied by the decimal value present in element two to obtain the order's shipping cost. If a dollar value is present in element one, element one's value is added to the shipping cost product, producing the order's shipping subtotal. If ranges are present in element one, they are not used.
  		Do not include a dollar sign or commas in element two. Element two is a fixed decimal number.
  three		Country or State(s) Specific Shipping Method
  		'14' => ['Canadian Orders', '10.00', '.17', '132'], For country-specific shipping methods, list the country's 3 digit code from %countries in outlet.state_country.setup in element three. Only one country code may be listed in element three for a country-specific shipping method.
  		'13' => ['Alaska & Hawaii', '12.00', '.04', '11:21'], For state-specific shipping methods, list state 2 digit codes from %states in outlet.state_country.setup in element three. More than one state code may be listed in element three for a state-specific shipping method. Colon delimit multiple state codes.

   
   
  %SHIPPING

  ---

   

  $tax = '1';

  When $tax = 1, sales tax is calculated and displayed on the order form for those clients whose billing state, province, or country contains a fixed decimal value for sales tax in element two of %states, %provinces, or %countries in outlet.state_country.setup, defined in $country_file.
   
  Examples of state array from %states with 6.75% sales tax:

   KEY     zero    one       two       three
   '53' => ['TX',  'Texas',  '.0675'],
   '53' => ['TX',  'Texas',  '.0675',  '~~RATE~~ ~~STATE~~ Sales Tax'],

  Tax labels may be stored in element three. WebStore will use the universal label defined in $tax_label when element three is not defined or element three is set to ''.
   
  Setting $tax = '' disables sales tax calculation. Tax rates present in element two of %states, %provinces, or %countries in $country_file are disregarded.
   
   
  Index

  ---

   

  $tax_label = '~~RATE~~ ~~STATE~~ Sales Tax';

  $tax_label is displayed on WebStore's order form.
   
  Occurrences of    ~~RATE~~   ~~STATE~~   ~~PROVINCE~~   and   ~~COUNTRY~~   found in $tax_label will be replaced with:

  ~~RATE~~        Tax rate in percentage format:  6.75%
  ~~STATE~~       US state from %states in $country_file
  ~~PROVINCE~~    Canadian province from %provinces in $country_file
  ~~COUNTRY~~     Country from %countries in $country_file

  Example sales tax rate of .0675 and sales tax state of Texas:

  $tax_label = '~~RATE~~ ~~STATE~~ Sales Tax';
                6.75% Texas Sales Tax

  State, provincial, or country specific tax labels may be stored in element three of %states, %provinces, or %countries in outlet.state_country.setup, defined in $country_file.
   
   
  Index

  ---

   

  $mail_file = 'WebStore.list';

  $mail_file is the | (pipe) delimited flatfile mailing list database consisting of e-mail addresses and names.

  Example record:   susan@cgicentral.net|Susan Smith

  When an order is submitted, the client's e-mail address and name are added to $mail_file if the submitted e-mail address does not exist in $mail_file.
   
  Setting $mail_file = '' disables the addition of e-mail addresses and names to a mailing list database.
   
  WebStore requires your clients to CHECK a checkbox input on the order form before they will be added to the mailing list database. The name= of this checkbox input is joinlist=.
   
  For compatibility with WS Mail, $mail_file must end in .list. WebStore adds .list to the file name in $mail_file if the file name does not end in .list.
   
   
  Index

  ---

   

  $join_list = '';

  When $join_list = '1', clients are added to the mailing list defined in $mail_file regardless of the use or condition of the form field 'joinlist'.
   
  Setting $join_list = '' disables automatic addition to the mailing list. A form field for 'joinlist' must be included on the form and the client must choose to be added to the mailing list.
   
   
  Index

  ---

   
   
  Confirmation of Order HTML Page
   
   
  Order form fields printed to the Confirmation of Order HTML page are printed using <FONT SIZE> 3 for fax orders. <FONT SIZE> for credit card orders uses $data_font. <FONT FACE> uses $data_face.
   
  $data_font and $data_face are defined in ws_global.setup.
   
  When $data_font is set to a value greater than '3', WebStore sets $data_font equal to '2' and $header_font equal to '3' for printing the Confirmation of Order page.
   
  To assure proper colors for printing of the Confirmation of Order page, color attributes within the opening <BODY> tag are set by WebStore using the following values:

      $background  = '';          No background
      $bgcolor     = '#FFFFFF';   White
      $text_color  = '#000000';   Black
      $link_color  = '#0000FF';   Blue
      $vlink_color = '#0000A0';   Dark Blue
      $alink_color = '#FF0000';   Red

  Send Order to My Web Browser for Printing may be disabled by removing it's form submit button from %OrderForm in the order form setup file you are using.
   
   

  $fax_signature = '2';

  If $fax_signature = 0, never print client signature line on fax orders.
  If $fax_signature = 1, print client signature line in the credit card section of fax orders when any credit card field is not completed on the order form.
  If $fax_signature = 2, always print client signature line in the credit card section of fax orders.
   
  WebStore will print the appropriate messages at the top of fax orders based on form input and the setting of $fax_signature.
   
   
  Index

  ---

   

  $delete_cart = '';

  If $delete_cart = 1, delete the client's shopping cart file after successful order form submission, preventing the client from performing multiple form submissions. The client's cart is deleted after the entire confirmation of order page has been printed to the client's web browser.
   
  Setting $delete_cart = '', disables cart file deletion.
   
   
  Index

  ---

   
   
  Administrative & Confirmation of Order E-mail Messages
   
   

  @email_numbers = ('4', '5', '0', '1');

  @email_numbers array lists the array index numbers for the shopping cart database item fields to display at the bottom of the confimation of order page and to be included in the confirmation e-mail to the client and the order e-mail to the store's administrator. Column header text for the confirmation of order page is derived from the corresponding elements in @field_names.
   

  NOTE: First element of an array is 0 (zero).
  Database Fields in outlet.data
  0	|	1	|	2	|	3	|	4	|	5	|	6	|	7	|	8	|	9
  Color	|	Size	|	Shipping	|	Item	|	Category	|	Price	|	Name	|	Description	|	Image	|	Id

   
  The Image field is designed to display in Category tables only and should not be defined in @email_numbers or %email_fields_array.
   
  Database fields containing <HTML> code should not be defined in @email_numbers or %email_fields_array as <HTML> code will display as text in the e-mail messages.
   
   
  Index

  ---

   

  %email_fields_array = (
  
    '4' => 'right',
    '5' => 'left',
    '0' => 'left',
    '1' => 'left',
  
  ); # DO NOT REMOVE - terminates %modify_fields_array

  %email_fields_array is a hash which defines the alignment attribute for each field in
  @email_numbers.
   
  Valid alignment values are 'left' and 'right'.
   
  NOTE: First element of an array is 0 (zero).
   
   
  Index

  ---

   

  $label_align = 'left';

  $label_align defines the alignment attribute for form field labels for all forms in WebStore. Valid alignment values are 'left' and 'right'.

  LABELS ALIGNED 'left':
  
      Type of Card:      Visa
      Name on Card:      Susan Smith
      Card Number:       4111 1111 1111 1111
      Expiration Month:  January - 01
      Expiration Year:   2003
  
  LABELS ALIGNED 'right':
  
          Type of Card:  Visa
          Name on Card:  Susan Smith
           Card Number:  4111 1111 1111 1111
      Expiration Month:  January - 01
       Expiration Year:  2003

  $label_align defaults to 'left' if mis-configured.
   
   
  Index

  ---

   

  $item_subtotal = '1';

  If $item_subtotal = 1, include the subtotal of each item the client has ordered in the e-mail to client and e-mail to administrator.
   
  An item subtotal equals the quantity of an item multiplied by the item's unit price.
   
  Item subtotals are appended to the item's row, right justified (mandatory).
   
  Setting $item_subtotal = '' disables the addition of item subtotals to e-mail messages.
   
   
  Index

  ---

   

  $email_subject = $global_page_title.' Order';

  $email_subject is used as the SUBJECT of the order confirmation e-mail sent to the client and the administrative e-mail used by the store administrator to fill the order.
   
  The client's order identification number is appended to the SUBJECT:

  RDC Software Order: [980712040921989]

   
   
  Index

  ---

   

  $message_columns = '55';

  $message_columns is the maximum number of characters per line in the confirmation of order e-mail and the administrative e-mail messages for WebStore's order form.
   
  $message_columns also controls line lengths in e-mail messages generated by WebStore's secondary form processor and the line length of the message separator character string defined in $message_divider in all e-mail messages generated by all forms.
   
  Reformatting long text lines is performed on the contents of $pre_client_msg, $app_client_msg, and all <TEXTAREA> inputs present on all forms in WebStore.
   
  The value of $message_columns should be equal to or greater than the COLS attribute assigned to <TEXTAREA> inputs on the order form.
   
  $message_columns is numeric only, ranging from 50 to 80, and defaults to 55 if mis-configured.
   
  $message_columns is mandatory and can not be disabled.
   
   
  Index

  ---

   

  $message_divider = '-';

  $message_divider is a character or character string used to visually divide the sections of e-mail messages generated by all forms in WebStore.
   
  Tab characters in $message_divider are replaced with four spaces.
  Line control characters are removed from $message_divider.
   
  The character or character string which remains in $message_divider after whitespace filtering is duplicated and added to the right end of $message_divider until the string's length is equal to or greater than $message_columns.
   
  After character or character string duplication, whitespace is removed from the right end of $message_divider.
   
  Example $message_divider contents followed by the resulting character string divider printed in e-mail messages:

  $message_divider = '<>';
  <><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  
  $message_divider = '<> ';
  <> <> <> <> <> <> <> <> <> <> <> <> <> <> <> <> <> <> <>
  
  $message_divider = '<><><><> '.$global_page_title.' <><><><>';
  <><><><> RDC Software <><><><><><><><> RDC Software <><><><>
  
  $message_divider = '/\\';
  /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  
  $message_divider = '-';
  -------------------------------------------------------

  $message_divider defaults to - (dash) if $message_divider is set to ''.
   
   
  Index

  ---

   

  if ($email_link_url) { $E_mail = "\n".'E-mail:  mailto:'.$email_link_url }
  else { $E_mail = '' }
  
  $pre_client_msg  = join("\n",@company)."\n".
     qq!
  
  ~~FULL~~:
  
  Thank you for your order ~~FIRST~~.  We appreciate your business and look
  forward to serving you in the future.
  
  Please retain this e-mail for your records.\n$E_mail
  Store:   ~~STORE~~
  !; # DO NOT REMOVE - terminates $pre_client_msg.

  $pre_client_msg is printed at the beginning of the confirmation of order e-mail sent to the client.
   
  You may personalize the text in $pre_client_msg by using the client's name and e-mail address.
   
  Occurrences of    ~~FIRST~~   ~~FULL~~   ~~EMAIL~~   and   ~~STORE~~   found in $pre_client_msg will be replaced with:

  ~~FIRST~~    Client's first name
  ~~FULL~~     Client's full name
  ~~EMAIL~~    Client's e-mail address
  ~~STORE~~    WebStore URL

  Occurrences of  ~~FIRST~~  in $pre_client_msg are replaced with the full name of the client instead of the first name if the full name ends in Co, Company, Corp, Corporation, Inc, or Incorporated (case insensitive, optional trailing period).
   
  Occurrences of  ~~STORE~~  are replaced with $main_script_url, defined in ws_global.setup. The client's username and password are included when name=value pairs for the client's username and password exist:

  http://www.YourDomain.xxx/Web_store/ws400CS.cgi?uid=USERID&pwd=PASSWORD

  The client's username and password name=value pairs are provided by WebStore when you are using client order form files, a filename is defined in $client_file.
   
  A name=value pair for store= is included when the required store setup file is not equal to $default_setup_file, defined in the WebStore script.
   
  A name=value pair for demo= is included when WebStore is operating in demonstration mode and $demo = '' in ws_global.setup.
   
  Space the contents of $pre_client_msg as you would like it to appear in the e-mail message.
   
  Paragraph line lengths should be equal to or less than the value of $message_columns. Placing entire paragraphs on one line allows WebStore to split line lengths according to the value of $message_columns.
   
  Paragraphs containing ~~FIRST~~, ~~FULL~~, ~~EMAIL~~, and ~~STORE~~ should be on one line as the number of characters replacing these values can not be pre-determined.
   
  The script removes all leading and trailing whitespace from $pre_client_msg before line length formatting occurs. One blank line is added to the end of $pre_client_msg.
   
  Setting   $pre_client_msg = qq!!;  disables printing $pre_client_msg to the beginning of the client's confirmation of order e-mail.

  join("\n",@company)."\n".

  Prints the contents of @company.

  if ($email_link_url) { $E_mail = "\n".'E-mail:  mailto:'.$email_link_url }
  else { $E_mail = '' }

  Prints the contents of $email_link_url when an e-mail address is defined in $email_link_url.
   
  $E_mail
  The WebStore scripts and program libraries never use uppercase and _ (underscore) in a variable name.
   
   
  Index

  ---

   

  $app_client_msg = qq!$E_mail
  Store:   ~~STORE~~
  !; # DO NOT REMOVE - terminates $app_client_msg.

  $app_client_msg is printed at the end of the confirmation of order e-mail sent to the client.
   
  You may personalize the text in $app_client_msg by using the client's name and e-mail address.
   
  Occurrences of    ~~FIRST~~   ~~FULL~~   ~~EMAIL~~   and   ~~STORE~~   found in $app_client_msg will be replaced with:

  ~~FIRST~~    Client's first name
  ~~FULL~~     Client's full name
  ~~EMAIL~~    Client's e-mail address
  ~~STORE~~    WebStore URL

  Occurrences of  ~~FIRST~~  in $app_client_msg are replaced with the full name of the client instead of the first name if the full name ends in Co, Company, Corp, Corporation, Inc, or Incorporated (case insensitive, optional trailing period).
   
  Occurrences of  ~~STORE~~  are replaced with $main_script_url, defined in ws_global.setup. The client's username and password are included when name=value pairs for the client's username and password exist:

  http://www.YourDomain.xxx/Web_store/ws400CS.cgi?uid=USERID&pwd=PASSWORD

  The client's username and password name=value pairs are provided by WebStore when you are using client order form files, a filename is defined in $client_file.
   
  A name=value pair for store= is included when the required store setup file is not equal to $default_setup_file, defined in the WebStore script.
   
  A name=value pair for demo= is included when WebStore is operating in demonstration mode and $demo = '' in ws_global.setup.
   
  Space the contents of $app_client_msg as you would like it to appear in the e-mail message.
   
  Paragraph line lengths should be equal to or less than the value of $message_columns. Placing entire paragraphs on one line allows WebStore to split line lengths according to the value of $message_columns.
   
  Paragraphs containing ~~FIRST~~, ~~FULL~~, ~~EMAIL~~, and ~~STORE~~ should be on one line as the number of characters replacing these values can not be pre-determined.
   
  The script removes all leading and trailing whitespace from $app_client_msg before line length formatting occurs.
   
  Setting   $app_client_msg = qq!!;  disables printing $app_client_msg to the end of the client's confirmation of order e-mail.
   
  $email prints the contents of $email_link_url when an e-mail address is defined in $email_link_url.
   
   
  Index

  ---

   

  $pre_admin_msg = '1';

  If $pre_admin_msg = 1, preface e-mail to administrator with the reseller's details from the reseller database, Resellers.data, indicating where the order was routed. Also includes the referring web page the client accessed to link to WebStore in case the reseller did not include his reseller code OR included an incorrect code in the query string of the reseller's URL.
   
  Setting $pre_admin_msg = '' disables printing reseller information to the administrative e-mail message.
   
   
  Index

  ---

   

  $fax_email = '1';

  0		Order e-mail to administrator is disabled for fax orders.
  1		Send order e-mail to the store administrator when a client prints an order to their web browser for faxing.
  2		Send order e-mail to the store administrator and reseller when a client prints an order to their web browser for faxing.

   
   
  Index

  ---

   

  %mail_order = (
  
  # KEY      Switches   E-mail address
    '1' => [ 'af',      $admin_email ],
    '2' => [ 'rsf',     "Full Name <username\@Domain.xxx>"],
  
  ): # DO NOT REMOVE - terminates %mail_order

  %mail_order is a hash of arrays listing e-mail addresses which will receive a configured set of order related e-mail messages according to the mail switch settings present in element zero of each array.
   
  Switch Settings:
   

  a		Administrative e-mail, PGP encrypted or non-encrypted Complete order e-mail including credit card fields. If 'a' is not included in at least one e-mail address array, a complete administrative order message is delivered to $admin_email, defined in ws_global.setup.
  n		Administrative e-mail, non-encrypted - no client form fields Abbreviated message containing items ordered by the client.
  s		Administrative e-mail, non-encrypted - no credit card fields Message construct shared by all administrative message types.
  r		Reseller e-mail, non-encrypted - no credit card fields Message sent to reseller when reseller functions are enabled.
  c		Client e-mail Order receipt sent to the client submitting an order.
  d		Send e-mail messages when operating in demonstration mode 'd' has no effect when WebStore's demonstration mode is disabled. Refer to $demo in ws_global.setup for demonstration mode details.
  f		Send e-mail messages for fax order submissions Messages are delivered when a client prints an order to their web browser for faxing when $fax_email equals '1' or '2'.

   
  E-mail address arrays which do not contain a minimum of one message switch in element zero are bypassed. Valid message switches are a, c, n, r, or s.
   
  E-mail address arrays are bypassed when the e-mail address in element one does not pass the minimum e-mail address syntax of Text@Text.Text.
   
  A complete administrative order message, type a, is delivered to $admin_email when all arrays are bypassed due to the errors described above or when $admin_email is not defined in an e-mail address array in %mail_order.
   
  Setting %mail_order = () disables sending configured sets of order related e-mail messages. A complete administrative order message, type a, is delivered to $admin_email.
   
   
  Index

  ---

   
   
  Statistics
   
   

  $log_file = 'WebStore_Access.stats';

  $log_file is the name of the statistics log file stored in the /Statistics sub-directory.
   
  Maintain a formatted or | (pipe) delimited log file for the first access to WebStore consisting of:

  Access Date and Time       21/Dec/1998 12:54:03 PM
  $ENV{'HTTP_USER_AGENT'}    Type of Browser
  $ENV{'HTTP_REFERER'}       Referring web page
  $ENV{'REMOTE_ADDR'}        Remote address
  $ENV{'REMOTE_HOST'}        Remote host

  Setting $log_file = '' disables the statistics log file routine.
   
   
  Index

  ---

   

  $log_file_size = '25000';  (log file size = 25K)

  $log_file_size equals the maximum size of the statistics log file before overwrite occurs.
   
  Setting $log_file_size = '' disables overwrite of the log file. You must manually delete the log file.
   
   
  Index

  ---

   

  $log_delimiter = '';

  Setting $log_delimiter = 'Y' will | (pipe) delimit the fields of each record written to the log file defined in $log_file.
   
  Setting $log_delimiter = '' disables pipe delimited fields. Fields are separated by four spaces.
   
   
  Index

  ---

   

  $stat_file = 'WebStore_Query.stats';

  $stat_file is the name of the query stat file stored in the /Statistics sub-directory.
   
  Maintain a formatted or | (pipe) delimited query stat file consisting of:

  Access Date and Time    21/Dec/1996 12:54:03 PM
  Setup File              Store setup filename (file extension truncated)
  Request                 Primary Request (query name=value pair)
  $ENV{'REMOTE_ADDR'}     Remote address
  Process ID              Script process ID
  Query String            name=value pairs present in form POST submissions
                          or WebStore HREF anchor query strings.
                          Values for login, password, username, and any
                          field beginning with cc or chk are replaced with
                          * (asterisks).  Field names are case insensitive.

  Setting $stat_file = '' disables the query stat file routine.
   
   
  Index

  ---

   

  $stat_file_size = '50000';  (stat file size = 50K)

  $stat_file_size equals the maximum size of the query stat file before overwrite occurs.
   
  Setting $stat_file_size = '' disables overwrite of the query stat file. You must manually delete the stat file.
   
   
  Index

  ---

   

  $stat_delimiter = '';

  Setting $stat_delimiter = 'Y' will | (pipe) delimit the fields of each record written to the query stat file defined in $stat_file.
   
  Setting $stat_delimiter = '' disables pipe delimited fields. Fields are separated by four spaces.
   
   
  Index

  ---

   

  $count_file = 'WebStore_Access.counter';

  $count_file is the access counter file stored in the /Statistics sub-directory. Each time a client visits your WebStore, the value stored in $count_file is incremented by 1 (one).
   
  Setting $count_file = '' disables the access counter routine.
   
   
  Index

  ---

   

  $start_count = '0';

  $start_count may be used to set the initial value or increase the current value stored in the access counter file defined in $count_file.
   
   
  Index

  ---

   

  $counter_label = 'Visitor Count:';

  $counter_label is the counter's label printed on the store's front page to the left of the access counter.
   
   
  Index

  ---

   
   
  Table Displays
   
   

  $meta_tags = qq!
  
  <META NAME="description" content="$global_page_title - Online Shopping">
  <META NAME="keywords" content="comma,delimited,list,of,keywords">
  
  !: # DO NOT REMOVE - terminates $meta_tags

  Use $meta_tags to store META TAGS for printing in the <HEAD></HEAD> of all WebStore generated pages and forms.
   
  Setting $meta_tags = '' disables printing of <META TAGS>.
   
   
  Index

  ---

   

  # $background  = '';
  # $bgcolor     = '#FFFFFF';  # White
  # $text_color  = '#000000';  # Black
  # $link_color  = '#0000FF';  # Blue
  # $vlink_color = '#0000A0';  # Dark Blue
  # $alink_color = '#FF0000';  # Red

  Values for background, bgcolor, text, link, visited link, and active link are set using $background, $bgcolor, $text_color, $link_color, $vlink_color, $alink_color respectively.
   
  These variables are set globally in ws_global.setup for use by all scripts in the WebStore application.
   
  To configure specific colors for WebStore, remove the # (pound sign) from column 1 and set to the desired value. Any combination of these variables may be uncommented (pound sign removed).
   
  $background is the filename of the background image stored in the /Web_store/Graphics sub-directory.
   
  The script determines whether to precede $backgound with $graphics_url or $ssl_graphics_url based on the setting of $ssl_url and the form action being processed:

      $graphics_url/$background   OR   $ssl_graphics_url/$background

  Setting any of these variables = ''; disables printing their respective attribute within the opening <BODY> tag of WebStore generated HTML pages.
   
  For your store's frontpage, category frontpages, and expanded item information pages, add the background and color attributes to the HTML file's <BODY> tag.
   
   
  Index

  ---

   

  $SPC = ' ';

  $SPC contains a non-breaking space extended character necessary for assigning bgcolor attributes in the spacer columns of table data rows in category and view/modify tables. A column must contain at least one character to display background color. $SPC should not be altered, unless you prefer the look of it.
   
  Setting $SPC = ''; will remove the <TD BGCOLOR> from spacer columns in rows containing database items.
   
   
  Index

  ---

   

  $CELLPADDING = '2';

  $CELLPADDING is the value of <TABLE CELLPADDING>.
   
   
  $SPC and $CELLPADDING are constants used in displaying all tables within WebStore. This will maintain visual consistency between category and view/modify tables.
   
  Dimensions of table's borders, space between columns, and space between category and cart content rows can be modified by adjusting the value $CELLPADDING.
   
  If additional row space is needed to display categories or cart contents, set $table_border and $modify_table_border to 0 respectively.
   
   
  Index

  ---

   

  $border = '0';

  If $border = 1, border is wrapped around the table.
  If $border = 0, border is disabled.
   
  $border should be set to 1 only for reviewing HTML formatted text printed from database item fields.
   
   
  Index

  ---

   
   
  Database Category and Search Result Tables
   
  The Image field is designed to automatically print to database category displays and search result pages. WebStore prints item images based on the presence of an image source tag in the Image field or the existence of an item's image based on the image filename constructed using the contents of the Item field when a field number is defined in $item_fld_num.
   
  Do not define the Image field in @vertical_numbers or @display_numbers.
   
   
   

  @vertical_numbers = ('7');

  @vertical_numbers array lists the array index numbers for each database field set for vertical, labeled display in Category tables.
   
  Fields in @vertical_numbers may be colon delimited, including HTML formatting characters to the right of colons. Fields may be printed with or without HTML formatted field labels. Fields in @vertical_numbers are printed above the fields defined in @display_numbers.
   
  Field Labels:
   
  UPPERCASE control characters effect printing of a field's corresponding label defined in @field_names:

  N   Do not print the field's label.  B, I, and U are ignored
  B   Wrap <B> tags around field label
  I   Wrap <I> tags around field label
  U   Wrap <U> tags around field label

  Field Contents:
   
  lowercase control characters effect printing of field contents:

  b   Wrap <B> tags around field contents
  i   Wrap <I> tags around field contents
  u   Wrap <U> tags around field contents

  A blank element inserted between fields in @vertical_numbers will print one spacing table row with HEIGHT=10.
   
  WebStore removes leading and trailing blank elements, reducing multiple imbedded blank elements to one blank element.
   
  Example:

  VALUE:       @vertical_numbers = ('','','0:B','','','7:N','','');
  REDUCED TO:  @vertical_numbers = ('0:B','','7:N');

  WebStore reduces multiple references to the same field to one field reference, using the first reference to the field.
   
  Example:

  VALUE:       @vertical_numbers = ('0:B','','0:Nb','','7:N');
  REDUCED TO:  @vertical_numbers = ('0:B','','7:N');

  When field zero or field one is included in @vertical_numbers, WebStore prints the following fields in the listed order:

  Price
  Quantity text input
  Color SELECT element - field 0
  Size  SELECT element - field 1

  WebStore uses the first occurrence of field zero or field one, translating field one references to field zero. Price field references and additional references to field zero or field one are disregarded.
   
  Examples:

  VALUE:       @vertical_numbers = ('0:B','','1:Nb','','7:N');
  REDUCED TO:  @vertical_numbers = ('0:B','','7:N');
  
  VALUE:       @vertical_numbers = ('1:B','','0:Nb','','7:N');
  REDUCED TO:  @vertical_numbers = ('0:B','','7:N');
  

  Database fields containing no text are not printed to the web browser.
   
  Examples:

  @vertical_numbers = ('0');
  Price, Quantity, Color, and Size with field labels.
  
  @vertical_numbers = ('0:B');
  Price, Quantity, Color, and Size with <B> tags around
  field labels.
  
  @vertical_numbers = ('0:B', '', '7:N');
  Price, Quantity, Color, and Size with <B> tags around
  field labels, followed by spacing row with HEIGHT=10,
  followed by Description field with no field label.

   
  Setting @vertical_numbers = (); disables printing of vertical fields.
   

  NOTE: First element of an array is 0 (zero).
  Database Fields in outlet.data
  0	|	1	|	2	|	3	|	4	|	5	|	6	|	7	|	8	|	9
  Color	|	Size	|	Shipping	|	Item	|	Category	|	Price	|	Name	|	Description	|	Image	|	Id

   
   
  Index

  ---

   
   

  @display_numbers = ('7');

  @display_numbers array lists the array index numbers for each database field set for vertical display in Category tables.
   
  Fields in @display_numbers are printed below the fields defined in @vertical_numbers in table rows spanning the entire table's width.
   
  When @vertical_numbers = (); fields in @display_numbers are printed according to the presence of an item image, using the alignment attribute assigned to the image in the Image field.
   
  Elements in @display_numbers are numeric only. WebStore disregards blank elements and elements containing alpha or special characters.
   
  WebStore removes duplicated field references, using the first occurrence of a field reference.
   
  Example:

  VALUE:       @display_numbers = ('7','','7');
  REDUCED TO:  @display_numbers = ('7');

  Setting @display_numbers = (); disables printing of fields below the fields defined in @vertical_numbers.
   

  NOTE: First element of an array is 0 (zero).
  Database Fields in outlet.data
  0	|	1	|	2	|	3	|	4	|	5	|	6	|	7	|	8	|	9
  Color	|	Size	|	Shipping	|	Item	|	Category	|	Price	|	Name	|	Description	|	Image	|	Id

   
  The Image field is controlled by WebStore and should not be defined in @display_numbers, @vertical_numbers or %fields_array.
   
  The Price, and drop down list fields (defined in this file as Color and Size), are controlled by either @vertical_numbers or WebStore and should not be defined in @display_numbers.
   
   
  Index

  ---

   

  %fields_array = (
  
    '0' => 'left',
    '3' => 'left',
    '4' => 'left',
    '5' => 'left',
    '6' => 'left',
    '7' => 'left',
  
  ); # DO NOT REMOVE - terminates %fields_array

  %fields_array is a hash defining the alignment attribute for each database field set for display in @vertical_numbers and @display_numbers for category tables.
   
  Valid alignment values are 'left', 'center', and 'right'.
   
  Field alignment defaults to 'left' for undefined references or references not equal to 'left', 'center', or 'right'.
   
  Defining a reference to field '1' in %fields_array has no effect. WebStore translates all field '1' references in @vertical_numbers to field '0' in it's array filter subroutine.
   
  NOTE: First element of an array is 0 (zero).
   
   
  Index

  ---

   

  $table_border = '1';

  If $table_border = 1, colored border is wrapped around the table.
  Setting $table_border = '' disables printing of the colored border.
   
   
  Index

  ---

   

  $spc_width = '7';

  $spc_width controls the width of spacer columns located between displayed category item fields defined in @display_numbers.
   
   
  Index

  ---

   

  $spc_height = '1';

  $spc_height controls the height of spacer rows separating displayed category item rows. Spacer rows follow the BGCOLOR or BACKGROUND attribute of the document.
   
  $table_border, $spc_width, and $spc_height are used to manipulate table appearance when displaying database categories or items returned from a client search.
   
   
  Index

  ---

   

  $table_title = $global_page_title;

  $table_title is the text printed to the title header row of displayed database categories and search result HTML pages generated by WebStore.
   
  Setting $table_title = '' disables printing of the header title row.
   
   
  Index

  ---

   

  $table_width = '';

  $table_width sets the table width of displayed database categories and and search result HTML pages. WebStore prints single item tables.
   
  When $table_width contains a width value, WebStore disables $table_border which prevents the printing of colored borders around item tables.
   
  $table_width may be a percentage of the browser's window or pixel count.
   
  Example settings:

  $table_width = '85%'; # Percentage
  $table_width = '575'; # Pixel count

  Setting $table_width = '' disables fixed table widths. Displayed items are printed in a single table. WebStore disables $item_separator.
   
   
  Index

  ---

   

  $item_separator = '';

  The contents of $item_separator are printed in a table between displayed category item tables or search result item tables when $table_width contains a width value.
   
  The separator table row is printed with height equal to ($spc_height * 3) and alignment attributes equal to ALIGN=center VALIGN=middle.
   
  Example settings:

  $item_separator = $SPC;
  $item_separator = qq!<HR WIDTH="550" NOSHADE>!;
  $item_separator = qq!<IMG SRC="$graphics_url/divider.gif" BORDER=0>!;

  Setting $item_separator = '' prints a single spacing table row between displayed items with a height equal to $spc_height. WebStore disables $item_separator when $table_width = ''.
   
   
  Index

  ---

   

  $max_items = '10';

  $max_items is the maximum number of items returned to the client's web browser for a database category display or search result. It's value must be numeric, greater than zero. $max_items defaults to 5 if mis-configured.
   
   
  Index

  ---

   

  $display_category = '0';

  If $display_category = 0, display the client's shopping cart contents after adding items to the cart.
   
  If $display_category = 1, return the client to the database category, product page, or search result page after adding items to the cart.
   
   
  Index

  ---

   
   
  Image Display
   
   

  $img_spacing = '10';

  $img_spacing is the amount of space between the image and the image's adjacent table columns.
   
   
  Index

  ---

   

  $img_border = '3';

  $img_border is the image's outermost border and is a normal <TABLE BORDER>.
  Setting $img_border = '0' disables $img_border.
   
  Setting $img_border = '0' disables $img_padding regardless of it's value in this setup file.
  Vary the width of this border by increasing or decreasing the value of $img_border.
   
   
  Index

  ---

   

  $img_padding = '0';

  $img_padding is the amount of space between the normal <TABLE BORDER> defined in $img_border and the image or the outermost colored border defined in $outer_clr_width and $outer_img_clr.
   
  When $img_border = '0', $img_padding is disabled regardless of it's value in this setup file.
  Vary the width of padding by increasing or decreasing the value of $img_padding.
   
   
  Index

  ---

   

  $outer_clr_width = '3';
  $outer_img_clr   = '#FF0000'; Red

  $outer_clr_width and $outer_img_clr define the image's outermost colored ornamental border.
  Setting $outer_clr_width = '' disables this ornamental border.
  Vary the width of this border by increasing or decreasing the value of $outer_clr_width.
   
  $outer_img_clr defines the color of this ornamental border.
   
   
  Index

  ---

   

  $inner_clr_width = '3';
  $inner_img_clr   = '#000000'; Black

  $inner_clr_width and $inner_img_clr define the image's innermost colored ornamental border.
  Setting $inner_clr_width = '' disables this ornamental border.
  Vary the width of this border by increasing or decreasing the value of $inner_clr_width.
   
  $inner_img_clr defines the color of this ornamental border.
   
   
  Index

  ---

   
   
  View/Modify Tables
   
   

  @modify_display_numbers = ('5', '0', '1', '4');

  @modify_display_numbers array lists the array index numbers for the shopping cart database item fields to display in View/Modify Cart Items, Delete Cart Items, and at the top of the order form. Column header text is derived from the corresponding elements in @field_names.
   

  NOTE: First element of an array is 0 (zero).
  Database Fields in outlet.data
  0	|	1	|	2	|	3	|	4	|	5	|	6	|	7	|	8	|	9
  Color	|	Size	|	Shipping	|	Item	|	Category	|	Price	|	Name	|	Description	|	Image	|	Id

   
  The Image field is designed to display in Category tables only and should not be defined in @modify_display_numbers or %modify_fields_array.
   
   
  Index

  ---

   

  %modify_fields_array = (
  
    '5' => 'left',
    '0' => 'left',
    '1' => 'left',
    '4' => 'right',
  
  ); # DO NOT REMOVE - terminates %modify_fields_array

  %modify_fields_array is a hash which defines the alignment attribute for each database field set for display in @modify_display_numbers for cart content tables.
   
  Valid alignment values are 'left', 'center', and 'right'.
   
  NOTE: First element of an array is 0 (zero).
   
   
  Index

  ---

   
   

  $modify_table_border = '1';

  If $modify_table_border = 1, colored border is wrapped around the table.
  Setting $modify_table_border = '' disables printing of the colored border.
   
   
  Index

  ---

   

  $modify_spc_width = '7';

  $modify_spc_width controls the width of spacer columns located between displayed cart contents columns defined in @modify_display_numbers.
   
   
  Index

  ---

   

  $modify_spc_height = '1';

  $modify_spc_height controls the height of spacer rows separating displayed cart contents rows. Spacer rows follow the BGCOLOR or BACKGROUND attribute of the document.
   
  $modify_table_border, $modify_spc_width, and $modify_spc_height are used to manipulate table appearance when the client's shopping cart contents are displayed.
   
   
  Index

  ---

   
   
  Font Control
   
   
  $data_font and $data_face, set in ws_global.setup, are used with $data_fnt_clr and $modify_fnt_clr to develop an opening <FONT> tag for use in table data rows.
   
  $header_font and $header_face, set in ws_global.setup, are used with $header_fnt_clr and $dsc_hr_fnt_clr to develop opening <FONT> tags for use in table header rows.
   
   

  $header_bkg_clr = '#000000'; Black
  $header_fnt_clr = '#FFFFFE'; White

  $header_bkg_clr and $header_fnt_clr are the background color and font color used in table header rows to display table page headers in all WebStore generated tables.
   
  Setting $header_bkg_clr = '' disables $header_bkg_clr.
  Setting $header_fnt_clr = '' disables $header_fnt_clr.
  Colors default to <BODY BGCOLOR or BACKGROUND> and <BODY TEXT> attributes.
   
   
  Index

  ---

   

  $dsc_hr_bkg_clr = '#DCDCDC'; Gainsboro
  $dsc_hr_fnt_clr = '#000000'; Black

  $dsc_hr_bkg_clr and $dsc_hr_fnt_clr are the background color and font color used in table header rows to display order subtotal messages and descriptive column text in all WebStore generated tables.
   
  Setting $dsc_hr_bkg_clr = '' disables $dsc_hr_bkg_clr.
  Setting $dsc_hr_fnt_clr = '' disables $dsc_hr_fnt_clr.
  Colors default to <BODY BGCOLOR or BACKGROUND> and <BODY TEXT> attributes.
   
   
  Index

  ---

   

  $data_bkg_clr = '#B0C4DE'; Lightsteelblue
  $data_fnt_clr = '#000000'; Black

  $data_bkg_clr and $data_fnt_clr are the background color and font color used in table data rows to display database categories or items returned from a client search.
   
  Setting $data_bkg_clr = '' disables $data_bkg_clr.
  Setting $data_fnt_clr = '' disables $data_fnt_clr.
  Colors default to <BODY BGCOLOR or BACKGROUND> and <BODY TEXT> attributes.
   
   
  Index

  ---

   

  $modify_bkg_clr = '#B0C4DE'; Lightsteelblue
  $modify_fnt_clr = '#000000'; Black

  $modify_bkg_clr and $modify_fnt_clr are the background color and font color used in table data rows to display items in the client's shopping cart.
   
  Setting $modify_bkg_clr = '' disables $modify_bkg_clr.
  Setting $modify_fnt_clr = '' disables $modify_fnt_clr.
  Colors default to <BODY BGCOLOR or BACKGROUND> and <BODY TEXT> attributes.
   
   
  Index

  ---

   

  $border_bkg_clr = '#B0C4DE'; Lightsteelblue

  $border_bkg_clr is the background color of table ornamental borders in all WebStore generated tables.
   
  Set $table_border = '' to disable ornamental borders when displaying database categories or items returned from a client search.
   
  Set $modify_table_border = '' to disable ornamental borders when displaying the client's shopping cart contents.
   
   
  Index

  ---

   

  $count_bkg_clr = '#000000'; Black
  $count_fnt_clr = '#00FF00'; Green

  $count_bkg_clr and $count_fnt_clr are the background color and font color used to display the access counter on the store's front page.
   
  <FONT FACE> of the $counter_label and the access count value printed from $count_file uses $data_face, defined in ws_global.setup.
   
  Setting $count_bkg_clr = '' disables $count_bkg_clr.
  Setting $count_fnt_clr = '' disables $count_fnt_clr.
  Colors default to <BODY BGCOLOR or BACKGROUND> and <BODY TEXT> attributes.
   
   
  Index

  ---

   
   
  Display Additional HTML
   
   

  @include_files = (
  
    'include.Page_Header.txt',
    'include.Page_Trailer.txt',
  
  ); # DO NOT REMOVE - terminates @include_files

  @include_files is a list of files to be inserted into parsed HTML documents. Files which may be included are JavaScripts, CSS files, HTML formatted text, etc.
   
  The contents of the files listed in @include_files are substituted into HTML pages by adding hidden text tags using the file's name:

  <!--include=include.Page_Header.txt-->

  Whitespace is not allowed in include hidden text tags. WebStore ignores hidden text tags which contain whitespace.
   
  Hidden text tags are replaced with the associated file's contents.
  cart_id= substitution occurs on the contents of substituted files.
   
  Files listed in @include_files must be located under WebStore's /Html sub-directory or any sub-directory you may create under /Html.
   
  When files are placed under sub-directories, the sub-directory must be listed in the hidden text tag:

  <!--include=subdir/include.Page_Header.txt-->

  When a file does not exist under the /Html directory, WebStore writes a FILE NOT FOUND message in the file's associated hidden text tag:

  <!-- FILE NOT FOUND:  include.Page_Header.txt -->

  WebStore disables SSI tags detected in HTML documents.
   
  Setting @include_files = () disables file includes.
   
   
  Index

  ---

   

  &print_text_file('filename.txt');

  Adding the command above to any of the subroutines below will access sub print_text_file in WebStore.
   
  WebStore will print the contents of filename.txt, performing cart_id= substitution on the file's contents.
   
  Place text files in the /Html sub-directory.
   
  Do not include opening or closing <HTML>, <TITLE>, or <BODY> tags in text files printed using sub print_text_file.
   
  WebStore adds .txt to the filename listed in &print_text_file('filename'); if the filename does not end in .txt.
   
  If filename.txt does not exist in the /Html sub-directory, WebStore prints the following hidden text to the document printed to the web browser:

  <!-- FILE NOT FOUND:  filename.txt -->

   

  $frontpage_trailer = '1';

  If $frontpage_trailer = 1, append the store's front page defined in $frontpage_file with the contents of sub frontpage_trailer_html after form input buttons. Design the HTML code, copy and paste it below the PRINTED FROM hidden comment line in sub frontpage_trailer_html.
   
  Setting $frontpage_trailer = '' disables access to sub frontpage_trailer_html. Nothing is printed to the bottom of the store's front page.
   
  sub frontpage_trailer_html is a Perl subroutine which allows you to program the printed output to the bottom of the store's front page.

  sub frontpage_trailer_html {
  
        print qq!
  
  <\!-- PRINTED FROM:  sub frontpage_trailer_html in $store -->
  
  !; # DO NOT REMOVE - terminates "print qq!" command above.
  
        # Print the contents of /Html/shipping.txt
        &print_text_file('shipping.txt');
  
  } # DO NOT REMOVE - End of sub frontpage_trailer_html

   
   
  Index

  ---

   

  $pre_category = '1';

  If $pre_category = 1, preface database category displays and search result pages with the contents of sub pre_category_html. Design the HTML code, copy and paste it below the PRINTED FROM hidden comment line in sub pre_category_html.
   
  If $pre_category = 2, convert the name of the current database category being displayed by the client to a header text filename.
   
  WebStore replaces spaces in the database category name with _ (underscores) to construct the header text filename.

  EXAMPLE category name:         Category Name
  Header text filename:    C-HDR.Category_Name.txt

  If the header text file exists in the Html sub-directory, WebStore will print the contents of the file to the client's web browser immediately after executing sub pre_category_html.

  Default header text filename:   C-HDR.DEFAULT.txt

  If a header text file does not exist for a database category name, WebStore will print the contents of the default header text file, C-HDR.DEFAULT.txt, if it exists.
   
  WebStore performs query string substitution for occurrences of cart_id= detected in the header text file before printing the contents of the file to the client's web browser.
   
  Do not include opening or closing <HTML>, <TITLE>, or <BODY> tags in category header text files.
   
  Setting $pre_category = '' disables access to sub pre_category_html and disables printing of category header text files to the top of database category displays and search result pages. Nothing is printed at the top of database category displays.
   
  sub pre_category_html is a Perl subroutine which allows you to program the printed output to the top of database category displays.

  sub pre_category_html {
  
        print qq!
  
  <\!-- PRINTED FROM:  sub pre_category_html in $store -->
  
  !; # DO NOT REMOVE - terminates "print qq!" command above.
  
  } # DO NOT REMOVE - End of sub pre_category_html

   
   
  Index

  ---

   

  $category_trailer = '1';

  If $category_trailer = 1, append database category displays and search result pages with the contents of sub category_trailer_html. Design the HTML code, copy and paste it below the PRINTED FROM hidden comment line in sub category_trailer_html.
  If $category_trailer = 2, convert the name of the current database category being displayed by the client to a trailer text filename.
   
  WebStore replaces spaces in the database category name with _ (underscores) to construct the trailer text filename.

  EXAMPLE category name:         Category Name
  Header text filename:    C-TRL.Category_Name.txt

  If the trailer text file exists in the Html sub-directory, WebStore will print the contents of the file to the client's web browser immediately after executing sub category_trailer_html.

  Default trailer text filename:   C-TRL.DEFAULT.txt

  If a trailer text file does not exist for a database category name, WebStore will print the contents of the default trailer text file, C-TRL.DEFAULT.txt, if it exists.
   
  WebStore performs query string substitution for occurrences of cart_id= detected in the trailer text file before printing the contents of the file to the client's web browser.
   
  Do not include opening or closing <HTML>, <TITLE>, or <BODY> tags in category trailer text files.
   
  Setting $category_trailer = '' disables access to sub category_trailer_html and disables printing of category trailer text files to the bottom of database category displays and search result pages. Nothing is printed at the bottom of database category displays.
   
  sub category_trailer_html is a Perl subroutine which allows you to program the printed output to the bottom of database category displays and search result pages.

  sub category_trailer_html {
  
        print qq!
  
  <\!-- PRINTED FROM:  sub category_trailer_html in $store -->
  
  !; # DO NOT REMOVE - terminates "print qq!" command above.
  
  } # DO NOT REMOVE - End of sub category_trailer_html

   
   
  Index

  ---

   

  $pre_view_modify = '2';

  If $pre_view_modify = 1 or 2, preface shopping cart View/Modify displays with the contents of sub pre_view_modify_html. Design the HTML code, copy and paste it below the PRINTED FROM hidden comment line in sub pre_view_modify_html.
   
   
  If $pre_view_modify = 2, access sub pre_view_modify_html from any form file in WebStore. The contents of sub pre_view_modify_html will print directly below any printed output from the form file's corresponding subroutine.
   
  sub pre_client_form_html in client access form files and sub pre_form_html in order form and secondary form files contain the following command at the bottom of the subroutine:

  &pre_view_modify_html if $pre_view_modify eq '2';

  This line of code may be removed or commented in form files you do not want accessing sub pre_view_modify_html.
   
  Images must be placed in the /Graphics sub-directory and must be referenced using $graphics_url. WebStore sets the value of $graphics_url based on the use of SSL for the store's order form setup file.

  <IMG SRC="$graphics_url/image.gif" BORDER=0 WIDTH=325 HEIGHT=40>

   
  Setting $pre_view_modify = '' disables access to sub pre_view_modify_html. Nothing is printed at the top of shopping cart content displays or the top of WebStore forms from sub pre_view_modify_html.
   
  sub pre_view_modify_html is a Perl subroutine which allows you to program the printed output to the top of shopping cart content displays.

  sub pre_view_modify_html {
  
        print qq!
  
  <\!-- PRINTED FROM:  sub pre_view_modify_html in $store -->
  
  !; # DO NOT REMOVE - terminates "print qq!" command above.
  
  } # DO NOT REMOVE - End of sub pre_view_modify_html

   
   
  Index

  ---

   
   
  Search Engine
   
   

  $search_engine = '1';

  0		Search form output is disabled. Substitution of no_search=Y into WebStore query strings is disabled.
  1		Print search form at the bottom of the store's front page, category front pages, and expanded item information pages.
  		When no_search=Y exists in a WebStore query string on an HTML page, do not print the search form to the HTML page defined in category= of the query string.
  		The search engine form is always printed to the store's front page.
  2		Print search form at the bottom of the store's front page. Substitute the name=value pair no_search=Y into WebStore query strings found in all HTML documents and WebStore query strings found in fields in the item database, outlet.data.
  		When no_search=Y exists in a WebStore query string on an HTML page or in a query string in the item database, do not print the search form to the HTML page defined in category= of the query string. When the client clicks an anchor containing no_search=Y, search form printing remains prohibited until the client performs a search.
  		When the client performs a search, substitution of no_search=Y into WebStore query strings is temporarily disabled. The search form is printed to all HTML pages until the client clicks an anchor containing no_search=Y.
  		Placing no_search= (with no value) in a WebStore query string prevents WebStore from substituting no_search=Y into the query string. When the client clicks an anchor containing no_search=, the search form is printed to the HTML page defined in category= of the query string and no_search=Y is not substituted into query strings present on the HTML page.
  		The search engine form is always printed to the store's front page.

   
   
  Index

  ---

   

  $search_tips = 'SearchTips.html';

   
  $search_tips is the search engine help file. When $search_tips is equal to 'SearchTips.html', this file must be present in the /Html sub-directory or WebStore will generate an HTML File not Found message.
   
  Setting $search_tips = ''; disables printing the search tips URL on the search engine form located on the store's front page. Access to the search engine help file is disabled.
   
   
  Index

  ---

   

  $categories_desc = 'Search all Categories';

  $categories_desc is the default text printed as the <OPTION VALUE SELECTED> for the drop down list element of database categories on the search engine form. Categories are listed in @categories.
   
   
  Index

  ---

   

  @categories = (
  
    'Outer Wear',
    'Shirts',
    'Sweaters',
  
     # The following line must be on a line by itself
  ); # DO NOT REMOVE OR MODIFY THIS LINE - terminates @categories

  @categories array lists all categories in the store database, outlet.data, and is used to construct the drop down list element on the search form.
   
  WS Editor may be configured to update @categories using any of it's Group or Sort functions. Refer to @store_files in outlet_editor.setup, the WS Editor setup file which maintains the database defined in $data_file. WS Editor is configured to update @categories in the WebStore distributions.
   
  Prohibit the search of any category by omitting it from @categories.
   
   

  1; # DO NOT REMOVE IN outlet.setup
  
  # End of file

   
  Index | Top of Page

  ---