eSeller Cloud Content Controls
This is an overview of all available eSeller Cloud content controls.
All content controls must at least have the attributes "ControlType" and "ControlID". It is individual to each control which attributes are otherwise available and/or required. Note that content controls cannot be added to design template definitions.
Example:
<eSeller:Control ControlType="..." ControlID="..." />
All pages
| SearchBox | Renders a SMART search field with a button. Supports displaying results and suggestions for products, product menus and CMS menus. The settings specified by the attributes (and more) can be configured from shopadmin by configuring the control in the "Elements" tab of the content design. |
| LocationSelector | Allows customers to change location in the shop if locations are supported. Inserting the control using the Mode="json" attribute allows you to access information about the active location (such as address and opening hours) as a JSON object which can be accessed via the variable 'locationList'. |
| SpecialOpeningHoursInfoControl | Renders the special opening hours for the current year. Displays the date, opening hours and an optional message. |
| NormalOpeningHoursInfoControl | Renders opening hours for the current week of (Monday - Sunday). Displays day, date and opening hours in the format HH:MM - HH:MM. Special opening hours overwrite the normal opening hours. |
| ShopMenu | This control gives access to the entire menu structure. ShopMenu is capable of rendering different kinds of menus (product menus and CMS menus). Moreover, it renders the entire menu tree, which makes it possible to avoid postbacks when navigating in the tree. |
| CustomerLoginPasswordReminder | This control allows login customers reset passwords by receiving an e-mail with a link to a password reset page (using the CustomerLoginPasswordReset control). Renders an input field for the customer e-mail to which the reset-link will be sent. |
| CustomerLoginPasswordReset | This control allows login customers to change their password. Renders an input field for the customer e-mail as well as two input fields for new password and repeat new password. |
| ContactForm | Renders a simple contact form with input fields for e-mail address and message.
The message is sent as an e-mail to the address that also receives copies of order confirmation mails (Specified under Base setup > Company info > Email addresses in the shop administration). |
| GenericButton | Renders a button/link/shop icon which can trigger an action on another control. This control has no functionality in itself, but must be used in conjunction with another control. |
| SalespersonLogin | Renders a login form and a button for sales persons. |
| SalespersonLoginPasswordReminder | This control allows salespersons to reset their password by receiving an e-mail with a link to a password reset page (using the SalespersonLoginPasswordReset control). Renders an input field for the salesperson e-mail to which the reset-link will be sent. |
| SalespersonLoginPasswordReset | This control allows sales persons to change their password. Renders an input field for the sales person e-mail as well as two input fields for new password and repeat new password. |
| CustomerLogin | Allows login-customers to log in to the webshop. Displays login fields for username and password and a button. Only usable if customer logins are enabled in the shop settings. |
| ProductList | Displays a product list with product name, image and price as well as links to product detail pages. |
| JsonProductList | Displays a product list using JSON. Supports product sorting and product filters. |
| BasketSelector | Enables the customer to view all baskets if the shop supports multiple baskets. Displays a table of all existing baskets. The customer can select which basket is active and is furthermore able to delete baskets. If this control is used in conjunction with the BasketEditor control, the customer will also be able to edit the name of existing baskets in the table. |
| BasketEditor | Enables the customer to edit the name of existing baskets displayed with the BasketSelector control. The BasketEditor control also enables the customer to create and name new baskets which will then be displayed in the table rendered by BasketSelector. |
| NavigateButton | Displays a button/link/icon to use for navigational purposes in the shop. Can navigate through menus, URLs and bookmarks. |
| GiftCardLookUp | Displays an input field in which the customer can enter a gift card code an view details about the gift card. |
| RedeemGiftCard | Displays an input field in which the customer can enter a gift card code and redeem the gift card. |
| GiftCardHistory | Displays a table / divs with the transaction history of a gift card. |
| CustomerSelector | Displays a list of customers associated with the logged-in salesperson. Enables the sales person to select a customer for whom to place orders etc. |
Product pages
| ShipmentFreightCalculationPrompt | Renders a prompt where the customer can enter a zip code and calculate the delivery fee of a product based on the product weight and the entered zip code. |
| ProductFilteringControl | This control allows customers to filter product lists by product specific filters (e.g. price), variant based filters (e.g. color) and/or custom field based filters (e.g. country of origin). The control renders as a list of filter values with check boxes which manipulate (filter) the product list when they are checked/unchecked).
|
| ProductSortingList | Renders a drop-down/radio button list/anchor list which the customer can use to sort a product list by different parameters such as price or product name.
|
| ProductConfiguration | Enables the customer to configure a product on the product detail page (only applicable to configured products). |
| ManufacturerLogo | This control renders the logo of the manufacturer on the product detail page as an <img> element (if a manufacturer with a logo is specified for the product). |
| EnhancedVariantSelector | Makes it possible for customers to select a particular variant of a product on the product detail page. Displays a drop-down list for each variant dimension. If there is more than one variant dimension, and the customer selects a value in the first drop-down list (dimension), the shop will automatically select the first available dimension value in the next drop-down list. |
| VariantSelector | Makes it possible for customers to select a particular variant of a product on the product detail page. Displays a drop-down list for each variant dimension. |
| StockStatus | Displays a text or an icon representing the stock status dependent on how the control is configured in the shop administration. |
| ProductImages | Displays the product images at the product detail page. Can be configured from the shop administration. |
| Productprice | Displays the product price on the product detail page. |
| VariantMatrix | Displays a matrix of variants of the product on the product detail page. Only applicable to variant products. |
| ProductDocuments | Displays a list of links to product documents - used on the product details page. |
Basket and check-out
| CouponCode | Allows customers to enter a coupon code in the check-out process and thereby receive a
discount specified by the shop administrator. |
| GoogleAnalyticsTracking | Renders javascript to provide info to Google. Must be places at the order confirmation in ShopFront. Requires a Order as datasource. |
| OrderConfirmationAttachment | Can be placed either in the design of the order confirmation mail or of the order confirmation page in the shop. Allows customers to download attachments that will be enclosed with the order confirmation mail and/or order confirmation page. Is rendered as a list of links to documents. |
| OrderLeadTimePicker | Renders a date input field and a drop-down containing available pick-up times in order check-out. Is only applicable to delivery methods that use the delivery system "Collect At Store". |
| OrderDetails | Displays the details (order lines) of an order in a <table> element. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers. |
| OrderTotals | Displays the order totals of an order in a <table>. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers. |
| OrderShipmentMethod | Displays the shipment method used for an order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers. |
| OrderPaymentMethod | Displays the payment method used for an order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers. |
| OrderingRemarks (Order) | Displays order remarks of an order if the customer has written any when placing the order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers. |
| OrderShipmentAddress | Displays the delivery address of an order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers. |
| OrderPaymentAddress | Displays the payment address of an order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers. |
| DeliveryDateSelectDropdown | Displays a drop-down list which enables the customer to select a desired delivery date during checkout.
This controls works with the delivery calendar if one is set up. |
| ShipmentMethodSelectRadioButtonList | Allows the customer to select a delivery form in checkout.
Renders a list of radio buttons, each representing an available delivery form. |
| ShipmentMethodSelect | Allows the customer to select a delivery form in checkout.
Renders a drop-down list containing the available delivery forms. |
| PaymentMethodSelectRadioButtonList | Allows the customer to select a payment form in checkout.
Renders a list of radio buttons, each representing an available payment form. |
| PaymentMethodSelect | Allows the customer to select a payment form in checkout.
Renders a drop-down list containing the available payment forms. |
| ShipmentAddressCheckbox | Allows the customer to specify a delivery address in checkout (useful if this is different from the payment address). A checkbox with a label is rendered. The ShipmentAddress control should be used to display input fields if this box is checked. Note that the checkbox is disabled, if the selected delivery method is of type "collect-at-store". |
| OrderingRemarks (Basket input field) | Allows the customer to enter a comment or remark during checkout when placing an order. Displays a <textarea> element in which the customer can enter some text. |
| ShipmentAddress | Allows the customer to enter a delivery address in checkout. Only fields that have been activated in the shop administration under Settings > Customers > Customer information are displayed. |
| PaymentAddress | Allows the customer to enter a payment address in checkout. Only fields that have been activated in the shop administration under Settings > Customers > Customer information are displayed. |
| AddressLookup | Allows the customer to enter a phone number and have the payment address filled out based on a lookup of this number. Renders an input field for entering a phone number. |
| BasketTotals | Displays basket totals including subtotal, delivery fee, total and VAT amount. This control can be used at basket and checkout pages. |
| BasketMessages | Displays info messages from the basket which relates to actions in the basket, e.g. "Product is added to the basket". Messages are only displayed once and disappear automatically after having been displayed. |
| BasketDetails | Displays the basket contents in a table including product name, product image, unit price and total price. Moreover, it is possible to update quantity of products in the basket as well as remove products from the basket. |
| AcceptTerms | This control displays a checkbox and a text label, which the customer must check in order to complete an order on the shop, thereby accepting the terms and conditions. If the customer tries to complete an order without checking this box, the customer will be prompted to check it to continue. |
| BasketActionButton | Displays a navigational button/link/icon to use with the basket. |
Customer pages
| InvoiceOverview | Allows the customers to view a list of their invoices. The list contains links to a page displaying
details of the invoice. In the shop settings (under "Customer") the bookmark of this detail page must be set. Per default this is set to "bookmark:invoiceDetails". The page displaying invoice details must use this bookmark. |
| InvoiceDetails | Allows the customers to view the details of an invoice (quantity, item number, item description (name), unit price and total). price) |
| InvoiceTotals | Allows the customers to view the totals of an invoice (Subtotal, VAT and Total). |
| OrderList | Displays a list of orders placed by the customer (only when logged in as the customer or as a sales person representing the customer).
A link to order details is rendered for each order in the list. |
| OrderToBasketSpecific | Enables the logged-in customer to reorder previously placed orders by adding the order lines to the basket. Renders a button that adds the lines to the basket. Is typically placed at the order detail page or at the order confirmation page. |
| CustomerEditor | Renders input fields for the logged-in customer to edit his information. |
| CustomerCreatorSimpel | Renders a checkbox with a label and input fields for username and password so that the customer can
create a log-in user during checkout. |
| ResendCustomerLogin | |
To the topCouponCode
Allows customers to enter a coupon code in the check-out process and thereby receive a
discount specified by the shop administrator.Example
<eSeller:Control ControlType="CouponCode" ControlID="CouponField" />
<eSeller:Control ControlType="GenericButton" ControlID="CouponButton" Text="Submit" WorksOn="CouponField" ButtonType="Button" />
Notes: This control should be used with GenericButton
Attributes
| Name | Value | Description |
|---|
| ControlType | CouponCode | Defines the control type |
| ControlID | couponCodeControl | Defines ID of this particular control |
| CssClass | Any valid CSS class name | Class of the <input> field |
To the topSearchBox
Renders a SMART search field with a button. Supports displaying results and suggestions for products, product menus and CMS menus. The settings specified by the attributes (and more) can be configured from shopadmin by configuring the control in the "Elements" tab of the content design.Example
<eSeller:Control ControlType="SearchBox" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | SearchBox | Defines the control type as SearchBox |
| ControlID | String | Defines ID of this particular control |
| SearchResultCount | Integer | The number of instant search suggestions displayed |
| ImageSizeTypeID | ID of the desired image size type. | Defines the size of product/menu images displayed in suggestions. |
| ProductNameLength | Integer | The maximum number of characters of the product name that can be displayed in suggestions. If the name
exceeds this limit, the text gets truncated. |
| IsAutocompleteEnabled | "True" or "False" | Defines whether suggestions are enabled. |
| IsImageDisplayed | "True" or "False" | Defines whether product/menu images are displayed in suggestions. |
| TextLengthBeforeSuggestionFired | Integer | The number of characters the customer must type before suggestions are made - e.g. "3". |
| SuggestionFooterText | String | Text displayed at the bottom of suggestions. Use the parameter [NUMBER_OF_HITS] to display the total number of results. - e.g. "See all [NUMBER_OF_HITS] search results. |
| Scoring | Double | Defines the minimum score a search result must have in order to be considered a result. |
To the topGoogleAnalyticsTracking
Renders javascript to provide info to Google. Must be places at the order confirmation in ShopFront. Requires a Order as datasource.Example
<eSeller:Control ControlType="GoogleAnalyticsTracking" ControlID="..." DataSourceId="Order" />
Notes: Requires shop configuration "PartnerProgram.GoogleAccount" to be configured correctly to provide any output.
Attributes
| Name | Value | Description |
|---|
| ControlType | GoogleAnalyticsTracking | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | ID of <eSeller:Data> control that supplies the order information | ID of <eSeller:Data> control that supplies the order information |
To the topInvoiceOverview
Allows the customers to view a list of their invoices. The list contains links to a page displaying
details of the invoice. In the shop settings (under "Customer") the bookmark of this detail page must be set. Per default this is set to "bookmark:invoiceDetails". The page displaying invoice details must use this bookmark. Example
<eSeller:Control ControlType="InvoiceOverview" ControlID="..." DataSourceId="Invoice" InvIdKeyName="InvoiceID" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | InvoiceOverview | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InvIdKeyName | String | A key that must be used on the invoice details page by a eSeller:Data control of DataType "InvoiceHead" to link together the invoice list page and invoice details page. |
To the topInvoiceDetails
Allows the customers to view the details of an invoice (quantity, item number, item description (name), unit price and total). price)Example
<eSeller:Control ControlType="InvoiceDetails" ControlID="..." DataSourceId="Invoice" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | InvoiceDetails | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | ID of <eSeller:Data> control that supplies the invoice information | ID of <eSeller:Data> control which has the DataType "InvoiceHead" |
To the topInvoiceTotals
Allows the customers to view the totals of an invoice (Subtotal, VAT and Total).Example
<eSeller:Control ControlType="InvoiceTotals" ControlID="..." DataSourceId="Invoice" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | InvoiceTotals | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | ID of <eSeller:Data> control that supplies the invoice information | ID of <eSeller:Data> control which has the DataType "InvoiceHead" |
To the topOrderConfirmationAttachment
Can be placed either in the design of the order confirmation mail or of the order confirmation page in the shop. Allows customers to download attachments that will be enclosed with the order confirmation mail and/or order confirmation page. Is rendered as a list of links to documents.Example
<eSeller:Control ControlType="OrderConfirmationAttachment" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderConfirmationAttachment | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | String | ID of <eSeller:Data> control which has the DataType "Order" |
| CssClass | Any valid class name. | Adds the class to the <ul> element. |
To the topLocationSelector
Allows customers to change location in the shop if locations are supported. Inserting the control using the Mode="json" attribute allows you to access information about the active location (such as address and opening hours) as a JSON object which can be accessed via the variable 'locationList'. Example
<eSeller:Control ControlType="LocationSelector" ControlID="..." Mode="html" />
Notes: When url which leads to page with that control containes 'returnUrl' parameter that it will be used as base for picking location.
Attributes
| Name | Value | Description |
|---|
| ControlType | LocationSelector | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| Mode | "json" or "html" | json: The global variable 'locationList' is set, which contains a list of objects (LocationName As String, LocationUrl As String). html: A simple list with links that navigate to the locations. |
To the topSpecialOpeningHoursInfoControl
Renders the special opening hours for the current year. Displays the date, opening hours and an optional message.Example
<eSeller:Control ControlType="SpecialOpeningHoursInfoControl" ControlID="..." LocationID="214" />
Notes: This control only displays special opening hours for the current year.
Attributes
| Name | Value | Description |
|---|
| ControlType | SpecialOpeningHoursInfoControl | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| LocationID | Ext ID of a Location | If this attribute is not set, the special opening hours for the currently active location will be displayed. It can be said to specify a certain location for which the special opening hours should be rendered |
To the topNormalOpeningHoursInfoControl
Renders opening hours for the current week of (Monday - Sunday). Displays day, date and opening hours in the format HH:MM - HH:MM. Special opening hours overwrite the normal opening hours. Example
<eSeller:Control ControlType="NormalOpeningHoursInfoControl" ControlID="..." LocationID="214" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | NormalOpeningHoursInfoControl | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| LocationID | Ext ID of a Location | If this attribute is not set, the opening hours for the currently active location will be displayed. It can be said to specify a certain location for which the opening hours should be rendered |
To the topOrderLeadTimePicker
Renders a date input field and a drop-down containing available pick-up times in order check-out. Is only applicable to delivery methods that use the delivery system "Collect At Store". Example
<eSeller:Control ControlType="OrderLeadTimePicker" ControlID="..." InputMode="Updatable" IsRequired="True" Interval="Thirty" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderLeadTimePicker | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | Accepts one of the following values: "Default", "Updatable", "ViewOnly", "Protected" | Defines whether the customer can change the values of the input fields |
| IsRequired | "True" or "False" | Defines whether the customer must fill out the input fields |
| Interval | Accepts one of the following text values: "Fifteen", "Thirty", "Sixty" | Defines the interval (in minutes) between pick-up times in the drop-down |
To the topShipmentFreightCalculationPrompt
Renders a prompt where the customer can enter a zip code and calculate the delivery fee of a product based on the product weight and the entered zip code. Example
<eSeller:Control ControlType="ShipmentFreightCalculationPrompt" ControlID="..." />
Notes: This control can only be used with delivery forms that use Consignor as the fee calculation method.
Attributes
| Name | Value | Description |
|---|
| ControlType | ShipmentFreightCalculationPrompt | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topThis control gives access to the entire menu structure. ShopMenu is capable of rendering different kinds of menus (product menus and CMS menus). Moreover, it renders the entire menu tree, which makes it possible to avoid postbacks when navigating in the tree. Example
<eSeller:Control ControlType="ShopMenu" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ShopMenu | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| MenuType | Accepts one of the following text values: "Product", "InfoMenu1", "InfoMenu2", "InfoMenu3", "InfoMenu4", "TopMenu", "Bookmark" and "Current" | Specifies which type of menu to render. Bookmark and Current menu have special meaning: Specifying "Current" means that the currently active menu is used as the starting point, i.e. rendering child menus for this menu. The actual menu type is derived from the current menu.
As the MenuID parameter is implicitly set to the ID of the current menu, this parameter must be left blank or omitted. If specified, the shop yields an error. When specifying a Bookmark the MenuID attribute specifies what bookmark to look for, implicitly dictating the type of menu to traverse. |
| MenuID | Text specifying either ext. menu ID of the product menu or a bookmark of a product menu or info menu. | This attribute may hold either an ext. menu ID (if MenuType is "Product") or a bookmark (if MenuType is "Bookmark"). When supplied, only children to the specified ext. menu ID/bookmark are rendered.
If the MenuID attribute is not specified or if it is empty, all top-level menus and their children are rendered. Specifying ext. menu ID in this attribute is currently only supported for product menus (MenuType "Product"). |
| EmptyProductMenues | Values "Link" and "Hidden" are supported. | Specifies how to render product menus that contain no products. The "Link" option displays these product menus as links regardless of whether they are empty. "Hidden" hides empty product menus (does not render them). This also applies for menus that are empty due to product scope of the customer / sales person. |
| Depth | Allowed values: "All" or an integer defining the number of levels to display. | Specifying "All":
If no MenuID is specified, it renders all levels, including top level.
If MenuID is specified, it renders only decendants of the menu with the specified MenuID (not the menu itself).
Specifying an integer, e.g. "1":
If no MenuID is specified, it renders top level only.
If MenuID is specified, it renders immediate children of the specified MenuID (not the menu itself).
Specifying an integer, e.g. "2":
If no MenuID is specified, it renders top level as well as immediate children.
If MenuID is specified, it renders immediate children and immediate childrens children of the specified MenuID (not the menu itself). |
| CssClass | Any valid CSS class name | Css prefix which will be added to the outer ul element of the menu list |
| Mode | Allowed values: "Text" or "Image" | Defines whether menu elements should render as text only (Text) or as text with images (Image). Note that only product menus currently support images. |
| NotInheritImage | empty string (NotInheritImage="") | If this attribute is specified then children menu items with no images will not be inheriting images from parent menus. If this attribute is not specified, product menus with no image will inherit images from parent menus. That means that if a product menu does not have an image it will inherit one from the closest parent (or grandparent etc.) |
| SrcType | Allowed values: "src", "data-src" | Defines the attribute name of the "img" element that is rendered if the control has the attribute Mode="image". If SrcType is "data-src", the element <img data-src="" /> is rendered whereas the element <img src="" /> will be rendered if SrcType="src". This attribute is optional and that the default value is "src". |
To the topProductFilteringControl
This control allows customers to filter product lists by product specific filters (e.g. price), variant based filters (e.g. color) and/or custom field based filters (e.g. country of origin). The control renders as a list of filter values with check boxes which manipulate (filter) the product list when they are checked/unchecked).
Example
<eSeller:Control ControlType="ProductFilteringControl" ControlID="..." WorksOn="JSONProductList" FilterType="CustomFields" FilterSource="countryOfOrigin" DisplaySelector="Checkboxes" />
Notes: This control must be placed in a design containing a product list.
Attributes
| Name | Value | Description |
|---|
| ControlType | ProductFilteringControl | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| WorksOn | The ControlID of the product list with which the filter should work. | Defines the target product list to which the filtering should be applied. This product list must have the attribute "IsMainProductList" set to true. |
| FilterType | Allowed values: "ProductInStock", "ProductPrice", "ProductManufacturer", "ProductVariants" or "CustomFields" | Specifies what kind of filter it is. |
| DefaultValue | "True" or "False" | This attribute is only applicable if FilterType="ProductInStock". Defines whether the default setting of the filter should be true or false. True = the checkbox is checked, False = the checkbox is unchecked. |
| FilterSource | Ext. ID of the variant filter or of the custom field. | Is only applicable to content controls with the ProductVariants of CustomFields FilterType. Specifies the External ID of the variant filter or of the custom field |
| DisplaySelector | "Checkboxes" or "Slider" | Defines what kind of selector should be used for the filter. "Slider" should be used for filters with the FilterType "ProductPrice". |
| AutoPostbackTime | Time in miliseconds after which the page will reload after a filter selection has changed. | When not specified 1000 milliseconds will be applied (1 second). |
| CssClass | Any valid CSS class name | Css prefix which will be added to each filter element. |
To the topProductSortingList
Renders a drop-down/radio button list/anchor list which the customer can use to sort a product list by different parameters such as price or product name.
Example
<eSeller:Control ControlType="ProductSortingList" ControlID="..." WorksOn="JSONProductList" DefaultValue="NameAsc" DisplayStyle="DropDown"/>
Notes: This control must be used in conjunction with a product list
Attributes
| Name | Value | Description |
|---|
| ControlType | ProductSortingList | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| WorksOn | The ControlID of the product list that should be sorted. | Defines the target product list to which the sorting should be applied. |
| DefaultValue | "NumberAsc", "NumberDesc", "NameAsc", "NameDesc", "PriceAsc", "PriceDesc" or "ProductCard" | Defines the default sort order for the control |
| DisplayStyle | "DropDown", "RadioButton" or "Anchor" | Specifies how the control must be rendered. |
To the topCustomerLoginPasswordReminder
This control allows login customers reset passwords by receiving an e-mail with a link to a password reset page (using the CustomerLoginPasswordReset control). Renders an input field for the customer e-mail to which the reset-link will be sent.Example
<eSeller:Control ControlType="CustomerLoginPasswordReminder" ControlID="..." />
Notes: This control should be used with the GenericButton control (otherwise no button will appear to submit the input).
Attributes
| Name | Value | Description |
|---|
| ControlType | CustomerLoginPasswordReminder | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| CssClass | Any valid CSS class name | Css class name to be applied to the e-mail input field |
To the topCustomerLoginPasswordReset
This control allows login customers to change their password. Renders an input field for the customer e-mail as well as two input fields for new password and repeat new password. Example
<eSeller:Control ControlType="CustomerLoginPasswordReset" ControlID="..." ControlLayout="Simple" />
Notes: This control should be used with the GenericButton control (otherwise no button will appear to submit the input).
Attributes
| Name | Value | Description |
|---|
| ControlType | CustomerLoginPasswordReset | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| ControlLayout | "Default", "Simple" or "Table" | If no ControlLayout attribute applied - Simple layout is used (controls are generated as div elements). If table layout is used - then e-mail and password fields are generated in an HTML table layout. |
| CssClass | Any valid CSS class name | Css class name to be applied to the e-mail input field |
To the topOrderList
Displays a list of orders placed by the customer (only when logged in as the customer or as a sales person representing the customer).
A link to order details is rendered for each order in the list.Example
<eSeller:Control ControlType="OrderList" ControlID="..." DetailsPage="orderdetails.aspx" DetailsQuerystringKey="OrderID"/>
Notes: OrderDetails, OrderTotals etc. controls should be used to display information about the order at the order details page.
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderList | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DetailsPage | a URL | Specifies a URL of the page where the order details should be displayed. If none i provided, the current page will display the order details. |
| DetailsQuerystringKey | String | A key that must be used on the order details page by a eSeller:Data control of DataType "OrderHead" to link together the order list page and order details page. |
To the topOrderDetails
Displays the details (order lines) of an order in a <table> element. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers.Example
<eSeller:Data DataType="OrderHead" DataID="Order" IsOrderConfirmation="False" />
<eSeller:Control ControlType="OrderDetails" ControlID="..." DataSourceId="Order" CanReorder="True" LineAddButtonType="Button" />
Notes: By adding a GenericButton control, it is possible for the log-in customer to reorder the entire order by clicking the rendered button.
Note that an eSeller:Data element must exist along with this control with the same DetailsQuerystringKey value as defined int the OrderLines control, e.g. <eSeller:Data DataType="OrderHead" DataId="Order" QuerystringKey="OrderID"/>
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderDetails | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | The ID of the <eSeller:Data> control with DataType "OrderHead" | ID of <eSeller:Data> control that supplies the order information. |
| CanReorder | "True" or "False" | Specifies whether it is possible to re-order single order lines. |
| LineAddButtonType | "Button", "Link" or "ShopIcon" | Specifies how the "add to basket" button must be rendered in the order lines if CanReorder is True. |
To the topOrderTotals
Displays the order totals of an order in a <table>. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers.Example
<eSeller:Control ControlType="OrderTotals" ControlID="..." DataSourceId="Order"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderTotals | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | The ID of the <eSeller:Data> control with DataType "OrderHead" | ID of <eSeller:Data> control that supplies the order information. |
To the topOrderShipmentMethod
Displays the shipment method used for an order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers.Example
<eSeller:Control ControlType="OrderShipmentMethod" ControlID="..." DataSourceId="Order"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderShipmentMethod | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | The ID of the <eSeller:Data> control with DataType "OrderHead" | ID of <eSeller:Data> control that supplies the order information. |
To the topOrderPaymentMethod
Displays the payment method used for an order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers.Example
<eSeller:Control ControlType="OrderPaymentMethod" ControlID="..." DataSourceId="Order"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderPaymentMethod | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | The ID of the <eSeller:Data> control with DataType "OrderHead" | ID of <eSeller:Data> control that supplies the order information. |
To the topDisplays order remarks of an order if the customer has written any when placing the order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers.Example
<eSeller:Control ControlType="OrderOrderingRemarks" ControlID="..." DataSourceId="Order"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderOrderingRemarks | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | The ID of the <eSeller:Data> control with DataType "OrderHead" | ID of <eSeller:Data> control that supplies the order information. |
To the topOrderShipmentAddress
Displays the delivery address of an order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers.Example
<eSeller:Control ControlType="OrderShipmentAddress" ControlID="..." DataSourceId="Order"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderShipmentAddress | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | The ID of the <eSeller:Data> control with DataType "OrderHead" | ID of <eSeller:Data> control that supplies the order information. |
To the topOrderPaymentAddress
Displays the payment address of an order. Often used in the order confirmation page, order confirmation e-mail or in conjunction with the OrderList control for log-in customers.Example
<eSeller:Control ControlType="OrderPaymentAddress" ControlID="..." DataSourceId="Order"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderPaymentAddress | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | The ID of the <eSeller:Data> control with DataType "OrderHead" | ID of <eSeller:Data> control that supplies the order information. |
To the topDeliveryDateSelectDropdown
Displays a drop-down list which enables the customer to select a desired delivery date during checkout.
This controls works with the delivery calendar if one is set up.Example
<eSeller:Control ControlType="DeliveryDateSelectDropdown" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | DeliveryDateSelectDropdown | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | "Updatable", "ViewOnly" or "Protected" | Updatable: The customer can change the value in the drop-down. ViewOnly: The customer can only see but is unable to edit anything in the drop-down. Protected: Displays the drop-down list but the customer cannot change anything. The default value is "Updatable" which is used if the attribute is not set. |
| required | "true" or "false" | Defines wether or not user is required to choose a date. Default is false. |
| ValueFormat | String with format for dates. For detils follow http://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.110).aspx | It allows to format delivery date. Default is "dd-MM-yyyy". |
To the topAllows the customer to select a delivery form in checkout.
Renders a list of radio buttons, each representing an available delivery form.Example
<eSeller:Control ControlType="ShipmentMethodSelectRadioButtonList" ControlID="..." InputMode="Updatable"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ShipmentMethodSelectRadioButtonList | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | "Updatable" or "ViewOnly" | Updatable: The customer can change which radio button is selected. ViewOnly: The customer see the different options but cannot change anything. The default value is "Updatable" which is used if the attribute is not set. |
To the topShipmentMethodSelect
Allows the customer to select a delivery form in checkout.
Renders a drop-down list containing the available delivery forms.Example
<eSeller:Control ControlType="ShipmentMethodSelect" ControlID="..." InputMode="Updatable"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ShipmentMethodSelect | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | "Updatable" or "ViewOnly" | Updatable: The customer can change which radio button is selected. ViewOnly: The customer see the different options but cannot change anything. The default value is "Updatable" which is used if the attribute is not set. |
| CssClass | Any valid CSS class name | CSS class of the rendered <select> element. If ViewOnly is selected as the InputMode or if there is only one available delivery form, this attribute will be ignored. |
To the topAllows the customer to select a payment form in checkout.
Renders a list of radio buttons, each representing an available payment form.Example
<eSeller:Control ControlType="PaymentMethodSelectRadioButtonList" ControlID="..." InputMode="Updatable"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | PaymentMethodSelectRadioButtonList | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | "Updatable" or "ViewOnly" | Updatable: The customer can change which radio button is selected. ViewOnly: The customer see the different options but cannot change anything. The default value is "Updatable" which is used if the attribute is not set. |
To the topPaymentMethodSelect
Allows the customer to select a payment form in checkout.
Renders a drop-down list containing the available payment forms.Example
<eSeller:Control ControlType="PaymentMethodSelect" ControlID="..." InputMode="Updatable"/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | PaymentMethodSelect | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | "Updatable" or "ViewOnly" | Updatable: The customer can change which radio button is selected. ViewOnly: The customer see the different options but cannot change anything. The default value is "Updatable" which is used if the attribute is not set. |
| CssClass | Any valid CSS class name | CSS class of the rendered <select> element. If ViewOnly is selected as the InputMode or if there is only one available payment form, this attribute will be ignored. |
To the topShipmentAddressCheckbox
Allows the customer to specify a delivery address in checkout (useful if this is different from the payment address). A checkbox with a label is rendered. The ShipmentAddress control should be used to display input fields if this box is checked. Note that the checkbox is disabled, if the selected delivery method is of type "collect-at-store".Example
<eSeller:Control ControlType="ShipmentAddressCheckbox" ControlID="..." CssClass="..." LabelCssClass="..."/>
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ShipmentAddressCheckbox | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| CssClass | Any valid CSS class name | CSS class of the rendered <input> element. |
| LabelCssClass | Any valid CSS class name | CSS class of the rendered <label> element. |
To the topAllows the customer to enter a comment or remark during checkout when placing an order. Displays a <textarea> element in which the customer can enter some text.Example
<eSeller:Control ControlType="OrderingRemarks" ControlID="..." InputMode="Updatable" MaxLength="120" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderingRemarks | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | "Updatable" or "ViewOnly" | Updatable: The customer can change which radio button is selected. ViewOnly: The customer see the different options but cannot change anything. The default value is "Updatable" which is used if the attribute is not set. |
| CssClass | Any valid CSS class name | CSS class of the rendered <input> element. |
| MaxLength | Integer | The maximum number of characters that the customer can enter in remarks. Default is 80 characters. Max is 250 characters. |
To the topShipmentAddress
Allows the customer to enter a delivery address in checkout. Only fields that have been activated in the shop administration under Settings > Customers > Customer information are displayed.Example
<eSeller:Control ControlType="ShipmentAddress" ControlID="..." InputMode="Updatable" UseExistingAddressOnly="False" AllowNoShipmentAddress="True" />
Notes: This control can only be used if the ShipmentAddressCheckbox is also specified in the design, or if the AllowNoShipmentAddress setting is True (mutually exclusive options). If specifying the ShipmentAddressCheckbox control, the state of it (wheter the user has checked it) can be tested by using the tag <eSeller:If IsTrue="Basket:IsShipmentAddressSpecified">. The control BasketActionButton with the attribute CausesSave="true" must be used to save updates and CausesValidation="true" to validate input.
Attributes
| Name | Value | Description |
|---|
| ControlType | ShipmentAddress | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | "Updatable", "ViewOnly" or "Protected" | Updatable: The customer can freely enter text in the input fields. ViewOnly: The customer can view the information but cannot change it. Protected: The information is displayed in locked input fields. Used for log-in customers that are not allowed to change the address information in checkout. Some input fields may be unlocked. Default is updatable. |
| UseExistingAddressOnly | "True" or "False" | True: The logged in customer can only choose between predefined addresses. False: The customer can choose either to use a predefined address or to specify a new address. The attribute is only relevant if the customer has chosen to specify a delivery address by checking the box rendered by ShipmentAddressCheckbox or if the control is required. The attribute is also only relevant for log-in customers. |
| Required | "True" or "False" | NOTE! We strongly advise against using this setting. Use AllowNoShipmentAddress instead. This attribute defines whether shipment address fields are shown. True: Delivery addres fields are shown - thereby the ShipmentAddressCheckbox control is redundant and should not be included in the design. False: The control follows the setting of ShipmentAddressCheckbox, meaning that the shipment address fields are only shown if the user has checked the ShipmentAddressCheckbox. Note that this attribute does not validate whether input fields are filled - this validation is based on settings made in the shop administration under Settings > Customers > Customer information. |
| AllowNoShipmentAddress | "True" or "False" | The purpose is to serve as an alternative to using the "ShipmentAddressCheckbox" control in the design or using the ShipmentAddress "Required" setting. True: The ShipmentAddress control displays an option in the drop-down selector, which defines that the shipment address is the same as the payment address (there is no specific shipment address).
When this setting is enabled, the "Required" setting should be "False" for this control and the ShipmentAddressCheckbox control should not be included in the design (they are mutually exclusive).
The text of this "no shipment address" option defaults to "Same as payment address" but the text may be altered in the content design definition texts. False: The design must include the ShipmentAddressCheckbox control to allow the customer to select a shipment address.
|
To the topPaymentAddress
Allows the customer to enter a payment address in checkout. Only fields that have been activated in the shop administration under Settings > Customers > Customer information are displayed.Example
<eSeller:Control ControlType="PaymentAddress" InputMode="Updatable" UseBillToCustomer="False" />
Notes: The control BasketActionButton with the attribute CausesSave="true" must be used to save updates and CausesValidation="true" to validate input.
Attributes
| Name | Value | Description |
|---|
| ControlType | PaymentAddress | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| InputMode | "Updatable", "ViewOnly" or "Protected" | Updatable: The customer can freely enter text in the input fields. ViewOnly: The customer can view the information but cannot change it. Protected: The information is displayed in locked input fields. Used for log-in customers that are not allowed to change the address information in checkout. Some input fields may be unlocked. Default is updatable. |
| UseBillToCustomer | "True" or "False" | True: If a payment address is specified for the customer, this will be used. False: Whatever address the customer enters in checkout is used. |
To the topAddressLookup
Allows the customer to enter a phone number and have the payment address filled out based on a lookup of this number. Renders an input field for entering a phone number.Example
<eSeller:Control ControlType="AddressLookup" ControlID="..." />
Notes: The GenericButton control must be used to submit the phone number.
Moreover, one or more controls must be defined in order to hold the values received from the lookup.
The label for the field can be accessed from the page text of the control - "label_phone_search" (<eSeller:Select Text="label_phone_search" TextSourceControlId="PhoneLookup" />)
Attributes
| Name | Value | Description |
|---|
| ControlType | AddressLookup | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| CssClass | Any valid CSS class name | Will be specified as the class of the rendered <input> element. |
To the topRenders a simple contact form with input fields for e-mail address and message.
The message is sent as an e-mail to the address that also receives copies of order confirmation mails (Specified under Base setup > Company info > Email addresses in the shop administration).Example
<eSeller:Control ControlType="ContactForm" ControlID="..." Layout="Simple" />
Notes: The GenericButton control must be used to submit the contact form input.
Attributes
| Name | Value | Description |
|---|
| ControlType | ContactForm | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| LandingUrl | A valid URL | The URL to where the customer should be navigated when the contact form has been submitted. If none is specified, the customer will be redirected to the index page ("/"). |
| Layout | "Simple" or "Table" | Specifies how the control is rendered. |
To the topRenders a button/link/shop icon which can trigger an action on another control. This control has no functionality in itself, but must be used in conjunction with another control.Example
<eSeller:Control ControlType="GenericButton" ControlID="..." Text="Submit" WorksOn="MyContactForm" ButtonType="Button" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | GenericButton | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| WorksOn | The ControlID for the control with which the GenericButton should work. | Only controls for which it is specifically stated is it possible to use GenericButton. |
| Text | String | The text that should be displayed on the button/as link text. Normally the control defined in WorksOn controls the text of the button. This attribute is usable in the situations where this is not the case. |
| ButtonType | "Default", "Button", "Link" or "ShopIcon" | Defines how the button is rendered (button, link or shop icon). If ShopIcon is selected, the particular icon and icon size must be chosen by configuring the control in the shop administration. |
| CssClass | Any valid CSS class name. | Class of the rendered <input type="submit"> element. |
| Command | A string which is understood by the control defined in WorksOn. | This attribute is most often ignored by the control defined in WorksOn, however it is useful in situations where multiple actions are controlled by the GenericButton control. |
| CommandArgument | A string which is understood by the control defined in WorksOn. | This attribute is most often ignored by the control defined in WorksOn, however it is useful in situations where multiple actions are controlled by the GenericButton control. |
| ... others | If applicable, this is specified in the control defined in WorksOn. | Controls that are able to perform multiple tasks can specify whether additional attributes are necessary to perform the desired action. |
To the topSalespersonLogin
Renders a login form and a button for sales persons.Example
<eSeller:Control ControlType="SalespersonLogin" ControlID="..." RenderFormat="plain" LandingUrl="/welcomeSalesperson.aspx" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | SalespersonLogin | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| LandingUrl | URL | Specifies the URL to which the shop should redirect upon succesfull login. If this attribute is left blank or if it is omitted, the customer will be redirected to the current page - unless the control is placed at a separate login page (e.g. customer_login.aspx) in which case the customer will be redirected to the index page ("/"). |
| RenderFormat | "table" or "plain" | Specifies whether the HTML should be rendered as a table. |
To the topSalespersonLoginPasswordReminder
This control allows salespersons to reset their password by receiving an e-mail with a link to a password reset page (using the SalespersonLoginPasswordReset control). Renders an input field for the salesperson e-mail to which the reset-link will be sent.Example
<eSeller:Control ControlType="SalespersonLoginPasswordReminder" ControlID="..." />
Notes: This control should be used with the GenericButton control (otherwise no button will appear to submit the input).
Attributes
| Name | Value | Description |
|---|
| ControlType | SalespersonLoginPasswordReminder | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| CssClass | Any valid CSS class name | Css class name to be applied to the e-mail input field |
To the topSalespersonLoginPasswordReset
This control allows sales persons to change their password. Renders an input field for the sales person e-mail as well as two input fields for new password and repeat new password.Example
<eSeller:Control ControlType="SalespersonLoginPasswordReset" ControlID="..." ControlLayout="Simple" />
Notes: This control should be used with the GenericButton control (otherwise no button will appear to submit the input).
Attributes
| Name | Value | Description |
|---|
| ControlType | SalespersonLoginPasswordReset | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| ControlLayout | "Simple" or "Table" | If no ControlLayout attribute applied, Simple layout is used (controls are generated as div elements).
If Table layout is used, the e-mail and password fields are generated in an HTML table layout. |
| CssClass | Any valid CSS class | Class of the e-mail <input> field. |
To the topProductConfiguration
Enables the customer to configure a product on the product detail page (only applicable to configured products).Example
<eSeller:Control ControlType="ProductConfiguration" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ProductConfiguration | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topManufacturerLogo
This control renders the logo of the manufacturer on the product detail page as an <img> element (if a manufacturer with a logo is specified for the product).Example
<eSeller:Control ControlType="ManufacturerLogo" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ManufacturerLogo | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topEnhancedVariantSelector
Makes it possible for customers to select a particular variant of a product on the product detail page. Displays a drop-down list for each variant dimension. If there is more than one variant dimension, and the customer selects a value in the first drop-down list (dimension), the shop will automatically select the first available dimension value in the next drop-down list.Example
<eSeller:Control ControlType="EnhancedVariantSelector" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | EnhancedVariantSelector | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topVariantSelector
Makes it possible for customers to select a particular variant of a product on the product detail page. Displays a drop-down list for each variant dimension.Example
<eSeller:Control ControlType="VariantSelector" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | VariantSelector | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topStockStatus
Displays a text or an icon representing the stock status dependent on how the control is configured in the shop administration.Example
<eSeller:Control ControlType="StockStatus" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | StockStatus | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topProductImages
Displays the product images at the product detail page. Can be configured from the shop administration.Example
<eSeller:Control ControlType="ProductImages" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ProductImages | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topProductprice
Displays the product price on the product detail page.Example
<eSeller:Control ControlType="Productprice" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | Productprice | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topCustomerLogin
Allows login-customers to log in to the webshop. Displays login fields for username and password and a button. Only usable if customer logins are enabled in the shop settings.Example
<eSeller:Control ControlType="CustomerLogin" ControlID="..." LandingUrl="welcome_customer.aspx" SuppressLinks="False" />
Notes: If GenericButton is used with this control, it will overwrite the native button of this control. Links for creating new customer and password reset is only displayed if the URL/bookmark is specified for SendPasswordLink/CreateCustomerLink configurations.
Attributes
| Name | Value | Description |
|---|
| ControlType | CustomerLogin | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| SuppressLinks | "True" or "False" | True: No "forgot password" link is displayed. False: A "forgot password" link is displayed. Note that a bookmark to the desired page must be provided in shop settings. |
| LandingUrl | URL | Specifies the URL to which the shop should redirect upon succesfull login. If this attribute is left blank or if it is omitted, the customer will be redirected to the current page - unless the control is placed at a separate login page (e.g. customer_login.aspx) in which case the customer will be redirected to the index page ("/"). |
Control configuration
| Property | Value | Description |
|---|
| HTML format | Default, Miminal HTML, HTML table | Determines what HTML is rendered for the control. "Minimal" renders the content as divs and unordered lists and "Table" renders the content as a html table element. "Default" is rendering as a table. |
| SubmitLandingUrl | URL | Specifies the URL to which the shop should redirect upon succesfull login. Can alternatively be set as an attribute on the control. |
| SendPasswordLink | URL/bookmark e.g. Bookmark:SendPasswordLink | If a URL/bookmark is specified here, a link for resetting the password is displayed. When clicking the link, the shop will redirect to his URL/bookmark. Note that the link can be hidden by setting the attribute "SuppressLinks" to True. |
| CreateCustomerLink | URL/bookmark e.g. Bookmark:CreateCustomerLink | If a URL/bookmark is specified here, a link for creating a new customer is displayed. When clicking the link, the shop will redirect to his URL/bookmark. Note that the link can be hidden by setting the attribute "SuppressLinks" to True. |
To the topProductList
Displays a product list with product name, image and price as well as links to product detail pages.Example
<eSeller:Control ControlType="ProductList" ControlID="..." IsMainProductList="True" />
Notes: GenericButton options: Command="AddAlltoBasket" - Add all lines for which a quantity is specified to the basket. (Presupposes that the quantity field is visible for the add-to-basket button in shop settings).
Attributes
| Name | Value | Description |
|---|
| ControlType | ProductList | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataProvider | eSeller.DataProvider.ProductList.CustomerFavorites - Active customer favorites list
eSeller.DataProvider.ProductList.MenuProduct - Products for the current menu
eSeller.DataProvider.ProductList.RelatedProducts - Related products
eSeller.DataProvider.ProductList.BomContents - Content of bill of materials
eSeller.DataProvider.ProductList.SearchResultsDataProviderItem - Search result list
eSeller.DataProvider.ProductList.ProductCollection - List based on one or more product collections
| If DataProvider is not specified, it will conform to the default value based on the current menu point. |
| IsMainProductList | "True" or "False" | True: The product list design will be taken from the design setting of the menu. Normally, the main product list has the value "True". False: The product list design must be chosen in the configuration of the control in the shop administration. If one is not selected, an error message will be displayed in the shop. |
| PrefillQuantity | "True" or "False" | True: The product list design will be taken from the design setting of the menu. Normally, the main product list has the value "True". False: The product list design must be chosen in the configuration of the control in the shop administration. If one is not selected, an error message will be displayed in the shop. |
| DataTag | Related product tag / Product collection tag | Only applicable to product lists that uses the RelatedProducts or ProductCollection DataProvider. For RelatedProducts: Specify a related product tag to only display related products that have this tag. If this attribute is not specified, only related products with NO tags are displayed. For ProductCollection: Specify a tag used by one or more product collections. If multiple product collections qualify by the tag, a union of all products from the qualified product collections will be returned. Either DataTag OR DataExtProductCollectionID attribute must be specified when using the ProductCollection data provider. |
| ItemTypeFilter | "Products", "Menus" (product menus), "Article" (cms menus) or "All" (default) | Only applicable if the product list is used as a search result list using SMART search (SearchBox control).
This attribute is used to specify what types of results should be present in search results. It is possible to specify more types separated by a comma - e.g. "Products,Menus".
|
| DataProductID | Internal ID (product number) of a product. | Only applicable to product lists that uses the RelatedProducts DataProvider. Gets a list of related products for the the product with the specified product ID.
|
| DataExtProductID | External product ID | Only applicable to product lists that uses the RelatedProducts DataProvider. Gets a list of related products for the the product with the specified External product ID.
|
| DataLifetimeID | Lifetime ID of a product | Only applicable to product lists that uses the RelatedProducts DataProvider. Gets a list of related products for the the product with the specified product Lifetime ID.
|
| DataExtProductCollectionID | Ext ID of a product collection | Only applicable to product lists that uses the ProductCollection DataProvider. Gets a list of products for the product collection with the specified ext. ID. Either DataTag OR DataExtProductCollectionID attribute must be specified when using the ProductCollection data provider.
|
To the topJsonProductList
Displays a product list using JSON. Supports product sorting and product filters. Example
<eSeller:Control ControlType="JsonProductList" ControlID="..." TestMode="false" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | JsonProductList | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| TestMode | "true" or "false" | If TestMode is set to “True", the JSON result will be rendered as plain text in the content element. This mode is only suitable for testing – the script generating the plain text rendering (jsonProductList.js) should not be used for anything but testing. When TestMode is set to “False" all logic responsible for retrieving and displaying information must be provided by the designer. |
To the topOrderToBasketSpecific
Enables the logged-in customer to reorder previously placed orders by adding the order lines to the basket. Renders a button that adds the lines to the basket. Is typically placed at the order detail page or at the order confirmation page.Example
<eSeller:Data DataType="OrderHead" DataID="Order" IsOrderConfirmation="False" />
<eSeller:Control ControlType="OrderToBasketSpecific" ControlID="..." DataSourceId="Order" />
Notes: Using this control presupposes that an <eSeller:Data> control exists which has the DataType "OrderHead". Only orders that have been placed by the logged in customer can be reordered or if the order has been placed by a sales person which is associated with the logged in customer.
Attributes
| Name | Value | Description |
|---|
| ControlType | OrderToBasketSpecific | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceId | ID of the <eSeller:Data> control which has the DataType "OrderHead". | The ID of the <eSeller:Data control which this control should work on. |
To the topBasketTotals
Displays basket totals including subtotal, delivery fee, total and VAT amount. This control can be used at basket and checkout pages.Example
<eSeller:Control ControlType="BasketTotals" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | BasketTotals | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topBasketMessages
Displays info messages from the basket which relates to actions in the basket, e.g. "Product is added to the basket". Messages are only displayed once and disappear automatically after having been displayed.Example
<eSeller:Control ControlType="BasketMessages" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | BasketMessages | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topBasketDetails
Displays the basket contents in a table including product name, product image, unit price and total price. Moreover, it is possible to update quantity of products in the basket as well as remove products from the basket. Example
<eSeller:Control ControlType="BasketDetails" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | BasketDetails | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topAcceptTerms
This control displays a checkbox and a text label, which the customer must check in order to complete an order on the shop, thereby accepting the terms and conditions. If the customer tries to complete an order without checking this box, the customer will be prompted to check it to continue.Example
<eSeller:Control ControlType="AcceptTerms" ControlID="..." />
Notes: This control is hidden if the shop settings are not setup to require acceptance of terms.
Attributes
| Name | Value | Description |
|---|
| ControlType | AcceptTerms | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| CssClass | Any valid CSS class name | The class of the <input> element |
| LabelCssClass | Any valid CSS class name | The class of the <label> element |
To the topBasketSelector
Enables the customer to view all baskets if the shop supports multiple baskets. Displays a table of all existing baskets. The customer can select which basket is active and is furthermore able to delete baskets. If this control is used in conjunction with the BasketEditor control, the customer will also be able to edit the name of existing baskets in the table. Example
<eSeller:Control ControlType="BasketSelector" ControlID="..." />
Notes: This control presupposes that multiple baskets are enabled in shop settings.
Attributes
| Name | Value | Description |
|---|
| ControlType | BasketSelector | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topBasketEditor
Enables the customer to edit the name of existing baskets displayed with the BasketSelector control. The BasketEditor control also enables the customer to create and name new baskets which will then be displayed in the table rendered by BasketSelector.Example
<eSeller:Control ControlType="BasketEditor" ControlID="..." />
<eSeller:Control ControlType="BasketSelector" ControlID="..." />
Notes: Must be used in conjunction with the BasketSelector control. Presupposes that multiple baskets are enabled in shop settings.
Attributes
| Name | Value | Description |
|---|
| ControlType | BasketEditor | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topDisplays a navigational button/link/icon to use with the basket.Example
<eSeller:Control ControlType="BasketActionButton" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | BasketActionButton | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| Mode | "NavigateNext", "NavigatePrevious", "UpdateBasket" or "ClearBasket" | NavigateNext: Navigate to the next step of the checkout progress. NavigatePrevious: Navigate to the previous step of the checkout progress. UpdateBasket: Updates the content of the basket (e.g. if changes have been made in quantity). ClearBasket: Removes all products from the basket. |
| Text | String | Text to display on the button/link |
| ButtonType | "Button", "Link" or "ShopIcon" | Determines how the control should be rendered.
If ShopIcon is selected, an icon and icon size must be set up when configuring the control in the shop administration. |
| CssClass | Any valid CSS class name | Class of the rendered <input> element. |
| CausesValidation | "True" or "False" | True: Clicking the button validates the page (e.g. what the user has entered in any input fields). Default is False, however if Mode is NavigateNext or UpdateBasket, the default value is True. |
| CausesSave | "True" or "False" | Defines whether clicking the button should save data on the page.
Default is False, however if Mode is UpdateBasket, default is True. |
To the topDisplays a button/link/icon to use for navigational purposes in the shop. Can navigate through menus, URLs and bookmarks.Example
<eSeller:Control ControlType="NavigateButton" ControlID="..." />
Notes: Must be used in conjunction with the BasketSelector control. Presupposes that multiple baskets are enabled in shop settings.
Attributes
| Name | Value | Description |
|---|
| ControlType | NavigateButton | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| Command | "Frontpage", "Parent", "Forward", "Backward", "FirstChild", "LastChild", "Url" or "Bookmark" | Specifies to where navigation should be done. Frontpage: Navigates to the shop index page which has the URL "/". Parent: Navigates one step up in the current menu tree (parent menu). Forward: Navigates to the next sibling menu. Backward: Navigates to the previous sibling menu. FirstChild: Navigates to the first child menu below the current menu. LastChild: Navigates to the last child below the current menu. Url: Navigates to a URL which is specified in the CommandArgument attribute. Bookmark: Navigates to a bookmark in the shop, specified in the CommandArgument attribute. |
| CommandArgument | URL or Bookmark | Only applicable if Command is "Url" or "Bookmark". Defines to which URL/bookmark the shop should navigate. |
| Text | String | Text to display on the button/link |
| ButtonType | "Button", "Link" or "ShopIcon" | Determines how the control should be rendered.
If ShopIcon is selected, an icon and icon size must be set up when configuring the control in the shop administration. |
| CssClass | Any valid CSS class name | Class of the rendered <input> element. |
| CausesValidation | "True" or "False" | True: Clicking the button validates the page (e.g. what the user has entered in any input fields). Default is False, however if Mode is NavigateNext or UpdateBasket, the default value is True. |
| CausesSave | "True" or "False" | Defines whether clicking the button should save data on the page.
Default is False, however if Mode is UpdateBasket, default is True. |
To the topVariantMatrix
Displays a matrix of variants of the product on the product detail page. Only applicable to variant products.Example
<eSeller:Control ControlType="VariantMatrix" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | VariantMatrix | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| ShowLegend | "True" or "False" | Defines whether to display a legend for the matrix. |
| ShowStocklevelInMatrix | "True" or "False" | Defines whether the stock level of each variant should be displayed. It will be shown to the left of the input field. In order to display the stock level, the text that is generated with key "label_quantityinstock" must contain the text "[QUANTITY]". E.g. "Stock level: [QUANTITY]". |
| ShowProductsSumline | "True" or "False" | Defines whether a sum of quantity entered in the matrix should be shown. In order to display this value, the text that is generated with key "label_variantmatrixsum" must contain the text "[SUM]". E.g. "Sum: [SUM]" |
To the topCustomerEditor
Renders input fields for the logged-in customer to edit his information. Example
<eSeller:Control ControlType="CustomerEditor" ControlID="CustomerEditor" />
<eSeller:Control ControlType="GenericButton" Command="Save" ControlID="SaveButton" WorksOn="CustomerEditor">
</eSeller:Control>
Notes: Should be used with the GenericButton control to save the changes.
Attributes
| Name | Value | Description |
|---|
| ControlType | CustomerEditor | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| SubmitLandingUrl | a URL | The URL (partial or complete), to where the control should redirect upon successfull submission. |
| DefaultCustomerPricegroup | Ext. ID of a customer price group | Specifies a customer price group that will be applied to new customers created with this control. |
| IsReadonly | "True" or "False" | If True, all input fields except the password fields are locked so the customer cannot change the values of these. Default is False. |
| Layout | "Default", "Table_FullInfo" or "Inline_LimitedInfo" | This attribute defines how this control is rendered.
Default: The layout is taken from the content definition.
Table_FullInfo: Renders all available info in table format, where col1 hold labels and col2 input fields.
Inline_LimitedInfo: Renders a subset of available info in minimalistic layout using DIV to seperate fields,
and labels are put inside input fields. |
To the topCustomerCreatorSimpel
Renders a checkbox with a label and input fields for username and password so that the customer can
create a log-in user during checkout.Example
eSeller:Control ControlType="CustomerCreatorSimpel" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | CustomerCreatorSimpel | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topResendCustomerLogin
Example
eSeller:Control ControlType="ResendCustomerLogin" ControlID="..." />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ResendCustomerLogin | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topGiftCardLookUp
Displays an input field in which the customer can enter a gift card code an view details about the gift card. Example
<eSeller:Control ControlType="GiftCardLookUp" ControlID="GiftCardInputField" DetailsQuerystringKey="GiftCardID" DetailsUrl="giftcarddetails.aspx" />
<eSeller:Control ControlType="GenericButton" ControlID="SubmitCode" WorksOn="GiftCardInputField" />
Notes: Must use GenericButton to display submit button.
Attributes
| Name | Value | Description |
|---|
| ControlType | GiftCardLookUp | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DetailsQuerystringKey | String | A key that must be used on the gift card details page by a eSeller:Data tag of DataType "GiftCard" to link together the gift card lookup page and gift card details page. May be omitted if the eSeller:Data tag does not have a QuerystringKey parameter. |
| DetailsUrl | String | The URL to where the control should redirect upon successfull submission. |
To the topRedeemGiftCard
Displays an input field in which the customer can enter a gift card code and redeem the gift card. Example
<eSeller:Control ControlType="RedeemGiftCard" ControlID="GiftCardInputField" />
<eSeller:Control ControlType="GenericButton" ControlID="SubmitCode" WorksOn="GiftCardInputField" />
Notes: Must use GenericButton to display submit button.
Attributes
| Name | Value | Description |
|---|
| ControlType | RedeemGiftCard | Defines the control type |
| ControlID | String | Defines ID of this particular control |
To the topGiftCardHistory
Displays a table / divs with the transaction history of a gift card.Example
<eSeller:Control ControlType="GiftCardHistory" ControlID="…" DataSourceID="…" RenderFormat="div" />
<eSeller:Control ControlType="GiftCardHistory" ControlID="…" DataSourceID="…" RenderFormat="table" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | GiftCardHistory | Defines the control type |
| ControlID | String | Defines ID of this particular control |
| DataSourceID | String | The ID of the eSeller:Data tag with DataID "GiftCard". |
| RenderFormat | "div" or "table" | Defines whether the control should render as HTML table or divs. |
To the topProductDocuments
Displays a list of links to product documents - used on the product details page.Example
<eSeller:Control ControlType="ProductDocuments" ControlID="…" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | ProductDocuments | Defines the control type |
To the topCustomerSelector
Displays a list of customers associated with the logged-in salesperson. Enables the sales person to select a customer for whom to place orders etc. Example
<eSeller:Control ControlType="CustomerSelector" ControlID="…" MaxResultCount="50" />
Notes: -
Attributes
| Name | Value | Description |
|---|
| ControlType | CustomerSelector | Defines the control type |
| Mode | ListAll | SearchOnly | Specifies whether the control should list all related customers when initially loaded. "ListAll" lists all related customers when the control is initially loaded (default). "SearchOnly" does not list any customers until a search has been made. "SearchOnly" is recommended to use in cases where many related customers exist for sales persons, as it leads to better performance. |
| MaxResultCount | Integer - 0 is not allowed | Specifies the maximum number of customers that the control lists. Default is 2147483647. For performance reasons it is highly recommended to set a suitable MaxResultCount (e.g. 50). If more results exist than the MaxResultCount, an informative text makes the user aware of this and suggests making a more specific search. |