Assigning Cross Sell and Upsell Items to a Catalog Entry

1. Open the catalog folder containing the catalog entry to which you want to assign cross sell items.
2. Click that entry.
3. Click View > Cross Sell or Up Sell.
   

   

4. Click Add. A screen displays all catalog folders.
5. Open the folder that contains the cross sell or upsell catalog entry.
6. Click that catalog entry.
7. Click OK.
8. Enter additional cross sell entries as needed.
9. Choose Action > Save.

Displaying Cross Sell and Upsell Items on Your Web Site

Use the Recommendation Server Control to place cross sell or upsell items anywhere on a Web page. A single control can only show either cross sell or upsell items.

Enabling the Add to Cart Button

Customers can add a product to their cart directly from the Recommendation server control by clicking Add to cart next to a product. This link appears below the price and allows them to skip the product’s information page and add the product directly to their cart.

By default, this button appears when the following conditions are met:

• The product is buyable. That is, there is a check mark in the Buyable property for a product in the Workarea. See Also: Creating a Catalog Entry
  

  

• The product has an In Stock quantity of at least one.
  

  

• The TemplateCart property has a cart’s template location defined.

In addition, if a product has an alias path associated with it, you need to:

• Make sure the TemplateCart property’s path is relative to the site root. For example:

  TemplateCart="Developer/Commerce/CartDemo.aspx"

• Add the following to the code-behind page. This example is in C#:

  protected void Page_Init(object sender, EventArgs e)
  {
    Utilities.RegisterBaseUrl(this.Page);
  }

Recommendation Server Control Properties

The following are Ektron-specific server control properties. You can find information about native .NET properties such as font, height, width and border style in Visual Studio^® help.

• Authenticated (String)

  Indicates if you are logged into the CMS Explorer and can use it to browse to content, collections, and so on. See Also: Browsing Your Ektron Site Using CMS Explorer.

• CacheInterval (Double)

  The number of seconds that the server control’s data is cached. The default is 0 (zero). For example, if you want to cache the data for 5 minutes, set to 300. See Also: Caching with Server Controls.

• CustomXml (Code-behind Only) (String)

  Lets you inject custom XML into the generated XML before being processed by the XSLT. Enter a string of XML that you want to make available to the XSLT as follows:

  <root><customXml>custom-xml-inserted-here</customXml></root>

  See Also: Displaying Custom XML in Ektron’s Server Controls.

• DefaultProductID (Integer)

  Enter a default product ID that contains either cross sell or up sell products. To make the server control dynamic, enter zero (0) in this property and set the DynamicProductParameter to QueryString parameter used to pass the product’s ID.

• DisplayXslt (String)

  If desired, enter a relative or absolute path to an Xslt that determines the display of the page. By default, the control uses Recommendation.xsl. This file is located in siteroot\Workarea\Xslt\Commerce

  WARNING! If you specify an external file, do not store this file in the Workarea folder. If you store this file in the Workarea folder, the file will be lost when you upgrade.

• DoInitFill (Boolean)

  By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, Fill is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in code-behind and have it render with your changes shown.

• DynamicCartParameter (String)

  The QueryString parameter name which is used to pass the product ID to the Cart server control. For example, if your QueryString parameter for products is Product, enter that in this property. Then, when customers click Add to Cart, this parameter is passed with the product’s ID Web form containing the Cart server control. See Also: Cart Server Control

• DynamicProductParameter (String)

  The QueryString parameter name which is used to pass the product ID to the product details page. For example, if your QueryString parameter for products is ID, enter that in this property. Then, when customers click a product’s title, this parameter is passed with the product’s ID to the product details page.

• Hide (Boolean)

  Hides or displays the output of the control in design time and run time.

  • True—Hide the control output.
  • False—Display the control output.
• Language (Integer)

  If the template on which this server control resides includes a language selection control, and you want to let the customer select the language, enter zero (0). Otherwise, click the field, then the ellipsis button () and a popup box appears. Select a language from the list. This property shows results in design-time (in Visual Studio) and at run-time (in a browser).

• PageSize (Integer)

  Specify the number of items to show per page when a customer views recommendations. If the number of items exceeds the quantity defined in this property, the list is paged and the customer can use the paging navigation system to move through the list.

• RecommendationType (EkEnumeration.RecommendationType)

  The type of recommendation to show. Choices are:

  • CrossSell—used to help sell additional products that a customer might be interested in. For example, if you are selling Denim Jackets, you might want to cross sell them pants or shirts.
  • UpSell—used to sell additional products that improve on the product being purchased. For example, if you are selling 7 megapixel digital cameras, you might want show the customer 10 megapixel digital cameras.

  See Also: Adding Cross Sell and Upsell Recommendations to a Catalog Entry

• Stylesheet (String)

  Specify the path to a style sheet for use with this server control. The location can be relative or absolute. Leave blank to use the default style sheet. For example: Workarea\csslib\mytest.css.

• SuppressWrapperTags (Boolean)

• Suppresses the output of the span/div tags around the control.

  • True—Suppress wrap tags.
  • False (default)—Allow wrap tags.
• TemplateCart (String)

  The URL to navigate to when a customer clicks Add to Cart. The path can be relative or absolute. When a path is entered, the Add to Cart button appears next to the product and allows a customer to add the product directly to their cart. See Also: Enabling the Add to Cart Button and Cart Server Control.

• TemplateProduct (String)

  Specify the URL that contains the Product server control. This allows a customer to see the details of the product when the product link is clicked. The path can be relative or absolute.