ShopSite Custom Template Tags

Global Tags
Page Tags
Product Tags
Search Tags
Shopping Cart Tags
Customer Registration Tags
Gift Certificate Tags
Mobile Tags
Order Management Tags
All Tags

For greater detail on these tags and how to use them, please see our Template Specification page.

Shopping Cart Tags


(These tags are organized by the pages in which they typically would be used. Some tags are shown on multiple pages.)

Special Shopping Cart Tags


(These tags can be used on any shopping cart page)
[-- STORE.SC_YourShoppingCart --] Text field: Your Shopping Cart
[-- SC_JavaScript Extras --] The JavaScript required on shopping cart pages
[-- ShopSiteMessages --] Displays any (error) messages to the shopper.
[-- SC_FORM --] The opening <FORM> tag and a few hidden values for the shopping cart. This tag MUST precede most of the other SC_ tags.
[-- IP_ADDR --] The IP address of the shopper
[-- SC_USE_SECURITY --] Returns checked if the shopping cart is set to use a secure URL.
[-- STORE.Secure_Image_URL --] Returns the ShopSite Images secure URL.
[-- STORE.SC_Secure_Image_URL --] Returns the Secure Store URL.
[-- IF Cart_Image --] True if product images will be displayed in the shopping cart.

Colors and Background

[-- STORE.SC_BackgroundColor --] Shopping cart background color
[-- STORE.SC_TextColor --] Shopping cart text color
[-- STORE.SC_LinkColor --] Shopping cart link color
[-- STORE.SC_VisitedLinkColor --] Shopping cart visited link color
[-- STORE.SC_ActiveLinkColor --] Shopping cart active link color
[-- STORE.SC_BackgroundImage --] Shopping cart background image
[-- STORE.SC_ShadeColor --] Shopping cart table shade color

Shopping Cart Page


(These tags are used on the first shopping cart page)

Defines

[-- DEFINE ShoppingCart --] The beginning of the HTML for the shopping cart template
[-- END_DEFINE ShoppingCart --] The end of the HTML for the shopping cart template
[-- DEFINE GLOBAL_CROSS_SELL --] The Global Cross-Sell HTML for the shopping cart template
[-- END_DEFINE GLOBAL_CROSS_SELL --] The end of the Global Cross-Sell HTML for the shopping cart template
[-- DEFINE CART_CROSS_SELL --] The Cart Cross-Sell HTML for the shopping cart template
[-- END_DEFINE CART_CROSS_SELL --] The end of the Cart Cross-Sell HTML for the shopping cart template

Google Checkout pre-cart screen

[-- IF Google_Checkout --] True if you're on the Google Checkout pre-cart screen.

Header and Footer

[-- ShoppingCartHeader --] Text at the top of the Shopping Cart Screen
[-- IF ShoppingCartHeader --] True if there is content in the Shopping Cart Header field.
[-- ShoppingCartFooter --] Text at the bottom of the Shopping Cart Screen
[-- IF ShoppingCartFooter --] True if there is content in the Shopping Cart Footer field.

Customer Registration

[-- SC_Registration --] Links to register or sign in. (Also IF)
[-- SignedIn? --] True if the customer is signed in
[-- SC_Must_Register --] True if the customer must be registered to check out

Table of Products Ordered

[-- SC_ShowBasket --] The "Show me my basket every time I order something" checkbox.
[-- SC_Remove_Button --] True if the merchant wants "Remove" buttons for each product
[-- SC_Cart --] The table showing the products ordered and the order subtotal
[-- SC_Cart delete quantity image name sku price total --] The table showing the products ordered and the order subtotal, with the fields in the order specified.

Tax and Shipping

[-- SC_Tax_Shipping --] The form fields for tax and shipping
[-- SC_VAT_ID --] The form fields for the EU VAT ID
[-- SC_Tax_Shipping Button --] The form fields for tax and shipping, plus a "Tax/Shipping" button to recalculate
[-- BUTTON TaxShipping --] Tax/Shipping button

Coupons

