Pageville Shopping Cart
Designer Manual

Overview
Shopping Cart Setup
Payment Processing Options
Payment Processing Test Mode
Product Attributes
Buy Button Methods
Look and Feel
Frames and Target
Require Approval before Processing
Special Commands
Fractional Quantities
After Payment Processing
Retrieving Orders
Basic 2005 Shopping Cart
Shopping Cart PLUS Features

Overview

This manual explains how to set up a Pageville Shopping Cart, and how to integrate the shopping cart into your web site. Pageville offers two ways to use our Shopping Cart technology.

Pageville Shopping Cart Only Processing Site Your domain, promotion, shopping and order pages, and your graphics remain on your existing web site. BUY buttons on your site link to Pageville and add the items to the customer's shopping cart. The "Review and Checkout" button on your site will bring up the "Review and Checkout" page from Pageville.

Pageville Standard Web Site Your entire site will be hosted in Pageville.

Order Site - the main directory for the shopping cart for a site. If a company's domain is in Pageville, it will also be this directory. The Order Site is not secure. The following information is stored on the order site:

• Orders in process
• Completed orders (without credit card information) can be stored here allowing owner to see any order where the customer did not complete the payment process.
• Parameter files for the shopping cart
• Pattern files for the shopping cart

Payment Site - a secure site using the secure server of one of the payment processing options, including: Pageville, Authorize.Net, PayPal, Blue Pay, 2CheckOut.com, NOCHEX or PayCash. This site will be browser password protected. The owner will retrieve the payment credit card information using a secure browser link. Credit card information will be stored here. Order information can be stored here.

Shopping Cart Setup

The first step is to get a shopping cart ID. This FREE ID simply ties the processing to your specific web site. Get your ID at www.pageville.com, click on Log In.

Once you have a Shopping Cart ID, you can either go to the Pageville Shopping Cart Tools page to tailor the cart to your needs, or you can start adding shopping buttons to your site.

Pageville Shopping Cart Tools

Here you set up merchant information, sales tax, shipping charges, and various other settings.

Shopping Buttons

A shopping button consists of two parts, the image on your site and the link to processing it initiates. You can use your own shopping button images or use Pageville's sample shopping button images.

To manually create processing links for adding items to your shopping cart, generate the code for an item using Pageville's HTML product code generator. Then copy the sample code and paste into your page. Modify the generated code as needed for each additional product.

FrontPage and CoolPage users can simply drag and drop the buttons and set up the processing. A Pageville drop-down menu is added to the menu bar of FrontPage to make the process automated and quick, without any HTML programming.

When a customer clicks on the BUY button, an item is added to that customer's order.

The shopping cart's Checkout function allows customers to make adjustments to the order and enter billing and shipping information. The Checkout screen is not secure and does not ask for credit card information. When the customer clicks on a payment option, control switches to a secure payment site where the credit card or payment account information is entered.

Payment Processing Options

Your customers will enter credit card or payment account information using a secure server link. The payment link can go to a Pageville secure server, or Authorize.Net, Blue Pay, PayPal, or other supported secure server.

A good explanation of how credit card processing works is available at Payment Processing Overview.

If the merchant uses Authorize.Net, Blue Pay, PayPal, 2Checkout or NOCHEX, the funds will be transferred and the merchant will get an e-mail from Pageville. It will not contain the credit card number. The merchant can CREDIT or VOID a payment using the transaction ID.

If the merchant uses Pageville's secure server to obtain credit card information, the information will be retrieved from www.pageville.com using a secure link. The order will be on one server and credit card information will be on another server. The credit card information is saved in a separate secure site which has its own password, allowing the merchant to protect access to the credit card data. Pageville keeps track of the merchant's cookie, including the merchant's computer identification number. If the merchant gives the password to the secure site to someone else, or accesses the site from a different computer, then on the next visit to the site from the merchant's computer, the merchant will be asked if the password has been compromised and should be changed.

Payment Processing Test Mode

Pageville has a payment processing test mode. In test mode, transactions will not be processed through the bank. For Authorize Net and Blue Pay, test mode uses their test mode.

If Test Mode is checked, test mode is used everywhere. When not checked it is still used for Zip/Postal Code 43299. Merchants can test at any time using 43299 while they customers are still in normal operating mode.

