How to integrate DBiz into your website

DBiz is a Silverlight eCommerce application that can integrate into any website. There is therefore no need to change your design, DBiz will fit in.

1. Create a new Page that will host your eCommerce

Use your site header, footer and side bar. DBiz just needs about 730px wide.

2. Place an object tag within a DIV

As previously mentioned DBiz runs on your site. You will be given a number of files with extensions such as .XAP and .DLL; these are all Microsoft Silverlight 4.0 files. The main file is called ShopCart.xap and should be placed in a directory called "ClientBin" along with the other files provided. Here is a sample DBiz Silverlight object tag:

<object data="data:application/x-silverlight-2," type="application/x-silverlight-2" width="730px" height="800px">
 <param name="source" value="ClientBin/ShopCart.xap"/>
 <param name="enablehtmlaccess" value="true"/>
 <param name="onError" value="onSilverlightError" />
 <param name="background" value="white" />
 <param name="minRuntimeVersion" value="4.0.50401.0" />
 <param name="autoUpgrade" value="true" />
 <param name="initParams" value="ProductsUrl=http://demo.dbiz.com.au/Products.htm,ShowProductsLines=N,Company=DBizDesign,AutoSearch=Y,CrossDomain=Y,CrossDomainUrl=http://www.dbiz.com.au/dbizdesign/xml/gbizxml.asmx" />
 <a href="http://go.microsoft.com/fwlink/?LinkID=149156&v=4.0.50401.0" style="text-decoration:none">
  <img src="http://go.microsoft.com/fwlink/?LinkId=161376" alt="Get Microsoft Silverlight" style="border-style:none"/>
 </a>
</object>
<iframe id="_sl_historyFrame" style="visibility:hidden;height:0px;width:0px;border:0px"></iframe>

THAT'S YOUR INTEGRATION COMPLETE! Now to the fine tuning.

3. DBiz initParams

The DBiz eCommerce application supports a number of initParams which are basically initialization parameters; they are critical to the correct functioning of your application:

1. ProductsUrl: determines which page to show when user clicks "1. Products". Leave blank/omit completely if you wish to use the in-built DBiz search engine/Products list.
2. ShowProductsLines: determines whether to show vertical lines in the DBiz Search Engine/Products list.
3. Company: used in certain user messages.
4. AutoSearch: determines whether a list of items is displayed immediately in DBiz Search Engine/Products list or whether the user has to click find before anything is displayed.
5. CrossDomain: usually Y (Yes). This enables the application to be hosted on your website.
6. CrossDomainUrl: this is the internet address that is used to retrieve the data. GMG Software will assign you the address to use for your company.

4. Navigating the application

Assuming the DBiz application is nested in a WebPage called Shopping.htm, Designers can dictated which DBiz screen is shown by adding the following to the end of the link:

#/Login =>Login Page

#/Products =>Search Engine/Products List

#/Review =>Displays what is in the Shopping Trolley and gives users a chance to amend the shopping list

#/Checkout =>Creates an invoice for all the items in the shopping trolley

#/Payment =>Allows credit card payment of outstanding invoices

#/MyDetails =>User details such as name, contact details and shipping address

for example placing a link to navigate to the login page would simply be Shopping.htm#/Login

5. Add to Cart from anywhere on the site

Designers may want to customise each product page and display a link or button of their choice to add the item to the cart.
This can be achieved by including certain parameters to the link:

1. TrolleyProductAdd: Assigning Y activates the functionality
2. TrolleyProductId: Determines the exact item to add to the shopping trolley
3. TrolleyProductCount: Determines how many of the above item to add to the shopping trolley

for example a link could be:

Shopping.htm?TrolleyProductAdd=Y&TrolleyProductId=15&TrolleyProductCount=2#/Review

The above takes the user to the Shopping.htm webpage, adds 2 products (item 15) to the user's cart and displays the contents of the shopping trolley.