[-- SC_Coupon --] The form field for the customer to enter a coupon name/number. (Also IF)
[-- SC_Coupon_Button --] True if the merchant wants the "Apply Coupon" button
[-- STORE.CouponCaption --] Text field: Coupon Code:
[-- STORE.EnterCoupon --] Text field: If you have a coupon, enter the code and press recalculate
[-- BUTTON ApplyCoupon --] "Apply Coupon" button

Gift Certificates

[-- SC_GiftCert --] The form field for the customer to enter a gift certificate number and PIN. (Also IF)
[-- SC_GiftCert_Button --] True if the merchant wants the "Redeem Certificate" button
[-- STORE.GiftCertCaption --] Text field: Gift Certificate:
[-- STORE.EnterGiftCert --] Text field: If you have a gift certificate, enter the code and PIN then press recalculate
[-- GiftCert_Redeem --] Store text: Redeem Certificate
[-- STORE.GiftCert_Recalculate --] Store text: Recalculate
[-- BUTTON ApplyGiftCert --] "Redeem Certificate" button

Reward Program

[-- SC_REWARD_PROGRAM --] Creates a table showing the customer's reward program status (Also IF)

Global Cross-sell

[-- IF Global_Cross_Sell --] True if Global cross-sell is enabled
[-- STORE.GlobalCrossSellHeader --] Header text for global cross-sell table
[-- LOOP GLOBAL_Cross_Sell {columns} --] Begin global cross-sell loop and optionally specify the number of products per row
[-- GLOBAL_CROSS_SELL --] Insert global cross-sell item within loop
[-- END_LOOP Global_Cross_Sell --] End global cross-sell loop

Product Cross-sell

[-- IF Cart_Cross_Sell --] True if product specific cross-sell in the cart is enabled
[-- STORE.CartCrossSellHeader --] Header text for product cross-sell table
[-- LOOP CART_Cross_Sell {columns} --] Begin product cross-sell loop and optionally specify the number of products per row
[-- CART_CROSS_SELL --] Insert product cross-sell item within loop
[-- END_LOOP Cart_Cross_Sell --] End product cross-sell loop

Surcharges

[-- SC_Surcharge --] The form fields for surcharges

Totals

[-- SC_Totals --] Displays product subtotal, shipping charges, tax charges, and the order total
[-- STORE.SC_AnyChanges --] Text field: Any changes above should be verified by pressing 'Recalculate' before clicking on 'Checkout'.

Ordering Instructions

[-- SC_OrderingInstructions --] Ordering instructions heading and text box (Also IF)
[-- SC_OrderingInstructions {rows columns} --] The ordering instructions text and box with specified box dimensions

Payment

[-- SC_PaymentSelection --] The form fields for selecting payment type

High Security Image

[-- IF ShopSiteSecurityImage --] True if displaying the high security logo is turned on
[-- ShopSiteSecurityImage --] The HTML to display the high security logo

Buttons

[-- BUTTON Recalculate --] The "Recalculate" button
[-- BUTTON Update --] The "Update" button
[-- BUTTON EmptyCart --] The "Empty Cart" button
[-- BUTTON ContinueShopping --] The "Continue Shopping" button
[-- BUTTON Checkout --] The "Checkout" button

Billing/Shipping Page


(These tags are used on the shipping page)

Defines

[-- DEFINE Shipping --] The beginning of the HTML for the shipping template
[-- END_DEFINE Shipping --] The end of the HTML for the shipping template

Header and Footer

[-- ShippingHeader --] Text at the top of the Shipping Screen
[-- IF ShippingHeader --] True if there is content in the Shipping screen Header field.
[-- ShippingFooter --] Text at the bottom of the Shipping Screen
[-- IF ShippingFooter --] True if there is content in the Shipping screen Footer field.
[-- STORE.Ship_Checkout --] Text field: Checkout

Table of Products Ordered

[-- SC_Cart --] The table showing the products ordered and the order subtotal
[-- SC_Cart quantity name sku price total --] The table showing the products ordered and the order subtotal, with the fields in the order specified.

Totals

[-- SC_Totals --] Displays product subtotal, shipping charges, tax charges, and the order total

Comments

[-- SC_Comments {rows columns} --] Customer comments heading and text box with specified dimensions (Also IF)

