cf_ses_specials - Search Engine Safe
Specials Custom Tag:
Show Specials
See ezcart_ses_specials.cfm file in store folder for example.
Shows a formatted display of categories, specials, etc.,
and images if specified.
page=details.cfm (see details="1/0" attribute)
or
page=cart.cfm (to order, see ordering="1/0" attribute)
Copy and paste below into template:
<cf_ses_specials
cartpage="#cartpage#"
querystring="#querystring#"
thispage="#page#">
Minimum required parameters:
cartpage="#cartpage#" DO NOT REMOVE OR CHANGE!
querystring="#querystring#" DO NOT REMOVE OR CHANGE!
thispage="#page#" DO NOT REMOVE OR CHANGE!
Optional parameters:
details="1/0" If set to "1" there will be a View Item link to the
details page as though they clicked on details
from the search results page. Set to "0" to hide
the link.
ordering="1/0" If set to "1" there will be an Order link. Set to "0"
to hide the link. We will hide the link automatically
and link to the details page if the item has a promo
code attached.
images="path/to/images/" Defaults to no product images if omitted or blank.
Otherwise, enter the path to the directory where the
product images are and include a trailing slash.
This path will be from the folder that ezcart
is in (Store Setup - Main Server). Name the images
"'product id'.jpg". To show your thumbnails from the
products_tn folder, this should be "ezcart/products_tn/"
imagepath="sub/main" Covered in Add Products under "Product Image Naming
Convention and Placement". This should match the
setting (if any) you entered in Application.cfm.
showitems="[number]" Specify the max number of items to show.
israndom="1/0" If "1" and "showitems" is less than the number of
specials you've created, we will show the number of
items specified in "showitems" at random. If "0",
items will be shown in order by the Sort Order field
in product admin, then the Product ID.
specialtype="[1-10]" We allow you to group specials. We've created 10 groups.
5 of which we've named and 5 of which are available if
you need more groups. The 5 we've created are;
1=Specials, 2=Featured, 3=New, 4=Discontinued, 5=Holiday
Type 1 also shows when passing page=specials to list.cfm.
This defaults to "1" if omitted.
showmfr="[text]" "None" or blank to hide the manufacturer. Defaults to the
value in the Edit Appearance section of store setup. If this
is "Artist", will show: Artist: Pablo Picasso
linktomfr="1/0" "1" if you want to link to the product in the manufacturer
hierarchy if using search engine safe file system. "0" to
link to the product under the category hierarchy.
headerimage="path/to/img" If you want an image to show above the specials, enter
the path here. This will be from the folder that ezcart
is in (Store Setup - Main Server).
headertext="[text]" If you want text to show above the specials, enter it here.
Or of you used an image, this will be the alt tag value.
headerbgcolor="[hex]" If using headerimage or headertext, the background color of
the cell. Don't use any # characters when adding hex values.
headerfontclass="[style]" Use a style from a cascading style sheet for the headertext
font.
headerfontstyle="[style]" If you don't feel like making a class in a css, set the
style here. Example:
headerfontstyle="color: ##ffffff; font-weight: bold; font-family: Arial"
PLEASE NOTE THAT # SYMBOLS MUST BE ESCAPED BY DOUBLING THEM.
fontclass="[style]" Defaults to ezcartsmalltext if omitted. Style of all
other descriptive text.
linkfontcolor="[hex]" Use a hex value with no pound sign. Defaults to link
color in body tag if omitted.
linkfontbold="1/0" Defaults to 0 (no) if omitted. 1 sets the linkall
font as bold if used.
showprice="1/0" Set to "0" to hide the price. Defaults to "1" (yes)
if anything other than "0" or omitted.
salefont="[style]" The style of the sale price. Defaults to
salefontcolor if omitted. Any item that has been set
to a special price by setting the sale price less
than the regular price, as opposed to just placing
it in a category named "Specials" will show the
regular price under the sale price with a strike
thru it (KEWL!).
salefontbold="1" Defaults to 0 (no) if omitted. 1 sets the font bold.
cols="[number]" Columns In Table. Defaults to 1 if omitted.
startrow="#startrow#" If using showitems above, paste this in exactly like
this.
border="[number]" Table border size. Defaults to 1 if omitted.
tablewidth="[number or %]" Table width. Defaults to none if omitted & table
will size dynamically.
spacing="[number]" Table cellspacing. Defaults to 0 if omitted.
padding="[number]" Table cellpadding. Defaults to 2 if omitted.
bordercolor="[hex]" Table bodercolor. Defaults to no bordercolor if
omitted or blank.
aligncell="[alignment]" Defaults to center if omitted. Valid values are
left/center/right/both. "both" may only be used if
cols="2" in which case the left column will be left
justified and the right column will be right
justified. Using "both" with cols set to anything
other than "2" will center justify.
valigncell="[alignment]" Vertical alignment of main table cells. Valid values
are top, middle, bottom. Defaults to "top".
subtablewidth="[num or %]" Sub table width. We place the text inside of a table
that can be sized. This Defaults to none if omitted
& table will size dynamically. This will allow you
to align your text to the width of your images if
using images or just lets you make all your text
blocks be the same width. Play with this and the
table cells.
subaligncell="[alignment]" Same as aligncell but works on the table with the
text. A nice look if using images is to set this to
"left" and make the subtablewidth the same width as
the images.