SYNTAX:
<cf_eConstruct_products
[categoryID=""]
[discountsOnly=""]
[newOnly=""]
[style="[0|1|2]"]
[ShowFields="[thumb,prodname,price,sku,mfgsku,shortDesc,longDesc,qtyInStock,dimensions]"]
[ShowFieldsOnDetail="[thumb,prodname,price,sku,mfgsku,shortDesc,longDesc,qtyInStock,dimensions]"]
[allowAddToBasket="[yes|no]"]
[addToBasketAlert="[yes|no]"]
[border="[yes|no] or [1|0]"]
[borderBgColor=""]
[tableBgColor=""]
[tableTHBgColor=""]
[altRowBgColor=""]
[imageBorder="[yes|no] or [1|0]"]
[maxrows=""]
[maxcols=""]
[title=""]
[filterFor=""]
[filterFields="sku,mfgsku,productName,shortdesc,longdesc,keywords"]
[filterType="[like|exact]"]
>
DEFAULTS:
categoryid = 0
discountsOnly = "No"
newOnly = "No"
style = 0
showFields = thumb,prodname,price,sku,mfgsku,shortDesc,qtyInStock
showFields = lgimage,prodname,price,sku,mfgsku,longDesc,qtyInStock,dimensions
allowAddToBasket = "Yes"
addToBasketAlert = "Yes"
border = "No"
borderBgColor = "white"
tableBgColor = "White"
tableTHBgColor = "Silver"
altRowBgColor = "[same as the tableBgColor]"
imageBorder = "Yes"
maxrows = 10
maxcols = 1
filterFields="sku,mfgsku,productName,shortdesc,longdesc,keywords"
filterType="like"
NOTES:
Colors may be entered as named colors (ie. Black, White, etc.) or Hexadecimals. Make sure to use double pounds when entering colors hexadecimal (ie. ##FFFFFF)
ATTRIBUTES:
CATEGORYID - Optional. Possible values are valid eConstruct database category ids. Default is "0". If the value zero is provided or if you accept the default value, all database products will be displayed. Providing a category id will limit the display to just the category id you provided.
DISCOUNTSONLY - Optional. Possible values are "0", "1", "Yes" or "No". Default is "0". A value of "1" or "Yes" will limit the product display to just discounted products. Discounted products are specified in the site admin tool. If you provided a category id, then just discounted products in this category id will be displayed.
NEWONLY - Optional. Possible values are "0", "1", "Yes" or "No". Default is "0". A value of "1" or "Yes" will limit the product display to just new items. New products are specified in the site admin tool. If you provided a category id, then just new products in this category id will be displayed.
STYLE - Optional. Possible values are "0,1, or 2". Default is "0".
- Style 0 example:
<cf_eConstruct_products
categoryid="5"
style=0
ShowFields="thumb,prodname,price,sku,qtyinstock"
allowAddToBasket="yes"
border="no"
borderBgColor="whitesmoke"
tableBgColor="white"
altRowBgColor="whitesmoke"
imageBorder="no"
maxrows="6"
maxcols="2">Will result in:
- Style 1 example:
<cf_eConstruct_products
categoryid="5"
style=1
ShowFields="thumb,prodname,price"
allowAddToBasket="no"
border="no"
borderBgColor="whitesmoke"
tableBgColor="white"
altRowBgColor="whitesmoke"
imageBorder="no"
maxrows="8"
maxcols="4">Will result in:
Style 0 and 1 are very similar except for the position of the thumbnail image and the obvious omission of the 'more info' button in style 1.
- Style 2 example:
<cf_eConstruct_products
categoryid="5"
style=2
ShowFields="thumb,prodname,price,sku,shortdesc"
allowAddToBasket="no"
border="no"
borderBgColor="whitesmoke"
tableBgColor="white"
altRowBgColor="whitesmoke"
imageBorder="no"
maxrows="3">Will result in:
Style 2 provides for a spreadsheet like format. In all three styles, fields can be randomly selected for display using the 'ShowFields' attribute. The Numbers of records and columns as well as wether to display an 'Add to Basket' button can all be customized using passed attribute variables.
SHOWFIELDS - Optional. Default is "thumb,prodname,price,sku,mfgsku,shortDesc,qtyInStock,dimensions". Must be provided as a comma delimited list. Possible values are: [thumb,prodname,price,sku,mfgsku,shortDesc,longDesc,qtyInStock,dimensions]
ALLOWADDTOBASKET - Optional. Possible values are "0", "1", "Yes" or "No". Default is "1". If set to "Yes", will display the 'Qty in Stock' and a Quantity entry field plus an 'Add to Basket' button.
ADDTOBASKETALERT - Optional. Possible values are "0", "1", "Yes" or "No". Default is "1". If set to "Yes", the system will display a javascript alert that the item was added to the basket when the 'Add To Basket' button is clicked.
BORDER - Optional. Possible values are "0", "1", "Yes" or "No". Default is "1". Equivalent to the HTML table tag border attribute.
BORDERBGCOLOR - Optional. Default is "White". Products are displayed inside a color border.
TABLEBGCOLOR - Optional. Default is "White". Equivalent to the HTML table tag bgcolor attribute.
TABLETHBGCOLOR - Optional. Default is "Silver". Used for Style 2. This attribute sets the color used for the field headings.
ALTROWBGCOLOR - Optional. Defaults to the same value as the TABLEBGCOLOR. Provides for an alternating color for rows.
IMAGEBORDER - Optional. Possible values are "0", "1", "Yes" or "No". Default is "No". Equivalent to the HTML IMG border attribute.
TITLE - Optional. Default is NULL. If NULL, no title is displayed.
MAXROWS - Optional. Default is "10". Limits the number of records displayed per page.
MAXCOLS - Optional. Default is "1". Sets the number of products/items displayed per row.
FILTERFOR - Optional. Default is NULL. The FILTERFOR attributes is used to provide a search mechanism. The tag will search the database for the string provided in this attribute and display only those that satisfies the search criteria. No filtering will be performed if the FILTERFOR attribute is not provided. If a categoryID is provided, all filtering will be done only in the specified categoryID.
FILTERFIELDS - Optional. Default is "sku,mfgsku,productName,shortdesc,longdesc,keywords". Must be provided as a comma delimited list. Possible values are: [sku,mfgsku,productName,shortdesc,longdesc,keywords]. Used in conjuction with the FILTERFOR attribute.
FILTERTYPE - Optional. Possible values are "Like" or "Exact". Default is "Like". Used in conjuction with the FILTERFOR attribute.