Billing and Shipping Address

[-- SC_Address --] Billing and shipping address forms, horizontal arrangement
[-- SC_Address Vertical --] Billing and shipping address forms, vertical arrangement
[-- SC_Address Right--] Billing and shipping address forms, field labels on right

E-Mail List

[-- Email_List --] Text and checkbox for "add to e-mail list" (Also IF)

Payment

[-- SC_Payment --] Form for entering payment information

Custom Checkout Fields

[-- CustomHTML --] True if Custom Checkout Fields are enabled
[-- Ship_CustomHTML n --] Insert the Custom Checkout Field where n is 1 to 5

Human Validation Image

[-- IF SecurityImage --] True if the human validation image feature is enabled
[-- ShipSecurityImage --] Includes the human validation image elements on the payment screen.

High Security Image

[-- IF ShopSiteSecurityImage --] True if displaying the high security logo is turned on
[-- ShopSiteSecurityImage --] The HTML to display the high security logo

Buttons

[-- BUTTON SubmitOrder --] The "Submit This Order" button, or the "Confirm" button if confirmation page is enabled
[-- BUTTON ReturnToCart --] The "Return to Cart" button

Confirmation Tags


(These tags are used on the optional confirmation page)

Defines

[-- DEFINE Confirmation --] The beginning of the HTML for the confirmation template
[-- END_DEFINE Confirmation --] The end of the HTML for the confirmation template

Header and Footer

[-- ConfirmationHeader --] Text at the top of the Confirmation Screen
[-- IF ConfirmationHeader --] True if there is content in the Confirmation screen Header field.
[-- ConfirmationFooter --] Text at the bottom of the Confirmation Screen
[-- IF ConfirmationFooter --] True if there is content in the Confirmation screen Footer field.

Table of Products Ordered

[-- SC_Cart --] The table showing the products ordered and the order subtotal
[-- SC_Cart quantity name sku price total --] The table showing the products ordered and the order subtotal, with the fields in the order specified.

Totals

[-- SC_Totals --] Displays product subtotal, shipping charges, tax charges, and the order total

Ordering Instructions

[-- IF SC_OrderingInstructions_Text --] True if customer entered any text in the Ordering Instructions box
[-- SC_OrderingInstructions --] Ordering instructions text entered by customer

Custom Checkout Fields

[-- CustomHTML_Values --] Display Custom Checkout Fields and values. (Also IF)

E-Mail List

[-- Email_List --] Display the text of the e-mail signup

Comments

[-- SC_Comments --] Customer comments text and box (Also IF)
[-- SC_Comments_Text --] True if comments entered by customer

Billing and Shipping Address

[-- SC_Address --] Display the billing and shipping addresses

Payment

[-- SC_Payment --] Display the payment information

High Security Image

[-- IF ShopSiteSecurityImage --] True if displaying the high security logo is turned on
[-- ShopSiteSecurityImage --] The HTML to display the high security logo

Buttons

[-- BUTTON Confirmation --] The "Submit This Order" button
[-- BUTTON MakeChanges --] The "Make Changes" button

Thank You Tags


(These tags are used on the Thank You page)

Defines

[-- DEFINE ThankYou --] The beginning of the HTML for the thank you template
[-- END_DEFINE ThankYou --] The end of the HTML for the thank you template

Header and Footer

[-- ThankYouHeader --] Text at the top of the Thank You Screen
[-- IF ThankYouHeader --] True if there is content in the ThankYou screen Header field.
[-- ThankYouFooter --] Text at the bottom of the Thank You Screen
[-- IF ThankYouFooter --] True if there is content in the ThankYou screen Footer field.
[-- STORE.SC_ThankYou --] Text field: Thank you!
[-- STORE.SC_YourReceipt --] Text field: Here is a copy of your receipt.
[-- STORE.SC_OrderNumber --] Text field: Order Number
[-- STORE.SC_ThankYouBusiness --] Text field: Thank you for your business!
[-- ThankYouOrderNumber --] The order number
[-- ThankYouReturnStore --] "Return to Store" button or text

Table of Products Ordered

