CyberOffice eCommerce Platform Online References
© SmartWin Technology, 1997-2000

Please click on a menu on the left panel for instant help related to the function...

If you are new to CyberOffice eCommerce Suite, you might want to click on the one of the general topics related to CyberOffice Shopping Cart (CyberShop). Click to download a full in-depth development guide.

Also included here are online references for CyberOffice Club (CyberClub) and CyberOffice Warehouse Builder (CyberBuild) (their managment has been integrated into Shop Manager).

Installation Sample Codes Sample Page

Complete On-site Shop Manager
(User Name = Administrator, Password = Password)

Installation

We strongly recommend that you install and test CyberShop under Microsoft Personal Web Server (PWS). PWS comes with Windows 98/NT (Un-install FrontPage 97/98 and re-install it after PWS). Then upload the folders (/_private, /cgi-bin, and /shopping_cart by default) to your Web site. The link to the Shop Manager is [Your site]/Shopping_Cart/Shop_Main.htm.

CyberShop relies on an ActiveX component CyberShop.Dll (in /cgi-bin directory). Before it can function Microsoft Active Server Page (ASP) must be enabled and a system administrator must register the component by:

  1. Open: VB5_run.htm with Internet Explorer.
  2. Run: Regsvr32.Exe [physical path]\CyberShop.Dll.
  3. Set: Execution Permission on CyberShop for IUSR_XXX.
  4. Set Full Control Permission on  /_private folder for Everyone.
  5. Set /_private folder hidden from browing via FrontPage Explorer or IIS managment. Namely remove the Read permission of the folder.
  6. If the database(s) is moved from /_private to /fpdb folder, change the DBQ field in the config.asp file to point to the new folder.

Repeat Steps 2 and 3 for CyberClub.Dll and/or CyberBuild.Dll if the corresponding packages are used in your application.

If you are running Windows 2000, please upgrade the underlying database(s) into Access 2000 or SQL Server. Check the event log to fix any permission problems on any DLLs.

Contact Us if your ISP prohibits custom components (and we will refer you to reliable ISPs that support CyberShop).

Authorize.Net: Real-time payment has been pre-configured and is a few seconds away from activation. Get an account with Authorize.Net first. Then simply fill in the Login name in the Authorization Parameters (under Global/System Settings).

VeriSign's Playflow Link and Pro have been fully integrated.

Australia users can use eSec (www.aba.net.au) for real-time payment. The software has been pre-configured to work with both Java and SSL versions of their system. Server-side "Settlement Solutions" by Telstra  (www.eckit.com)  has also been implemented.

We also supports many other payment agents. Contact us for more information.

Go Back | Back-to-Top
Sample Codes

Idiot-Proof Coding

Add your product information to the Inventory Table under Shop Manager --> Inventory Managaer. Then insert

<script src="view_product.asp?ProductID=myproduct"></script>

into a Web page to display the item. Here myproduct is the product reference code. In addtion, use

<script src="view_product.asp?ProductID=-search-"></script>
<script src="view_product.asp?ProductID=-viewcart-"></script>

to display a search box and "view cart" button on any page.

Please qualify view_product.asp with a full domain name + folder.

Adding Affiliate

To track the referal from another site, simply insert the following code to any page that wishes to
claim the referral.

<script src="affiliate.asp?id=site_id"></script>

You should qualify "affiliate.asp" with the full domain + path. and modify the "id" variable for each referral site. If you are using an old shopping_cart.mdb database, you need to add "Affiliate" field to both the Customers and the SessionCustomers Tables. This will collect the information. You also need to update the "checkout.asp" page.

Manually Coding

CyberShop uses a universal HTML form to interface with any shopping pages on your site. When a visitor clicks on the "Add Item" button, the product is added to and displayed in a shopping cart. From there the software takes care of everything for you.

There are five basic attributes for each shopping item:

ProductID, ProductType, ProductDesc, Quantity, Price

You need simply to fill in the "values" as illustrated below:

Add Item

<form method="POST" action="view_cart.asp">

<input type="hidden" name="ProductID" value="SW-CLOTH-010">
<input type="hidden" name="ProductType" value="CLOTH">
<
input type="hidden" name="ProductDesc" value="LINEA ESTIVA JACKET SIZE: M">
<
input type="hidden" name="Quantity" value="1">
<
input type="hidden" name="Price" value="35.00">
<input type="hidden" name="DestEmail" value="ychen@bigpond.com">

<p><input type="image" src="additem.gif"> </p>

</form>

View Cart:

<form method="POST" action="view_cart.asp">

<p><input type="image" src="viewcart.gif"> </p>

</form>

Additional fields can be used for a greater control of the shopping cart / page:

TaxRate Used to specify import tax rate. If present, will activate the Tax Exempt form.
BaseQuantity Used to specify the number of components in a package items. This information is used for shipping fee calculation.
PriceUnit Specifies the currency symbol displayed in the shopping cart. Can also be set with Global / System Settings.
Background Specifies the URL for the background image of the shopping cart. Can also be set with Global / System Settings.
BgColor Specifies the background color, e.g. #FFFFFF, for the shopping cart. Can also be set with Global / System Settings.
DestEmail Used to specify the email address to which the  shopping orders should be forwarded.  Can also be set with Global / System Settings.
Coupon Specifies the coupon to be used for a particular shopping item(s). When present it will  pre-fill the coupon code field on the popup coupon sheet.
GoBack Specifies the page that "Back to Shop" link on the shopping cart pages will point to. Useful when using CyberShop with frames.
Point Tell CyberShop how many points are required to redeem the product via CyberOffice Buyer's Club points earned through previous purchases.
Bonus Bonus points for CyberOffice Club for that product.
Download Store the file(s) to be downloaded after payment. Mainly for real-time paid services. Multiple files separated by ",".

View Order Status / Shipping Fee:

The page on which customers can view their order status is view_status.asp. You should put a link to this page on your Web site. Another useful page is view_shippingfee.asp which exposes the shipping-fee settings in CyberShop.

Stock Level / Shopping Cart Monitoring:

CyberShop lets you monitor in real-time the stock level of your inventory. Typically, you would add your product items to CyberShop via Stock Monitoring. Then you simply call in your HTML pages,

<script src="view_stock.asp?ProductID=myproduct"></script>

where myproduct is the product reference code. Be sure to qualify "view_stock.asp" with the appropriate domain and path.

Special products: "-qty-",   "-amount-", "-point-" can be used to return the current contents of the shopping basket. Namely you can insert the following two codes on your shopping pages to display the information (see the sample page),

<script src="view_stock.asp?ProductID=-qty-"></script>
<script src="view_stock.asp?ProductID=-amount-"></script>
<script src="view_stock.asp?ProductID=-point-"></script>


Tip: More than one fields with the same name can be used in your shopping page. For example, if a shopping item consists of multiple components and each component has  multiple choices, you can use a set of HTML <select name="ProductDesc"> tags to accomplish the task. The final value passed to the shopping cart will depend on the customer's choices.

Go Back | Back-to-Top

  Any comments/suggestions? Send to  support@smartwin.com.au

Last Updated: January 01, 2002
© 1997-2002 SmartWin Technology. All rights reserved.