Final Application.cfm Settings
You should have your cart up and running and tested before reading this page. When ready, we have
Application.cfm broken down into several sections. Some of these settings are optional. Some should be changed
from the default setting before going live. Many of the default values here will never need to be changed.
Initial Application.cfm settings. Covered in Initial Application.cfm settings.
Auto Parts Store Settings. Ignore this (and don't change) unless you need an auto parts store drill down, in which case, please contact us.
Miscellaneous
- <cfset request.cartpagetemplate = "store/template.cfm"> - Path to the cartpage template from the
directory set as Main Server (Store Setup). Make this empty if using the standalone version (not recommended). Otherwise,
follow the instructions in setting up the "cartpage" template under Integration With Your Site. You may use the value
within for testing. If you changed the name of the store folder when you uploaded, you will need to change it here also.
- <cfset attributes.cachequery = "#createtimespan(0,0,0,0)#">
- This sets how long the queries are cached. The zeroes represent (days,hours,minutes,seconds). We
leave this like it is for testing. We recommend setting it to about 15-30 minutes once you go live.
Caching the queries results in the site running faster and helps the entire server in general as the
database does not get "hit" for every query that's ran. It will only get hit every x number of
minutes, resulting in the recordset being returned immediately for the rest of the time. To
set to 15 minutes, change this value to #createtimespan(0,0,15,0)#. If you make changes to the
products in the database, you may have to wait the number of minutes you set to see the changes.
- <cfset attributes.multistore = "0"> - To use the shopping cart in a "Mall" setting,
- <cfset currency_code = "USD"> - 3 character currency code of the country from where the items are being sold.
- <cfset currency_name = "US Dollars"> - Curreny name to coincide with the currency code.
- <cfset currency_iso_num = "840"> - Curreny ISO Number to coincide with the currency code.
set this to "1". Be sure to read the Multi-Store Setup & Licensing section.
- <cfset attributes.multiplecurrencies = "0"> - If you wish to allow your customers to choose from several currencies, open the ezcart/setexchangerates.cfm file. Read the instructions and set this value to "1".
- <cfset messagetablewidth = "500"> - There are various messages throughout the site. You may control the width of the message display here.
- <cfset checkouttablewidth = "450"> - Same as above, but controls the width of the billing and shipping information tables at checkout.
- <cfset attributes.datemask = "MMMM D, YYYY">
- <cfset attributes.Inventory_Control = "0"> - Set to "1" to use Inventory Control. More on this in the Add Products section.
- <cfset attributes.allowordering = "0"> - If using Inventory Control and you set this value
is set to "1", any item may still be ordered even if it is not in stock. This would mainly be used
if you want to make a note such as "In Stock items ship in 1 business day. Out Of Stock items will
ship within 10 business days."
- <cfset attributes.showotherscarts = "0"> - You can show how many items are in other shoppers baskets if you like. Only if using inventory control and allowing ordering of out of stock items.
- <cfset attributes.autoupdate = "0"> - Set to "1" to automatically redirect back to the item you just placed in the cart. attributes.allowcartupdates above must be set to "1",
and you must have been viewing the item originally, by itself, with an action of "show". This is really meant for sites with
items that you would display individually that have a whole bunch of styles/options to an item, such as when buying a computer from Dell or Apple online.
- <cfset attributes.allowsavingcart = "0"> - If this is set to
a number greater than "0", that will be the number of days a customer may save their cart (and even e-mail it to a friend). Their
active cart will still expire in the number of minutes set in attributes.timeout, but if it is saved,
they may reload it using a special code and continue. PLEASE NOTE!
Once an item is placed in a customer's cart, that is the price the customer will pay. So you would
not want to set this to a number that would allow too many customers to span price changes. ALSO NOTE!
Please set the 2 variables below if you use this feature.
- <cfset attributes.timezone = "Pacific Time"> - You will set
this to the time zone you wish to appear when a saved cart is to expire, and would show as "This cart
will be available until midnight Pacific Time". This would likely be where your business is
located so as not to cause confusion.
- <cfset attributes.timeoffset = "3"> - This will be the time
differential between the time zone you specified above and the actual time zone the your web host's
server is in. If you are in Pacific Time and it's 9 AM, and you web host is in New York it would be
Noon (+3 hours), this number would be "3". If the opposite were true, if the server time was 3 hours
earlier than attributes.timezone, you would enter "-3". Keep in mind that to be accurate you will
need to ask your host their policy at Daylight Savings Time. Many hosts leave their server's at
Standard Time, meaning you would need to adjust this to be correct with what people see on their
clocks.
- <cfset attributes.showallcart = "1"> - If this is set to
"1", all items in the cart will show when an item is added to, or updated in the shopping cart.
If set to "0", only the item added or updated will show and there will be a link to "View Entire Cart".
This is helpful if your customers typically purchase a lot of items.
- <cfset attributes.totalorderingquantities = "0"> - You may use minimum
and maximum ordering quantities in product administration. If "1", the total of all styles/colors for a
product id will add up to get the ordered quantity when using minimum and maximum purchase quantities.
In other words, if you set max quantity to 2, the customer could buy 1 red and 1 blue, not 2 of each.
Search engine safe settings. Covered in Search Engine Safe Setup.
Shipping/eDelivery
- <cfset notaxonshipping = ""> - List of states where you charge taxes that you DO NOT tax shipping charges. This
is covered in more detail in Store Setup/Purchasing Setup under Sales Tax/US Tax Method. Read "Note On Shipping and Taxes".
- <cfset attributes.AKHI_local = "1"> - Set to "0" to calculate shipments to Alaska and Hawaii as international shipments. US Shippers only. Covered in detail in Shipping Setup.
- <cfset attributes.APO_local = "1"> - Set to "0" to calculate shipments to APO/FPO military addresses as international shipments. US Shippers only. Covered in detail in Shipping Setup.
- <cfset freightdomestic = ""> - Set the Domestic carrier for items with a Domestic Freight Charge set in Product Administration. Covered in detail in Shipping Setup.
- <cfset freightintl = ""> - Set the International carrier for items with a International Freight Charge set in Product Administration. Covered in detail in Shipping Setup.
- <cfset freightdomesticcharge = "0"> - Additional charge for domestic freight orders. Covered in detail in Shipping Setup.
- <cfset freightintlcharge = "0"> - Additional charge for international freight orders. Covered in detail in Shipping Setup.
- <cfset alternateshipcountries = ""> - List of countries to use an alternate shipping method for. Covered in detail in Shipping Setup.
- <cfset alternateshipmethod = ""> - Shipment methods for the list of countries above. Covered in detail in Shipping Setup.
- <cfset disallowshipping = ""> - List of countries to disallow shipping to. This will only be used if you are using the multi-store setup. Please see that section for details.
- <cfset handlingchargeperpackage = "0"> - Set to "1" to charge the handling charge from administration for each package shipped. Covered in detail in Shipping Setup.
- <cfset shipweightunit = "lb"> - Weight unit if shipping by weight. Covered in detail in Shipping Setup.
- <cfset attributes.edelivery = ""> - Electronic Delivery setting. Covered in detail in Shipping Setup.
- <cfset attributes.edeliveryfilepath = ""> - Path to electronically delivered files (download directory). Covered in detail in Shipping Setup.
- <cfset attributes.edeliverydays = "7"> - Days electronically delivered files will be available for download. Covered in detail in Shipping Setup.
- <cfset attributes.servicecategory = ""> - List of categories that contain non-shippable products. This is covered in detail in Shipping Setup.
- <cfset attributes.show_order_status = "1"> - Set this to "1"
if you want to allow your customers to view the shipping status of past orders.
- See the Tracking Setup page under Shipping & eDelivery Setup for the section below.
<cfset attributes.carrier_1 = "UPS">
<cfset attributes.carrier_1_page = "http://www.yourdomain.com/example.cfm?page=ups_tracking.cfm">
<cfset attributes.carrier_1_url = "http://www.yourdomain.com/example.cfm?page=ups_tracking.cfm&tracking=xoxo-oxox">
<cfset attributes.carrier_2 = "FedEx">
<cfset attributes.carrier_2_page = "http://www.fedex.com/us/tracking/">
<cfset attributes.carrier_2_url = "http://www.fedex.com/cgi-bin/tracking?tracknumbers=xoxo-oxox&action=track&language=english&cntry_code=us">
<cfset attributes.carrier_3 = "US Postal Service">
<cfset attributes.carrier_3_page = "http://www.usps.com/shipping/trackandconfirm.htm">
<cfset attributes.carrier_3_url = "">
<cfset attributes.carrier_4 = "">
<cfset attributes.carrier_4_page = "">
<cfset attributes.carrier_4_url = "">
Checkout
- <cfset usequickpay = "1"> - If your SSL (secure) checkout path (in Store Setup; Paths & URLs; Secure Server) points to the directory containing ezcart and ezcartsecure, set this to "1". This will allow the customer
to enter their credit card information during checkout. If set to "0", credit card information will be entered AFTER the order has been submitted.
- <cfset always_send_confirmation = "1"> - Set this to "0" if you do NOT want to be sent a confirmation e-mail on declined orders if usequickpay="1".
- <cfset authnetpassword = ""> - Authorizenet Password if not using Transaction Key. This field or the authnetkey field MUST be blank.
This is also used for the password or merchant key for any other transaction processor which uses a password or merchant key.
- <cfset authnetkey = ""> - Authorizenet Transaction Key if not using password above. This field or the authnetpassword field MUST be blank.
- <cfset hidesecuritymessage = "0"> - If usequickpay is set to "1", the customer will go to a secure (https) URL at checkout. He may decide
that he wants to view his shopping cart again or order another item. If he clicks on a form button, he bwill generally receive a Warning that he
is submitting information from a secure site to a non-secure site. We display a message, the first time they click Checkout only, that they may
see this warning and that no sensitive information will be passed to any non-secure pages. If you do not wish to show this message, set this to "1".
Keep in mind that some people are paranoid and will simply stop the order process as soon as they get any kind of warning from their browser.
- <cfset attributes.showpurchaseorder = "0"> - We have a Purchase Order payment option in administration. However, you may not wish to
allow people to select that as an actual payment option, in which case you would disable that. Setting this to "1" will
still show a Purchase Order Number field in case some of your customers may need to enter a credit card number AND a purchase order number.
- <cfset showresid = "0"> - Set this to "1" to force the customer to choose whether they are shipping to a Business or Residential address. The address will default to Residential, which, if using
If not using UPS Online® Tools, will cause the shipping rates to be a little higher.
- <cfset showcheckoutgiftmessage = "0"> - Set to "1" if you want to ask the customer to enter a
message for the gift card if the order is a gift, and to remind the customer to enter the
recipient's shipping address (and not their own) for Traditional Gift Certificates.
- <cfset nextbackwidth = "77"> - If you make your own buttons, you may set the width of the
next/back buttons on the search results/product listing page so we can keep everything centered. 77
is the width of the default buttons.
- <cfset hidecvv = "0"> - To hide the CVV (card code) field during checkout, set this to "1".
There may still be some glitches and you may not wish to require it, but
having it there may be a deterrent to a credit card thief.
- <cfset requirecvv = "0"> - To require the CVV (card code) field during checkout, set this to "1". DO NOT set this to "1" if hidecvv is "1".
- <cfset acceptcreditcards = ""> - If this is blank, credit cards will be accepted from all
countries where you allow billing and shipping. If you don't want to allow credit card transactions
from all countries, enter the countries where you WILL allow credit card transactions as a list of 2
letter country codes. These must match the codes in our database. For example, you may allow accept
checks and credit cards. If you set this value to "US,CA", credit cards will only be accepted from
the US and Canada.
- <cfset allowaffiliatesignup = ""> - If your affiliate program is active, this will limit
affiliate signups to the countries listed. Like above, if this is blank affiliates may sign up from
any of your billing/shipping countries.
- <cfset attributes.PayPalID = ""> - Your PayPal ID (email address). If this is NOT empty, PayPal will be a payment option.
- <cfset attributes.use_paypal_IPN = "1"> - Use PayPal's Instant Payment Notification system. If you are selling electronically delivered goods, this should set the order as approved automatically.
- <cfset attributes.AlternatePayPalID = ""> - If using PayPal's
Instant Notification, AND you have more than one e-mail address that you accept payments under, AND
YOU ARE NOT using your primary PayPal e-mail address as the attributes.PayPalID variable, enter the
Primary e-mail address or Instant Notification will fail.
- <cfset attributes.InternetSecureID = ""> - Your InternetSecure ID. If this is NOT empty, InternetSecure will be a payment option.
- <cfset attributes.CCBillAccount = ""> - Your CCBill Account Number. If this is NOT empty, CCBill will be a payment option. In this case, the next 4 variables must also be filled in. Please contact CCBill for assistance setting up the Dynamic Form Pricing Option.
- <cfset attributes.CCBillSubAccount = ""> - CCBill Sub Account for dynamic pricing options.
- <cfset attributes.CCBillForm = ""> - The form to be shown to the customer at CCBill.
- <cfset attributes.CCBillKey = ""> - Encryption key. Generated by CCBill support.
- <cfset attributes.CCBillPeriod = "1"> - Leave this at "1" unless CCBill tells you to change it.
- <cfset attributes.CCBillDRMPassPhrase = ""> - This will be the same as attributes.CCBillKey if you are using Digital Rights Management for downloads. Be certain to select MD5 as the HASH type in your CCBill setup admin.
- <cfset attributes.privacy = "1"> - Set to "0" to hide the link to the privacy statement at checkout. If you would like to edit the privacy statement, it is in ezcart/privacy.cfm.
- <cfset attributes.enablepasswordcookie = "0"> - Set this to "1" to allow your customers to store their login information for future purchases.
- <cfset passwordfieldtype = "text"> - If this is "text", the customer's password will be shown in clear text. We don't store any vital information like credit cards so this is usually fine.
However, if you want to use a "password" field, where the password shows as "******" when entered, change this to "password". The customer will then
have to enter the password twice to verify it was entered correctly.
- <cfset showhint = "0"> - If this is set to "1", we will allow the customer to enter a password hint. If they then forget their password, the hint will be e-mailed to them. If the hint is left empty, their actual password will be e-mailed to them.
- <cfset requirehint = "0"> - If this is set to "1", the customer will be required to enter a hint. Otherwise, it is their choice.
- <cfset attributes.taxbillingaddress = "0"> - There are conflicting answers as to when sales tax should be charged... based on the shipping address or based on the billing address. We personally feel it is based on the shipping address as that is where the item is being used.
This doesn't often come into play as 99% of orders are billed and shipped to the same state. However, if you feel you need to charge sales tax based on the billing address as opposed to the shipping address, set this variable to "1".
- <cfset attributes.deferpayments = "0"> - If this is set to "1", the customer will be allowed to check out, but will not
be given a payment option. You will then go in and set final totals when viewing the order through administration. The customer will be e-mailed that their
order total has been calculated and given a link to make their payment. At that point they may choose from your regular payment methods. Note that if you only
have certain items that cannot be calculated, you may set this on an item by item basis, and even on a style by style basis within an item. Please
see Deferred Payments for more information.
- <cfset attributes.deferpaystylemark = ""> - If you enter a mark, such as * we will show this in the Style Selection menus.
You may then make a note either in the product description or in the Style Group caption to the effect of "Items marked with * are custom manufactured and cannot be priced immediately.
We will contact you via e-mail upon calculating your final total.". Note that if the Product itself has been set to trigger the Deferred payment option.
- <cfset attributes.deferpayproductmark = ""> - Same as above, but on the product level. This will appear directly after the SKU number. This one may also use just a mark,
or you may enter something like...
<cfset attributes.deferpayproductmark = "<br>Custom Manufactured">
This will cause the item "Widget" with a SKU number of "ABC" to appear as...
Widget
SKU # ABC
Custom Manufactured
Conversly, entering a value such as " (CM)" will cause the item to appear as...
Widget
SKU # ABC (CM)
You may place a note on the site similar to the one we showed in the Style sample above. Once again, see Deferred Payments for more information.
- <cfset attributes.defercalculateshipping = "0"> - If you are using the Deferred Payment option on the product level or the style level,
you may set this to "0" to cause shipping calculation to be deferred. This will bypass your normal shipping setup. You may then enter the shipping costs when entering
the item costs. If set to "1" shipping will be calculated by your normal setup.
- <cfset attributes.defercapturecredit = "0"> - If this is set to "1", we will capture credit card information and you will
run the transaction manually after calcualting the final total. If set to "0", the customer will return to the site
after being notified that their order has been finalized. Here they may enter their credit card, echeck or choose another payment method if permitted.
- <cfset attributes.show_ein = "0"> - If you wish to allow tax exempt businesses to enter their Employer Identification
Number, set this variable to "1" This will allow them to enter their EIN and set their customer record to tax exempt. You may still wish to have them fax their tax exempt status to your business for verification, but
this will allow their first order to be tax exempted.
- <cfset attributes.creditapplink = ""> - If you allow any of your customers to pay "on account", for example, through a monthly billing cycle, those customers may be flagged as having an "Open Account".
Open Account customers are not required to submit their credit card or other payment information.
This may be done manually through Customer Administration. Alternately, if you wish to allow new or returning customers to fill out a credit application, you may put the full URL to the application here. After the purchase, this link will be shown as
a link to the Credit Application. When viewing the order through administration, after approving the credit application, you may approve the order and set the customer to "Open Account", allowing future orders to be placed
without entering payment information. If you must reject the credit application, you will have the means to send a rejection e-mail along with a link to pay for the order through your traditional payment methods.
There is no credit application built into the shopping cart. We will pass the Customer ID through the link as cust_id=xxx. You may use this as you wish.
- <cfset attributes.allowopenaccountpayments = "1"> - By default, we allow customers who have an "Open Account" to choose an alternate payment method, in case they wish to pay
by credit card, check, etc. for a particular order. Set this to "0" to force them to charge all orders to their account.
- <cfset attributes.forceordersummary = "0"> - After entering billing and shipping information (if shipping applicable), the user is taken to a page where they may review
the information they entered. Any applicable shipping charges are also calculated here. By default, we allow the customer 2 choices (in addition to being able to go back to edit their billing/shipping info),
Summarize the Order or Submit the Order. To hide the Submit Order button at this point, forcing the customer to view a summary of the order before submitting
the final order, set this to "1".
- <cfset attributes.deferzeroshipping = "0"> - By default, when we have a zero shipping cost, we consider the shipping free
and tell the customer FREE SHIPPING. If you do not wish to use our Drop Ship shipping method, but wish to allow your customer to choose from
multiple shipping options, set this to "1". Payment calculation will then be delayed and all FREE messages will be suppressed.
- <cfset variables.acceptechecks = "0"> - Set to "1" to accept eChecks.
You will need software to print the draft to present to your bank. This is only used if you do not use a credit card processing gateway that accepts eChecks.
- <cfset attributes.ThreeDSecure = ""> - This is the 3DSecure protocol gateway. Similar to a credit card processing
gateway, this is used to connect to Verified By Visa and Mastercard SecureCode. Click here for setup instructions.
- <cfset attributes.payatsummary = "0"> - If usequickpay = "1" we will wait until after the shipping and taxes are calculated to ask for credit card.
Discounts & Pricing
- <cfset attributes.webbucks = ""> - In Purchasing Setup in
administration, there is an option to set a discount percentage on all orders over X number of
dollars. If you enter a value here, such as "Web Bucks" or something catchy to suit your website,
the number you enter in the discount field will give a store credit for every dollar amount entered
in the "Discount At" field, good toward a future purchase rather than a percentage discount on the immediate purchase.
Example, if "Web Bucks" (or something similar) is entered here, and you entered in administration: 20%
discount for purchases over 100.00, the cart will issue a $20.00 credit for every $100.00 spent,
which may be cashed in at any future purchase.
- <cfset attributes.multiprice = "0"> - Covered in detail in the Multiple Pricing Levels section.
- <cfset request.categorypriceproduct = ""> - We've expanded upon the "Price Based On Quantity"
in cf_ezcart to allow the prices to adjust based on items in one or more categories. Example, ordering 5 of Item A and 5 of Item B will count as 10 items
in the pricing schedule. Quick instructions and example below. Replace "AAA" with your own value here:
- <cfset request.categorypriceproduct = "AAA">
- Enter an item in administration with a Product ID of the value above, plus a hyphen, plus one or more characters. You may want to use the Category ID
for the additional characters. The Category Price Product for Category 5 may have an ID of "AAA-5".
- Set the Price Based On Quantity for this product.
- Now all items in Category 5 that have a blank price will count toward the Quantity.
- Yoy may choose multiple categories for this pricing item. Remember, the "5" we entered is just an example and does not have to
be a Category ID. Your customers will never see this ID.
- <cfset attributes.expandquantity = ""> - This works similar to, and may or may not be used in conjunction with the category pricing above, but
allows more flexibilty. There are 2 possible settings for this variable, "sub" and "main". If set to "sub", the quantity of every item ordered from a category counts toward the
quantity price of that and every other item in that category. If set to "main", the quantity of every item ordered from a main category counts toward the
quantity price of that and every other item in that main category. If blank, this is ignored and every item counts as it's own quantity.
- <cfset attributes.expandcategory = ""> - By default, all of the "sub" categories or "main" categories will be used to expand the quantity above. You may set a comma delimited
list (with no spaces) of Category IDs (if "sub" above) or Main Category IDs (if "main" above) to limit the expandquantity variable to those categories.
- <cfset attributes.hidecategorypricemessage = "1"> - Set to "0" if you don't want your customers to see our message
concerning category pricing on the regular product list pages. You may want to leave it on for testing purposes though.
Product Display/Search Results
- <cfset attributes.showdetail = ""> - Covered in Add Products under "Description Options".
- <cfset attributes.skuword = "Catalog No."> - Change this if you like. This will be displayed before the Product ID/Product Part. Remove altogether to hide the
Product ID/Product Part when viewing the product.
- <cfset attributes.skuwordcart = "Catalog No."> - Just like above, but how it displays in the customer's basket, in the order summary, order confirmation e-mails,
administration, etc. Basically anywhere except when viewing the item on the product display pages. Again, make this blank to hide the Product ID/Product part in these areas.
- <cfset attributes.optionword = ""> - Enter a value if you like. This will be link text for any items which you have grouped together (options). If you leave this blank, you may show
the items entered in the Product's Options field as related products. Please see attributes.showrelatedpurchases under Miscellaneous Settings below.
- <cfset attributes.uselistpage = "List1"> - There are 4
different styles/layouts for the product listing page. Note there is no space in these values
and that on Unix systems this is case sensitive. Click the link to see a sample of each.
- "List1" - to use the default.
- "List2" - to use one similar to the default, except the ordering button
is below the description.
- "List3" - to use the one similar to List2 except that the top bar,
manufacturer and category do not show. List2 and List3 are good if you're using styles that have
long menus that may push the products display table too wide.
- "List4" - if you wish to allow customers to order multiple items from
the product listing page. Similar to List 3 in that the top bar, manufacturer and category do not
show. You cannot use the features below when using multiple item ordering.
- Inventory Control
- Product Promotional Codes (you may use sitewide promotional codes)
- <cfset attributes.listtablespacing = "1"> - The cellspacing of the product display table cells. The samples above have a cellspacing of "1".
Set to "0" to make each record a solid color. You can also set higher than 1 but too high will look funky.
- Product Listing Table Size - The values below are if you need to "tweak" the size of the product display table
and the table cells. Leaving any of these at "0" will let the table or cell size naturally (there will be no width attribute). These can be absolute sizes
or percentages. Be sure to enter only whole numbers, and the percent sign if needed, or no telling what will happen.
Examples: "500" or "95%"
- <cfset attributes.listtablewidth = "0"> - Sets the width of the table.
- <cfset attributes.thumbnailcellwidth = "0"> - Sets the width of the cell with the product image.
- <cfset attributes.categorycellwidth = "0"> - Sets the width of the cell with the category name.
Only used with List1 and List2 templates above.
- <cfset attributes.mfrcellwidth = "0"> - Sets the width of the cell with the manufacturer name.
Again, only used with List1 and List2 templates above, and only if you choose to display that in Store Appearance.
- <cfset attributes.pricecellwidth = "0"> - Sets the width of the cell with the product
price. In List3, this will be the large cell with the description.
- <cfset attributes.centercellwidth = "0"> - Sets the width of the cell with the description
in the List4 template above.
- Product Details Table Size - Same as above but for the page that displays when you click
"View Details" on an item from the page above. Once again, leaving any of these at "0" will let the table or cell size naturally (there will be no width attribute).
- <cfset attributes.detailstablewidth = "0"> - Sets the overall width of the table.
- <cfset attributes.detailscontentcellwidth = "100%"> - Sets the width of the cell with the order button and description.
- <cfset attributes.detailsimagecellwidth = "0"> - Sets the width of the cell with the product image. Please note that
we have the cellpadding for the details table set at "0" but have an hspace (horizontal spacing) of "5" set on the detail image (only if attributes.detailimageabove is set to "0" below). So if you set this width, it should be set 10
pixels wider than your largest image.
- <cfset attributes.detailimageabove = "0"> - If set to "0", the product image will be to the left of the
description and order button. If set to "1", the product image will be above the description and order button. This is helpful
if you have either very wide images or if your template has little room for the images and description to be side by side.
- <cfset attributes.colorallcells = "1"> - If you are using
background colors in your product listings table, by default we only include the background color in
the descriptive cells, except if using List4 above, in which case we do use the background color in
all cells. Set this value to "1" to use the background color in all cells.
- <cfset attributes.imagepath = ""> - Covered in Add Products
under "Product Image Naming Convention and Placement".
- <cfset attributes.zoomin = ""> - If you would like a link to
pop open a window to show the larger image in directory "Products", set this to other than blank.
The text you enter will be the link text. Not much use in this unless you are using "thumbnail"
above or leaving it blank and only using one description field. You could also show a third, even
larger picture by editing the zoom.cfm file in the ezcart directory to point to a directory other
than products or to append something to the large picture name, like 123_large.jpg. Just look for
this string in zoom.cfm:
ezcart/products/#img#.jpg
Then make it something like:
ezcart/products/#img#_large.jpg
Name your pictures accordingly, or change the directory ezcart/large_products/#img#.jpg and place
the real big pictures in there. The product ID is passed as #img#
- <cfset attributes.searchonmain = "0"> - To search and browse
on the Main Categories only, enter "1". This is useful if you are using Categories as a choice
of style field, and not really as a browsing field. The styles feature of the cart is much more
flexible however, but this is available.
- <cfset attributes.duplicates = "0"> - If you are duplicating products
using the same Product ID under multiple Categories, enter "1".
- <cfset attributes.maxrecordset = "200"> - Set the maximum number of records to return in a search.
Useful if you have thousands of products and someone searches for "a". Will give a message that "Your search returned over 200 results.
Please refine your search parameters.
- <cfset attributes.searchman = "1"> - Advanced Search Only. To give the option of
searching and browsing particular Manufacturers/Artists, etc., enter "1". In addition, the Manufacturer Heading value in Store Setup,
Edit Aapearance must be something other than "None".
- <cfset attributes.searchunder = "20.00,50.00,100.00,200.00"> - Advanced Search Only.
To give an option for search values, enter a comma delimited list here with no spaces, no commas,
and no dollar signs. Example: attributes.searchunder = "100.00,200.00,300.00,400.00" This will show
a select list as:
All Prices
Under $100.00
Under $200.00
Under $300.00
Under $400.00
Note! This will not show any items priced at 0.00, so if you are going to use this feature in the
advanced search, you will probably not want to pice items solely based on "Styles", but set the
price to the lowest price and add the additional amount on more expensive styles as necessary.
- <cfset attributes.sortresults = ""> - This is used to sort
the product display/search results. Note that there is a sort order field which is always sorted
on first. To make this field insignificant, you may simply leave the sort order field value at 0
on all items.
- "ID" - Sort Order Field, then Product ID field.
- "Name" - Sort Order Field, then Product Name field.
- "" (blank or any other value) - Sort Order Field, then Product Price field,
then Product Name field.
- "DESC" - Sort Order Field Descending (Highest to Lowest), then Product Price field Descending,
then Product Name field Ascending.
- <cfset attributes.sortmancat = ""> - If you would like to
sort manufacturers and categories bu name, enter "Name". Otherwise they will be sorted by ID.
- <cfset attributes.colorchart = ""> - We can show a popup
window to a colorchart. You must do 2 things for this to happen. First, put the value here that you
would like the link to show up as. "View Patterns", etc. Then, any swatches you would like to
appear, must be given a numeric character as the first character of the color code in
administration, like 207 or 1AA. This is in case you have some plain colors that you do not want to
show as swatches, you can use codes such as BK, BL, etc. Make the images jpgs and no wider than 200
pixels. This is also covered in "Colors, Patters, etc.".
- <cfset attributes.giftfrom = "25"> - Minimum Gift Certificate Amount. Covered in Gift Certificates section.
- <cfset attributes.giftto = "500"> - Maximum Gift Certificate Amount. Covered in Gift Certificates section.
- <cfset attributes.giftstep = "25"> - Gift Amount Select Menu increments. Covered in Gift Certificates section.
- <cfset attributes.giftelecid = "EGC"> - Set this to the ID/SKU of the electronic gift certificates if you use them.
- <cfset attributes.gifttradid = "TGC"> - Set this to the ID/SKU of the traditional gift certificates if you use them.
- <cfset attributes.choosecat = "0"> - Standalone Cart Only: If you are using main categories,
but want to bypass the page to choose a main category, delete the 1.
- <cfset attributes.catrequired = "0"> - Standalone Cart Only: If you set attributes.choosecat to 1, and want to force customers to make
a selection, enter "1".
- <cfset attributes.showcat = "0"> - Standalone Cart Only: If you are choosing to go to the page above,
but don't want to show images on that page, make this "0". Otherwise, enter "1".
- <cfset attributes.chooseman = "0"> - Standalone Cart Only: If you are using the Manufacturers table,
but want to bypass the page to choose a manufacturer, make this "0". Otherwise, enter "1".
- <cfset attributes.manrequired = "0"> - Standalone Cart Only: If you set attributes.chooseman to 1, and want to force customers to make
a selection, enter a 1 here.
- <cfset attributes.showman = "0"> - Standalone Cart Only: If you are choosing to go to the page above,
but don't want to show images on that page, make this "0". Otherwise, enter "1".
- <cfset attributes.forcestyleselection = "0"> - Covered in detail in Styles section.
- <cfset attributes.sortstylesby = "StyleCode"> - Covered in detail in Styles section.
- <cfset attributes.showstylegroupicons = "0"> - Covered in detail in Styles section.
- <cfset attributes.stylemenustyle = ""> - Covered in detail in Styles section.
- <cfset attributes.spanselections = ""> - Covered in detail in Styles section.
- <cfset attributes.spanselectionsdetails = ""> - Covered in detail in Styles section.
- <cfset attributes.styletopartreplace = "0"> - See the Style Groups section of Product Styles for more information.
- <cfset attributes.styletopartdelim = "-"> - See the Style Groups section of Product Styles for more information.
- <cfset attributes.productgrouping = "0"> - Allows inventory
control on "Style" combinations. Only the main item in the group will show when browsing and
searching products. See the Product Grouping section of Product Styles for more information.
Other settings
- <cfset attributes.showrelatedpurchases = "0"> - If you would
like to show related purchases when a person orders, enter a number higher than 0. cf_ezcart
will query the database for orders containing the item[s] entered into the cart and show other items
that were purchased during the same order. These will be displayed in order of popularity (item
ordered most often shown first). The number you display below will be the maximum nomber of related
items we will show. Don't enter anything ridiculous like 50. We feel between 3 and 5 items will be
least offensive to the shopper. We will not show the item just ordered or any other items already in
the shopper's basket. Alternately, you may enter the word "options" here to specify which items to show by
entering a comma delimited list in the Options field in Product administration. attributes.optionword must
be blank for this to work.
- <cfset attributes.useorderbyalias = ""> - Set this to 1 if using MySQL
and you get errors related to the "Group By" clause when ordering an item (if attributes.showrelatedpurchases = "1").
- <cfset attributes.banners = ""> - If you have affilaite
banners, place them in the banners directory inside the ezcart folder. Then list them in a comma
delimited list, like so:
attributes.banners = "banner1.gif,banner2.gif,banner3.gif"
Note! No spaces in this list.
- <cfset attributes.bannerwidth = ""> - Specify the banner widths in the same order as above. Example: If
banner1.gif is 468 X 60, banner2.gif is 324 X 60 and banner3.gif is 100 X 100, you would enter the 3 widths:
attributes.bannerwidth = "468,324,100"
Note! No spaces in this list.
- <cfset attributes.bannerheight = ""> - Specify the banner heights in the same order as above. Example: If
banner1.gif is 468 X 60, banner2.gif is 324 X 60 and banner3.gif is 100 X 100, you would enter the 3 heghths:
attributes.bannerheight = "60,60,100"
Note! No spaces in this list.
- <cfset attributes.linktext = "Visit Our Cool Website"> - The "alt" text for the banner,
or the text that will appear in most browsers when hovering over the banner with your cursor. Make this something not "TOO" long, like
"Visit Joe's Emporium For Excellent Bargains"
- <cfset noautoincrement = "0"> - By default, Order numbers and
affiliate IDs increment automatically. However, if for some reason we had to change those fields to
regular Integer fields (such as importing records from an older version), set this to "1" and we will
increment the values through our code.
- <cfset uploaddirectorytn = ""> - If you upload product images in administration and get an error that
the directory can't be found, try entering the physical path here. This one is for the thumbnails and would point to products_tn as in "C:\mysite\ezcart\products_tn\".
- <cfset uploaddirectory = ""> - Same as above but for larger images if you're using them and will point to ezcart\products.
- <cfset uploaddelim = ""> - You may be able to leave those blank and just enter the delimiter. If you're using Windows, it would be "\". Linux would be "/".