[-- SC_Cart --] The table showing the products ordered and the order subtotal
[-- SC_Cart quantity name sku price total --] The table showing the products ordered and the order subtotal, with the fields in the order specified.

Totals

[-- SC_Totals --] Displays product subtotal, shipping charges, tax charges, and the order total

Ordering Instructions

[-- IF SC_OrderingInstructions_Text --] True if customer entered any text in the Ordering Instructions box
[-- SC_OrderingInstructions --] Ordering instructions text entered by customer

Custom Checkout Fields

[-- CustomHTML_Values --] Display Custom Checkout Fields and values. (Also IF)

Comments

[-- SC_Comments --] Customer comments text and box (Also IF)
[-- SC_Comments_Text --] True if comments entered by customer

Thank You E-Mail Tags


(These tags are used on the e-mail receipt)

Defines

[-- DEFINE ThankYou_Email --] The beginning of the HTML for the thank you e-mail
[-- END_DEFINE ThankYou_Email --] The end of the HTML for the thank you e-mail

Header and Footer

[-- ThankYouHeader --] Text at the top of the Thank You Screen
[-- IF ThankYouHeader --] True if there is content in the ThankYou screen Header field.
[-- ReceiptFooter --] Text at the bottom of the e-mail receipt
[-- STORE.SC_ThankYou --] Text field: Thank you!
[-- ThankYouReturnStore --] "Return to Store" button or text
[-- ThankYouOrderNumber --] The order number

Table of Products Ordered

[-- SC_Cart --] The table showing the products ordered and the order subtotal
[-- SC_Cart quantity name sku price total --] The table showing the products ordered and the order subtotal, with the fields in the order specified.

Totals

[-- SC_Totals --] Displays product subtotal, shipping charges, tax charges, and the order total

Payment

[-- SC_Payment --] Display the payment information

Ordering Instructions

[-- IF SC_OrderingInstructions_Text --] True if customer entered any text in the Ordering Instructions box
[-- SC_OrderingInstructions --] Ordering instructions text entered by customer

Custom Checkout Fields

[-- CustomHTML_Values --] Display Custom Checkout Fields and values. (Also IF)

Comments

[-- SC_Comments --] Customer comments text and box (Also IF)
[-- SC_Comments_Text --] True if comments entered by customer

Billing and Shipping Address

[-- SC_Address --] Display the billing and shipping addresses

Global Cross-sell


(These tags are used in the global cross-sell section)

Defines

[-- DEFINE GLOBAL_CROSS_SELL --] The beginning of the HTML for the global cross-sell product.
[-- END_DEFINE GLOBAL_CROSS_SELL --] The end of the HTML for the global cross-sell product.

Links

[-- IF CROSS_SELL_LINK --] True if cross-sell product links enabled
[-- CROSS_SELL_LINK --] URL of cross-sell link destination

PRODUCT tags


Any PRODUCT database tag can be used in a cross-sell definition.
[-- PRODUCT.Name --] Name of the product
[-- PRODUCT.Price --] Price of the product
[-- PRODUCT.Graphic --] IMG tag for product graphic
[-- PRODUCT.AddToCartURL --] URL of add-to-cart link for product.
REMINDER: Do NOT use form elements within cross-sell definitions!

Product Cart Cross-sell


(These tags are used in the product cart cross-sell section)

Defines

[-- DEFINE CART_CROSS_SELL --] The beginning of the HTML for the cart product cross-sell product.
[-- END_DEFINE CART_CROSS_SELL --] The end of the HTML for the cart product cross-sell product.

Links

[-- IF CROSS_SELL_LINK --] True if cross-sell product links enabled
[-- CROSS_SELL_LINK --] URL of cross-sell link destination

PRODUCT tags


Any PRODUCT database tag can be used in a cross-sell definition.
[-- PRODUCT.Name --] Name of the product
[-- PRODUCT.Price --] Price of the product
[-- PRODUCT.Graphic --] IMG tag for product graphic
[-- PRODUCT.AddToCartURL --] URL of add-to-cart link for product.
REMINDER: Do NOT use form elements within cross-sell definitions!

ShopSite Shopping Cart Software