You can test Authorize Net or Blue Pay even if your credit card processing is set to "Processed manually off line". If you have entered your Authorize Net Transaction Key it will be used. Otherwise your Blue Pay login code will be used. Zip Code 43299 will use Authorize Net or Blue Pay in test mode. Zip Code 43298 will use Authorize Net or Blue Pay in normal mode. All other zip codes will use the "Processed manually off line" method.

Product Attributes

The Pageville Shopping Cart allows you to easily add attributes for each of the items you sell. For example, if you are selling shirts, your attributes might be size, color, and pattern. You will have a single "BUY" button on your web page. When it is clicked, a selection window will open with a drop-down selection list for each attribute.

Each attribute has a title and options. Enter the various options separated by a | (vertical line, key is near the backspace key).

Example attribute input
Title Method Value Description 1 Dropdown Textarea Radio Checkbox Editable Options Title Method Value Description 2 Dropdown Textbox Radio Checkbox Editable Options Title Method Value Description 3 Dropdown Textbox Radio Checkbox Editable Options Instructions The values for Textarea are rows and columns. If row = 1, then the an input text field is used. The value for Editable is the width of the input field on the screen.
Display in Pop Up Window
	When attributes are used there is always a second step pop up window. This is where the selection is made.
Additional Attribute Features PLUS
	The attribute options can be presented as a Dropdown List (default), Textarea, Radio, Checkbox or Editable. The values for Textarea are rows and columns. Use row = 1 for one line text input. The value for Editable is the text input width. There is a special case if only the Radio method is used. There will be a Close Window checkbox at the bottom unless the quantity is editable. This is necessary because the browser will only bring the popup window to the foreground if focus is set to an input field other than a radio field.
Changing Price PLUS
	An attribute can change the price of the product. This option is only available with the Dropdown and Radio methods. An option that changes the price must start with ADD and then have the price within parentheses. Enter at the beginning of the Options field. The price can be negative. Examples: ADD(126.00)Additional Lights (add 126.00) ADD(-150.00)No Lights (deduct 150.00)
Using Attributes
	Attribute fields are included in the Cool Page and FrontPage Plugins. Otherwise use the Try pages to create button code with attributes.

BUY Button Methods

• Go to Checkout

  When most customers will buy one item and then want to checkout, this method takes them directly to the checkout screen. They do have the option to return and continue shopping.

• Stay Put

  Stay Put is used when your customers will often buy more than one item on a single web page. With this method, when they click on the BUY button, they stay on that web page.

  Three options are available to indicate to your customers that an item has been added to their cart.

  • Show Tally   PLUS   NEW - A count of the items in the cart is displayed. This option shows the tally in a frame window. The following example uses an IFRAME. You could also use a Javascript function. There are 3 parts to set up a tally window:
    

    1. In the Pageville Shopping Cart Editor, in Item Information - set the Frame Checkout Target = "Tally". In version 1.5.159 and later, this will automatically add a Special Command with Name = "StayPut" and Value = "Tally". For versions before 1.5.159, you must set the Special Command "StayPut" equal to "Tally" and set the BUY Button Method to Stay Put or Go to Checkout.

    2. Add HTML code for the IFRAME window:   
    In part 1 you have to option of having the tally window code added to the clipboard. You can use the below code but change the MerchantID to your Shopping Cart ID.
    

    <div style="width: 155px; height: 105px; border-color: #000000; border-style: ridge; border-width: 5px; line-height: 100px; text-align: center;">
      <frame name="Tally" src="http://www2.pageville.com/cgi-bin/shopping.pl?SiteDirectory=shopcart/pvshops/&MerchantID=zsc0087&BuyMethod=StayPut&StayPut=Tally"
        width=150 height=100 scrolling="auto" frameborder="0">
        No items in cart
      </iframe>
    </div>

    3. Log in to your administration page to turn on this option. Go to Merchant Information / Add Options and check the box for Show Tally Window. Set up the checkout button to use and the messages to display. A flashing message can be added to draw attention.

  • Flash buttons - the button text changes when used to add an item to the cart. For example, a "Buy" button becomes "Added to cart".

  • Add Javascript code to indicate when a BUY button has been pressed.

  NOTE: The second 2 choices do not insure that an item has been added to the shopping cart.

