Smart Tags Specification

Note:

Custom Pages is a deprecated tool, included mainly for legacy compatibility. The preferred method for customizing your ShopSite store is with Custom Templates, a more robust and powerful tool. Because Custom Pages is no longer being updated, newer ShopSite features may not be available in pages created with the Custom Pages tool.

You use Smart Tags to integrate the information in the ShopSite products and pages databases into custom HTML pages created outside of ShopSite.

The tags and their usage are listed here. Some simple examples are shown after the tag definitions.

Smart Tag Definitions

A parameter in square brackets ([parameter]) is optional. A parameter in italics is a placeholder showing where you need to provide a real value. A pipe symbol (|) means "or."

<uheader>


Inserts the store's page header
<ufooter>


Inserts the store's page footer
<curdb="products">
<curdb="pages">


Current Database. Sets the default database for subsequent Smart Tags to either the products or pages database. Use this tag so that you don't have to specify a database in other tags. The specified database will remain the default until another <curdb=" "> tag is encountered.

You can override this setting for any tag by including the db parameter in that tag.

<recname="record_name">


Record Name. Sets the default database record for subsequent Smart Tags by the name of the record (i.e., product name or page name). The record name is case-sensitive, and must match exactly with the information in the specified database. The specified record will remain the default record until another <recname=" "> or <currec=" "> tag is encountered.

You can override this setting for any tag by including the record parameter in that tag.

Note:

Do not use double quotes in record names (product and page names) within Smart Tags. If you need double quotes in a record name, use the HTML character string &quot; both in the product/page name and in the Smart Tag.

<currec="record_number">


Current Record. Sets the default database record for subsequent Smart Tags by the record number. Use this tag so that you don't have to specify a record in other tags. This record will remain the default until another <currec=" "> or <recname=" "> tag is encountered.

You can override this setting for any tag by including the record parameter in that tag.

<order [db="database_name"] [record="record_name" | rnum="record_number"]>Order</order>


Add to Cart button. This tag creates a link that adds the current record to the shopping cart. You can specify a record by name (record) or by number (rnum). If you don't specify a record, the value of the last specified <recname> or <currec> tag is used. You can specify a database with the db parameter. If you don't specify a database, the database last specified by <curdb> is used. [Add to Cart] is the text that is displayed as the link on the page. You can use any text here, or you can use an HTML <img> tag to display a graphic order button.
<checkout>Checkout</checkout>


View Cart button. This tag creates a checkout button that will redirect the customer to the shopping cart. [View Cart] is the text that is displayed as the link on the page. You can use any text here, or you can use an HTML <img> tag to display a graphic checkout button.
<field [db="database_name"] [record="record_name" | rnum="record_number"] name="field_name">


This tag displays the contents of the specified database field for the given record. For example, <field db="products" record="Bouncy Ball" name="Price"> will display the price for the product "Bouncy Ball." You can specify a record by name (record) or by number (rnum). If you don't specify a record, the value of the last specified <recname> or <currec> tag is used. You can specify a database with the db parameter. If you don't specify a database, the database last specified by <curdb> is used. You must include the name parameter to specify the field that you want to display. The name of the field must match one of those listed for Database Upload. Note that these field names are not the same as the field names that you see when you add or modify a page or product using the standard interface.

Note: Each <field> tag must be the first text on a line in the source file, as shown in the examples. It can be preceeded by spaces and followed by other tags and text, but it must be the first text.
<curalign="right | left | center">


Optional tag to specify the alignment used in the <product> and <pagelink> tags.
<product [record="record_name" | rnum="record_number"] [align="right | left | center"]>


This tag places an entire product, including [Add to Cart] and [View Cart] buttons, on your page. The product information is formatted according to its assigned template and other formatting options for that product. You can specify a record by name (record) or by number (rnum). If you don't specify a record, the value of the last specified <recname> or <currec> tag is used. You can optionally specify the alignment of the product on your page or it will default to the value of the last <curalign> tag. The <product> tag only searches the products database, so you don't need to specify a database.

Note: Each <product> tag must be the first text on a line in the source file, as shown in the examples. It can be preceeded by spaces and followed by other tags and text, but it must be the first text.
<pagelink [record="record_name" | rnum="record_number"] [align="right | left | center"]>


Page Link. This tag creates a link from this page to the ShopSite page specified in the current record, using the information defined on that page for creating the link. You can specify a record by name (record) or by number (rnum). If you don't specify a record, the value of the last specified <recname> or <currec> tag is used. You can optionally specify the alignment of the product on your page or it will default to the value of the last <curalign> tag. The <pagelink> tag only searches the pages database, so you don't need to specify a database.

Note: Each <pagelink> tag must be the first text on a line in the source file, as shown in the examples. It can be preceeded by spaces and followed by other tags and text, but it must be the first text.

Smart Tag Examples


ShopSite Help and Resource Center
February 13, 2004
Give Feedback


ShopSite Shopping Cart Software