• Pop Up   PLUS

  When a customer clicks on a BUY button, a small pop-up window opens or comes to the foreground. One click will close the pop-up window unless:
  1. the quantity or price are editable
  2. there is an optional second item associated with the BUY button
  3. the item has attributes from which the customer must choose
  
    Pop Up BUY windows are used when any of the following are true:
  1. BUY Button Method is Add Pop Up
  2. Quantity can be edited in pop up window
  3. There is a second item with the BUY button and the quantity method for it is either edit or checkbox
  4. There are one or more attributes

  How Buy Pop Up Windows Operate

  1. For the one step process, the window either opens or comes to the foreground when a buyer clicks on a buy button. The pop-up window lets buyer know the item was added to shopping cart. The buyer can click on product page outside the pop up and the pop up will go to the back ground. Or the buyer can close the pop-up window.
  2. For the two step process, the window either opens or comes to the foreground showing the first step content when the buyer clicks on a buy button. The buyer then makes attribute selections or adjusts quantity before clicking on a second BUY button to add the items to their shopping cart.

  Add Image to Pop Up Window

  The special command to add an image to a pop up buy window is itemPopupImage. The value must be the full URL starting with "http://". The special command itemPopupImageLoc specifies the location and can be Left, Right or Bottom.

  Possible Pop Up Problems with Suggested Solutions

  1. Netscape 4.7 Limitations. A pop up window cannot be opened and its contents displayed with a single click unless you have assigned it a form name. For Netscape browsers, the pop up window is opened and placed in the background when the product page is loaded. You can see the pop up quickly appear and disappear.

     Another complication occurs if the buyer closes the Netscape pop up window. If the buyer clicks on another buy button, they must click a second time to display the contents.

  2. FrontPage Preview Limitation - Cannot Bring Pop Up to Foreground. When a merchant using FrontPage clicks on a second buy button while in Preview mode, the pop up window does not come to the foreground. This can be confusing, as the pop up window will come to the foreground once the web page is published.

     To remind the web designer of this FrontPage problem, Pageville places a small notice link at the bottom of the BUY pop up window in certain cases. If the merchant or designer have not gone to their Administration pages since July 2003, all users of the shopping cart will see Notice 1. Otherwise, Notice 2 is displayed because the designer's ISP address and Pageville cookie are known by the Pageville server. When you go through the Administration pages, Pageville records your ISP address and Pageville cookie. Once recorded, this notice link only shows if there is a match on the ISP address and/or cookie. Therefore only the web designer will see the notice links.

     See the notices:

     Notice 1 (Shopping Cart ID zcp0007)

     Notice 2 (Shopping Cart ID zcp0008)

Look and Feel of Shopping Pages

The "Shopping Cart Administration" process and the first screen under "Merchant Information" is used to set up the appearance of the shopping pages.

The following are referred to as the "before payment shopping cart pages":

• Country and zip code entry page
• Attribute selection pages
• Review and checkout page
• Mail / FAX payment method page

The following input fields can be used as described below and all are optional:

• Merchant Name
• Merchant Name Color
• Top of Page Logo
• Top of Page HTML Code

The "Top of Page HTML Code" is only used on the "before payment shopping cart pages". If this field has data, the other fields are not used on the "before payment shopping cart pages".

The "Merchant Name" in the "Merchant Name Color" will be used on the "before payment shopping cart pages" if the other two fields are blank. It will be used on the payment and receipt pages when the Pageville secure payment processor is used.

Frames and Target

The target attribute specifies where the Review and Checkout Page is displayed. You can specify the target for Pageville Buy buttons (in some cases) and Checkout buttons. The target attribute may be required when using frames to display the output in the correct window. The windows name is used as the target value. The target attribute should not be used in Pageville buttons when not using frames unless you want to open another browser for the checkout page.

When using FrontPage, the default window names are "title", "contents", and "main".

Require Approval before Processing

Buyers can be required to check an approval checkbox before checking out. The message after the checkbox can be specified in the "Shopping Cart Administration" process and the first screen under "Merchant Information". A hypertext link can be included. The checkbox can be required in all cases or for just one Item Group Item Group. PLUS

Special Commands  PLUS

Second Product Buying Two Items with One BUY Button Click

A BUY button can put two items into the shopping cart. The default quantity of the second item is added to the shopping cart for the Stay Put button method. This is also true for the Go to Checkout button method for Cool Page and FrontPage Plugins.

For the Pop Up button method, the method for determining the quantity of the second item can be:

• Fixed to a set quantity (normally one).
• Editable with an initial value.
• Checkbox that will add the set quantity if checked.

• item2Add This must exist for item to be added. A checkbox can be used with item2Add to make and item optional.
• item2ID
• item2Description
• item2LongDescription This is only in the pop up windows.
• item2Price
• item2Qty
• item2QtyMethod This can be Fixed, Edit or Checkbox
• item2Extend See Item Extensions

Item Groups

An item can be assigned to a group with an "itemGroup" input tag.

Item Extensions

Item Extensions allow a variety of options with purchased items. Input tags with a name of "itemExtend" is used. You can use several with the same item. The supported values are:

• NoRepeat
• Group=value   (Must precede NoRepeatGroup)
• NoRepeatGroup
• ClearOrder
• MaxOrderQty=value
• MinOrderQty=value
• Currency=value New feature
  value =
  • Code which can be AUD, CAD, DKK, DEM, EUR, etc. followed by a space and then
  • Symbol followed another space and Left or Right
  • Example: CAD CAD Left
• AppendDesc=Message New feature This appends the "message" to the description in color during checkout.
  Example: <font color='#993300'>OUT OF STOCK</font> for OUT OF STOCK

Plugin and Extension Instructions Go to Special Commands Tab in the Plugin. Enter each Extension on a separate line. Use "itemExtend" as the Command Name. Use the above values as the value. Examples:

Command Name	Value
itemExtend	NoRepeat
itemExtend	MaxOrderQty=11
itemExtend	MinOrderQty=20

Copy and Paste Instructions Create additional tags with the tag name of "itemExtend" and the above values as the value. Examples:

<INPUT TYPE=HIDDEN NAME="itemExtend" VALUE="NoRepeat">
<INPUT TYPE=HIDDEN NAME="itemExtend" VALUE="MaxOrderQty=11">
<INPUT TYPE=HIDDEN NAME="itemExtend" VALUE="MinOrderQty=20">

Pop Up BUY Window Image

Display an image in the pop up window. Use the Special Command "itemPopupImage". The value must be the full URL of the image file starting with http://. Specify the location of the image as Left, Right or Bottom with the Special Command "itemPopupImageLoc". The default location is left.

Fractional Quantities

Allow buyers to enter one or more decimal digits for an item. This is enabled by using the Special Command "itemMaxQtyDigits" and the value is the maximum number of digits that will be used.

Pass-Through Commands

Pass-through commands can be used with shopping cart items. When an item is ordered, the command is passed through the Shopping Cart System and stored with the order data. These commands can be used for further processing after payment.

Pageville uses pass-through commands with its shopping cart service BUY buttons. One tag is the Shopping Cart ID. The second is the specific service purchased. Third is the duration of service. When payment is complete these tags are used to immediately update the paid status for the customer's Shopping Cart ID in the database.

We use three itemExtend commands with our shopping cart service buy buttons with values as follows:
"MaxOrderQty=1", "Group=Hosting", and "NoRepeatGroup".

You can have an input tag and use the value in the pass through commands and/or attribute values. For example, we have an input tag, "ShoppingCartID". We use the value with a pass through command:
    <INPUT TYPE=HIDDEN NAME="itemPVCommand" VALUE="PayForMerchantID=<!!ShoppingCartID>">
and a fixed attribute value command:
    <INPUT TYPE=HIDDEN NAME="itemAttribute1Value" VALUE="Shopping Cart ID <!!ShoppingCartID>">

After-Payment Processing  PLUS

A process can be executed after the payment has been processed by AuthorizeNet. Pageville can pass information and/or commands (see Pass-Through Commands above) from our server to the merchant's server. Set up After-Payment Processing in Pageville Shopping Cart Administration (available at www.pageville.com / Log In / Merchant Information).

A hypertext link command is created from the information entered in the Command and Parameters fields. Example:
Command: http://www.digitecs.net/newzport/authtest.php
Parameters: FirstName|LastName|itemDescription|

The hypertext command created from the above command and parameters is:
http://www.digitecs.net/newzport/authtest.php?FirstName=Bob&LastName=Smith&itemDescription=my%20service

To retrieve information captured by the after-payment processing, go to www.pageville.com / Log In / Get Order and Credit Card Information. Use View orders (new method).

• Check Show Additional Detail and click on Get Order to see the available tags and their values.
• Use Search for order to see the parameters if successful or the hypertext link used if not successful.

Retrieving Orders

The Retrieve and Review Orders page manages your access to order data. There are several ways to get to this page:

Two Passwords are used. The first password gives the site owner or web designer access to the shopping cart. The second password can be different, so only the owner has access to customer and payment information.

The Retrieve and Review Orders page starts the retrieve data process. There are several ways to get to this page:

• Start at www.pageville.com and Log In using the first password. Then click on Get Order Information.
• Start at http://www.pageville.com/owner.html and enter the Shopping Cart ID and the second password.
• Start at a special page the designer creates on the owner's web site that is similar to owner.html. The Shopping Cart ID should be a hidden field so the owner only needs the second password.
• Start at the top menu bar for the Pageville Plugin in Front Page. Use the second password.
• Start at the top menu in the Pageville Shopping Cart editor. Use the second password.

The Owner Results Page is the next step. On this page you can:

• Set or Change password and hint. This is the second password.
• View paid orders including credit card information. Will be replaced by Basic 2005.
  Currently required for payments using:
  • Manual credit card processing
  • PayPal
  • Blue Pay
  • Mail, phone, fax.
• View orders BEFORE the payment (excluding credit card information). Will be replaced by Basic 2005.
  • Manual credit card processing
  • PayPal
  • Blue Pay
  • Mail, phone and fax
• View orders   Basic 2005
  • Manual credit card processing
  • Authorize Net
  • PayCash
  • Blue Pay
  • 2CheckOut
  • NOCHEX
  • Mail, phone and fax

Shopping Cart Basic 2005 Features

The Basic 2005 Shopping Cart Service has all the features of the Basic 2002 service plus the following:

• Improved checkout layout
• Support for CVV credit card code
• Upgraded methods for (1) displaying receipt, (2) saving order information and (3) retrieving order information.
• View and print orders for three full months plus current partial month.
• Link to a page where customers can re-display and print receipt pages. The merchant Shopping Cart ID, the order number and the customer's zip code are required.
• There is an option to have a county field on the checkout page.

  Basic 2005 shopping cart service price is $129 per year. The Basic 2002 service will be discontinued. Pageville will upgrade current Basic customers to Basic 2005 at no charge. The next time you renew your shopping cart, you will be charged $129.00 for Basic service. For even more features, see our PLUS service.

  When you switch to the new method of "retrieving order information", there will be a change in the way you get new orders. Select the NEW METHOD for the new orders.

  If change from Basic to Basic 2005, you should go to the administration page and scroll down to "Add Options". Then check "New checkout layout" and "Use new method for (1) displaying receipt, (2) saving order information and (3) retrieving order information".

 

Shopping Cart PLUS Features

• Shipping cost based upon destination, method, and weight
• Product attributes that change the price
• Textarea, Radio, Checkbox or Editable attribute selection methods
• Buying Two Items with One BUY Button Click
• Pop Up Buy button method (indicates to customer that an item has been added to their order)
• Special Commands
• Improved checkout layout
• Improved design control of top of checkout and receipt pages
• Check box option prior to payment
• Add Image to Popup Buy Window
• Pass-Through Commands
• After-Payment Processing
• Predefined Attributes COMING SOON
• Coming Soon   Easily handle additional charges to a credit card processed through Authorize Net. Click on the Get Payment Information button. Use the "Additional Charges" button on the next screen. The values that were used previously will be the default values on the form. You can edit the amount field.

Shopping Cart PLUS Processing Service is $199.00 per year. The PLUS service has all the features of the Basic 2005 service, PLUS the features above.

---

© 2000-2005 Arlington Web Services, Inc.