Template Reference Guide
Table Of Contents
(TIP: Code blocks and variables are designed to be used specifically within their intended templates and will not be processed otherwise.)
01. Introduction
The 3dCart Template Engine gives you complete control over the layout of
your store. The engine uses two techniques to automatically place content within the HTML templates:
01-01<!--CODE BLOCKS-->
The code blocks define a snippet of HTML which the software can then use to
create a part of the page, and or, if no data exists, remove it from the page
leaving the rest of the page intact.
EXAMPLE:
<!--START: BLOCKNAME-->
Something goes here...
<!--END: BLOCKNAME-->
The template engine can find this block of code, in this case it's called “BLOCKNAME”. Then, depending on what function it serves, either remove it completely or duplicate it as many times as necessary.
For example, when defining the menu links in the "frame.html" template, a block
such as...
<!--START: TOP_LINK -->
<table cellpadding="4" cellspacing="1" border="1" width="100%">
<tr>
<!--START: TOP_LINK_FORMAT-->
<td><a href=””>[link_name]</a></td>
<!--END: TOP_LINK_FORMAT-->
</tr>
</table>
<!--END: TOP_LINK -->
...would be used. If there were three menu links, the template engine would generate:
In addition, if you had no menu links defined, the "<!-- START: TOP_LINK -->...<!-- END: TOP_LINK -->" block would be automatically removed, and the menu links table would not appear.
01-02[FIELDNAMES]
Bracketed fieldnames are used to identify placeholders for a number of variables that can be used on the page. The 3dCart template engine then replaces these variables with the database values. Each page has a set of bracketed field names that can be used to display variables, or even removed entirely.
EXAMPLE:
<!--START: TOP_LINK_FORMAT-->
<td><a href=””>[link_name]</a></td>
<!--END: TOP_LINK_FORMAT-->
02. How To Use This Guide
Refer to this guide often for the list of code blocks and variables available for use within each page of 3dCart, and a brief description of what they do.
02-01Each section of this guide contains:
File Name - The name of the template.
Version Number - The earliest version of 3dCart that utilizes this template.
Purpose - Describes what function the template serves, and how it's used.
Notes - Code blocks, variables, and other info that applies to customization.
02-02Global Variables
Some code blocks and fieldnames are not exclusive to a single template, but are used within many different templates throughout the 3dCart e-commerce system. The following is a list of all global code blocks and fieldnames:
BREADCRUMBS:
<!--START: BODY_HEADER--> - Breadcrumb area begins.
[CATEGORY_FULLLINE] - Displays breadcrumbs.
<!--END: BODY_HEADER--> - Breadcrumb area ends.
GLOBAL HEADER:
(Can be edited from Settings -> Design-> General Titles.)
<!--START: CATEGORY_HEADER--> - Header content begins.
[CONTENT] - Displays all header information defined in 3dCart Administration.
<!--END: CATEGORY_HEADER--> - Header content ends.
GLOBAL FOOTER:
(Can be edited from Settings -> Design-> General Titles.)
<!--START: CATEGORY_FOOTER--> - Footer content begins.
[CONTENT] - Displays all footer information defined in 3dCart Administration.
<!--END: CATEGORY_FOOTER--> - Footer content ends.
SHOPPING CART ITEMS:
<!--START: SHOPPING_CART_ITEM-->
[ITEM_CATALOGID]
[THUMBNAIL]
[ITEM_NAME]
[ITEM_PRICE]
[ITEM_QUANTITY]
[ITEM_SUBTOTAL]
<!--END: SHOPPING_CART_ITEM-->
CHECKOUT QUESTIONS:
(Can be edited from Settings -> Design-> General Titles.)
<!--START: checkout_questions-->
[checkout1_checkoutquestions]
<!--START: questions-->
<!--END: questions-->
<!--END: checkout_questions-->
<!--START: checkout_questions_templates-->
<!--START: textarea-format-->
<!--START: req[id]-->
<!--END: req[id]-->
[question]
[answer]
<!--END: textarea-format-->
<!--START: text-format-->
<!--START: req[id]-->
<!--END: req[id]-->
[question]
[id]
[answer]
<!--END: text-format-->
<!--START: file-format-->
<!--END: file-format-->
<!--START: checkbox-format-->
<!--START: req[id]-->
<!--END: req[id]-->
[id]
[answer]
[selected]
[question]
<!--END: checkbox-format-->
<!--START: radio-format-->
<!--START: req[id]-->
<!--END: req[id]-->
[question]
<!--START: option-->
[id]
[option]
[selected]
[option]
<!--END: option-->
<!--END: radio-format-->
<!--START: dropdown-format-->
<!--START: req[id]-->
<!--END: req[id]-->
[question]
[id]
<!--START: option-->
<!--END: option-->
<!--END: dropdown-format-->
<!--END: checkout_questions_templates-->
SEARCH/CATEGORY PAGINATION (PAGING):
<!--START: PAGING-->
[category_moreresults]
<!--START: PREV-->
[cat]
[sortby]
[prev]
[category_previouspage]
<!--END: PREV-->
<!--START: PAGES-->
<!--START: FIRST_PAGE-->
<!--END: FIRST_PAGE-->
<!--START: PAGES_SELECTED-->
<!--END: PAGES_SELECTED-->
<!--START: PAGES_NOTSELECTED-->
<!--END: PAGES_NOTSELECTED-->
<!--START: LAST_PAGE-->
<!--END: LAST_PAGE-->
<!--END: PAGES-->
<!--START: NEXT-->
[cat]
[sortby]
[next]
[category_nextpage]
<!--END: NEXT-->
<!--END: PAGING-->
03. "add_addresses.html"
3dCart Versions 2.2+
03-01Purpose
To allow a customer to add/edit additional addresses to their address book. To access this page, log into "My Account", scroll down to "My Address Book", and click the "Add/Edit" button.
03-02Notes
This feature was added with the "multiple ship to" option so that a customer
could enter the shipping addresses of all their friends, and easily select
what products are to be shipped where.
The file contains a form with fields which contain address information (Alias,
name, city, state, etc.). When in EDIT mode, the existing information is
replaced in the fields, when in ADD mode, the fields are blanked out so
that a new address can be entered. No other tags other than the ones
defined in the fields will be replaced on this page.
In addition to the code blocks below, each form field has a designated code block that toggles a "required" graphic on and off. "[FIELDNAME]" denotes each actual fieldname that is required. The graphic placed within this code block can be customized, but we suggest that you keep it around 12x12 pixels, simple, and unobtrusive.
EXAMPLE:
<!--START: req_[FIELDNAME]-->
<img src="required_graphic.gif" width="12" height="12" border="0" alt="Required"/>
<!--END: req_[FIELDNAME]-->
CODE BLOCKS / FIELDNAMES:
[account_Update-Address] - Displays the title of the page.
<!--START: SAVE_ADDRESSES--> - Start of "Addresses" form.
[account_Address-Alias] - Field label: "Alias" (default).
[address_alias] - "Alias" input field.
[CustomerInfo_firstname] - Field label: "First Name" (default).
[shipping_firstname] - "First Name" input field.
[CustomerInfo_lastname] - Field label: "Last Name" (default).
[shipping_lastname] - "Last Name" input field.
[CustomerInfo_company] - Field label: "Company Name" (default).
[shipping_company] - "Company" input field.
[CustomerInfo_phone] - Field label: "Phone" (default).
[shipping_phone] - "Phone" input field.
[CustomerInfo_address] - Field label: "Street Address" (default).
[shipping_address] - "Address" input field.
[CustomerInfo_address2] - Field label: "Apartment/Suite" (default).
[shipping_address2] - "Address2" input field.
[CustomerInfo_city] - Field label: "City" (default).
[shipping_city] - "City" input field.
[CustomerInfo_state] - Field label: "State" (default).
[CustomerInfo_zip] - Field label: "Zip Code" (default).
[shipping_zip] - "Zip" input field.
[CustomerInfo_country] - Field label: "Country" (default).
[account_Update-Address] - "Add / Update Address" button text. (default)
<--END: SAVE_ADDRESSES--> - End of "Addresses" form.
04. "addresses.html"
3dCart Versions 2.2+
04-01Purpose
To view the list of addresses you have in your address book.
04-02Notes
The file contains a single code block which is repeated as many
times as there are addresses. If there are more than 3 addresses
another row will be created.
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDNAMES:
[account_Update-Address] - "Add New Address" button text. (default)
<!--START: address--> - Start of Address Book.
[id] - Address ID
[address_alias] - "Alias" input field.
[shipping_firstname] - Displays first name.
[shipping_lastname] - Displays last name.
[shipping_address] - Displays street address.
<!--START: shipping_address2--> - Starts a hidden code block if "address2" is blank.
[shipping_address2] - Displays apartment/suite. (optional)
<!--END: shipping_address2--> - Ends the hidden code block if "address2" is blank.
[shipping_city] - Displays city.
[shipping_state] - Displays state.
[shipping_zip] - Displays zip code.
[shipping_country] - Displays country.
[shipping_phone] - Displays phone number.
[account_Change-Address] - "Modify" button text. (default)
[account_Remove-Address] - "Remove" button text. (default)
<--END: address--> - End of Address Book.
05. "category_X.html"
3dCart Versions 2.1+
05-01Purpose
This HTML template defines the layout of the category pages.
05-02Notes
This is one of the more complicated templates as it contains many different
code blocks.
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDNAMES
<!--START: SUB_CATEGORIES--> - Displays existing sub-categories.
[category_Header-subcategories]
<!--START: SUB_CATEGORIES_FORMAT-->
[CATID]
[SUB_CATEGORY_NAME]
[SUB_CATEGORY_DESCRIPTION]
<!--START: SUB_CATEGORY_IMAGE--> - Places an image if a category icon is defined.
[CATID]
[SUB_CATEGORY_IMAGE]
[SUB_CATEGORY_NAME]
<--END: SUB_CATEGORY_IMAGE-->
<--END: SUB_CATEGORIES_FORMAT-->
<--END: SUB_CATEGORIES-->
<!--START: FEATURE_MENU--> - Displays existing category specials.
[category_Header-specials]
<!--START: FEATURE_ITEMS-->
<!--START: FEATURE_ITEM_TEMPLATE_#-->
[catalogid]
[name]
[catalogid]
[thumbnail]
[description]
<!--START: ITEMPRICE-->
<!--END: ITEMPRICE-->
<!--START: SALEPRICE-->
[ITEMPRICE]
[ITEMSALEPRICE]
<!--START: SAVINGS-->
[product_savings]
[savings]
<!--END: SAVINGS-->
<!--END: SALEPRICE-->
<!--START: AVAILABILITY-->
<!--END: AVAILABILITY-->
<!--START: freeshippingblock-->
<!--END: freeshippingblock-->
<!--END: FEATURE_ITEM_TEMPLATE_#-->
<!--END: FEATURE_ITEMS-->
<!--END: FEATURE_MENU-->
<!--START: ITEMS-->
[catid]
[category_Header-products]
[productnumber]
[sortbylist]
<!--START: CATEGORY_ITEMS-->
<!--START: ITEM_TEMPLATE_#-->
[catalogid]
[name]
[thumbnail]
[description]
<!--START: ITEMPRICE-->
<!--END: ITEMPRICE-->
<!--START: SALEPRICE-->
[ITEMPRICE]
[ITEMSALEPRICE]
<!--START: SAVINGS-->
[product_savings]
[savings]
<!--END: SAVINGS-->
<!--END: SALEPRICE-->
<!--START: AVAILABILITY-->
<!--END: AVAILABILITY-->
<!--START: freeshippingblock-->
<!--END: freeshippingblock-->
<!--END: ITEM_TEMPLATE_#-->
<!--END: CATEGORY_ITEMS-->
<!--END: ITEMS-->
FEATURE_ITEM_TEMPLATE_# signifies that you can specify 3 different product layouts and select which one is used within the category options. (FEATURE_ITEM_TEMPLATE_0, FEATURE_ITEM_TEMPLATE_1, FEATURE_ITEM_TEMPLATE_2.)
EXAMPLE:
<!--START: FEATURE_ITEM_TEMPLATE_1-->
<table border="0" cellspacing="0" cellpadding="0" width="95%">
<tr>
<td class="item" width="70%" align="left" valign="middle">
<a href="product.asp?itemid=[catalogid]&catid=[catid]">[name]</a></td>
<td class="price" width="15%" align="left" valign="middle">[ITEMPRICE]</td>
<td class="item" width="15%" align="right" valign="middle">
<a href="add_cart.asp?quick=1&item_id=[catalogid]">[category_buyitlink]</a></td>
</tr>
</table>
<!--END: FEATURE_ITEM_TEMPLATE_1-->
This code block can contain the following fields:
[name]
[ITEMPRICE]
[description]
Important Notes:
Based on the # of columns you specify on the category options, a table will
be created to contain the products. This is why on the example above, the
table has a width of 95%. For example, if you defined 3 columns per page,
the table that will be created is as follows.
A - B - C
D - E - F
“A”, “B”, “C”, and so on would be replaced with an item template.
e) Next you will find the code block for “ITEMS” this is where the products
for this category will be displayed.
Within this block you will find a code block for “PAGING” this is how the
paging is built if you have more than 1 page of products. (This block is
repeated again on the bottom of the page. Its very important that both of
these blocks are identical as the block is only replaced once, and so if the
top is different from the bottom, only 1 of the 2 will be replaced.
After the paging block you will find the “CATEGORY_ITEMS” code block
and this is the one that defines where the product display templates are
located. Just like in the category specials, you have the ability to specify 3
templates.
(ITEM_TEMPLATE_0, ITEM_TEMPLATE_1,
ITEM_TEMPLATE_2)
06. "checkout-step1.html"
3dCart Versions 2.0+
06-01Purpose
This template defines the layout of the checkout (page 1) of the 3
step checkout. For new customers, this is where customers enter
their shipping address, for existing customers; this is the page
where they log into their account.
06-02Notes
The template contains a form which is used by the customer to
enter their shipping address. No changes should be done to the
form as the field names/values are very important and should not
be changed. Adding or removing fields could cause the form to
stop working. You can however, change the look/feel of the form
using CSS/HTML.
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDNAMES
[checkout1_step]
[checkout2_step]
[checkout3_step]
[checkout4_step]
<!--START: paypalexpress-->
<!--END: paypalexpress-->
<!--START: GOOGLECHECKOUT-->
<!--END: GOOGLECHECKOUT-->
<!--START: account_login-->
[checkout1_loginmessage]
[checkout1_loginmessage2]
[checkout1_login]
[checkout1_Header-createnewaccount]
[CustomerInfo_email]
<!--START: emailrequired-->
<!--START: req_email-->
<!--END: req_email-->
<!--END: emailrequired-->
[CustomerInfo_password]
<!--START: passwordrequired-->
<!--START: req_pass-->
<!--END: req_pass-->
<!--END: passwordrequired-->
[maillist]
[checkout1_joinmailinglist]
<!--END: account_login-->
[checkout1_Header-shippinginformation]
<!--START: required_fields-->
<!--END: required_fields-->
<!--START: SAVE_ADDRESSES-->
[checkout1_address-book]
[address_list]
<!--END: SAVE_ADDRESSES-->
[CustomerInfo_firstname]
[shipping_firstname]
<!--START: req_shipping_firstname-->
<!--END: req_shipping_firstname-->
[CustomerInfo_lastname]
[shipping_lastname]
<!--START: req_shipping_lastname-->
<!--END: req_shipping_lastname-->
[CustomerInfo_company]
[shipping_company]
<!--START: req_shipping_company-->
<!--END: req_shipping_company-->
[CustomerInfo_phone]
[shipping_phone]
<!--START: req_shipping_phone-->
<!--END: req_shipping_phone-->
[CustomerInfo_address]
[shipping_address]
<!--START: req_shipping_address-->
<!--END: req_shipping_address-->
[CustomerInfo_address2]
[shipping_address2]
[CustomerInfo_city]
[shipping_city]
<!--START: req_shipping_city-->
<!--END: req_shipping_city-->
[CustomerInfo_country]
<!--START: req_shipping_country-->
<!--END: req_shipping_country-->
[CountryDropDown]
[CustomerInfo_state]
[state]
<!--START: req_shipping_state-->
<!--END: req_shipping_state-->
[CustomerInfo_zip]
[shipping_zip]
<!--START: req_shipping_zip-->
<!--END: req_shipping_zip-->
[checkout1_submitbutton]
[checkout1_Header-shoppingcart]
<!--START: DISCOUNTS-->
[shoppingcart_subtotal]
[CARTSUBTOTAL]
[checkout1_discounts]
[DISCOUNTS]
<!--END: DISCOUNTS-->
[shoppingcart_total]
[CARTTOTAL]
<!--START: GIFTCERTS-->
[shoppingcart_giftcertificate]
[GIFTCERTS]
<!--END: GIFTCERTS-->
The file contains the following code blocks:
“CATEGORY_HEADER”
Used to place HTML content on the top of this page, changeable
from settings -> Design -> Titles & Content
“SHOPPING_CART_ITEM”
Template for how shopping cart items should be displayed on the
checkout page.
“GOOGLECHECKOUT”
Contains the GoogleCheckout logo. This block will be removed if
GoogleCheckout is not configured, or if the GoogleCheckout
payment does not apply for the transaction.
“paypalexpress”
Contains the paypalexpress logo, should paypal express be turned
on, this logo shows, otherwise, its removed.
“checkout_questions”
Contains the area where checkout questions are displayed.
“checkout_questions_templates”
Contains the different templates for how the checkout questions
are displayed (for text, checkbox, drop down, etc.)
“CATEGORY_FOOTER”
Used to place HTML content on the bottom of this page,
changeable from settings -> Design -> Titles & Content
07. "checkout-step2.html"
3dCart Versions 2.0+
07-01Purpose
This template defines the layout of the checkout (page 2) of the 3 step
checkout. This is where customers select their shipping option.
07-02Notes
The template contains a form which is used by the customer to
select a shipping method No changes should be done to the form
as the field names/values are very important and should not be
changed. Adding or removing fields could cause the form to stop
working. You can however, change the look/feel of the form using
CSS/HTML.
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDNAMES
<!--START: Shipping Rate -->
[checkout2_Header-shippingmethods]
[checkout2_shippingmethodsmessage]
<!--START: CARRIER-->
<!--START: displayblock-->
[OPTION-SHIPPER]
[OPTION-SHIPPER]
<!--END: displayblock-->
[OPTION-SHIPPER]
[OPTION-SHIPPER]
<!--START: SHIPPING_OPTION-->
[ID]
[SELECTED]
[OPTION-SHIPPER]
[OPTION-DESCRIPTION]
[OPTION-PRICE2]
<!--END: SHIPPING_OPTION-->
<!--END: CARRIER-->
<!--START: INSURANCE-->
[checkout2_insurance]
[insurance_cost]
[checkout2_insurance-selected]
<!--START: optional-->
[checkout2_insurance-not-selected]
<!--END: optional-->
<!--END: INSURANCE-->
[checkout2_submitbutton]
<!-- END: Shipping Rate-->
[checkout2_Header-shippinginfo]
[checkout2_shippinginfomessage]
[shipping_firstname]
[shipping_lastname]
[shipping_company]
[shipping_address]
[shipping_address2]
[shipping_city]
[shipping_state]
[shipping_zip]
[shipping_country]
[checkout2_shippinginfochange]
[checkout1_Header-shoppingcart]
<!--START: DISCOUNTS-->
[shoppingcart_subtotal]
[CARTSUBTOTAL]
[checkout1_discounts]
[DISCOUNTS]
<!--END: DISCOUNTS-->
[shoppingcart_total]
[CARTTOTAL]
<!--START: GIFTCERTS-->
[shoppingcart_giftcertificate]
[GIFTCERTS]
<!--END: GIFTCERTS-->
The file contains the following code blocks:
“CATEGORY_HEADER”
Used to place HTML content on the top of this page, changeable
from settings -> Design -> Titles & Content
“SHOPPING_CART_ITEM”
Template for how shopping cart items should be displayed on the
checkout page.
“CARRIER”
Template for how a shipping carrier method is displayed.
“INSURANCE”
Displays insurance options. Block is removed if no insurance
options apply.
“checkout_questions”
Contains the area where checkout questions are displayed.
“checkout_questions_templates”
Contains the different templates for how the checkout questions
are displayed (for text, checkbox, drop down, etc.)
“CATEGORY_FOOTER”
Used to place HTML content on the bottom of this page,
changeable from settings -> Design -> Titles & Content
08. "checkout-step3.html"
3dCart Versions 2.0+
08-01Purpose
This template defines the layout of the checkout (page 3) of the 3 step
checkout. This is where customers enter their billing information.
08-02Notes
The template contains a form which is used by the customer to
enter their billing information. No changes should be done to the
form as the field names/values are very important and should not
be changed. Adding or removing fields could cause the form to
stop working. You can however, change the look/feel of the form
using CSS/HTML.
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDNAMES
[checkout1_step]
[checkout2_step]
[checkout3_step]
[checkout4_step]
[checkout3_Header-ordersummary]
[shoppingcart_subtotal]
[SUBTOTAL]
[shoppingcart_discount]
[DISCOUNT]
[shoppingcart_shipping]
[SHIPPING]
[shoppingcart_taxes]
[TAX]
<!--START: GIFTCERTS-->
[shoppingcart_total]
[TOTAL]
[shoppingcart_giftcertificate]
[GIFTCERTS]
<!--END: GIFTCERTS-->
[shoppingcart_balance]
[BALANCE]
<!--START: allow_different_billing-->
[checkout3_Header-billingaddress]
[checkout3_billingcomment]
[BCHECKED]
[checkout3_billingsameasshipping]
[CustomerInfo_firstname]
[billing_firstname]
<!--START: req_billing_firstname-->
<!--END: req_billing_firstname-->
[CustomerInfo_lastname]
[billing_lastname]
<!--START: req_billing_lastname-->
<!--END: req_billing_lastname-->
[CustomerInfo_company]
[billing_company]
<!--START: req_billing_company-->
<!--END: req_billing_company-->
[CustomerInfo_phone]
[billing_phone]
<!--START: req_billing_phone-->
<!--END: req_billing_phone-->
[CustomerInfo_address]
[billing_address]
<!--START: req_billing_address-->
<!--END: req_billing_address-->
[CustomerInfo_address2]
[billing_address2]
<!--START: req_billing_address2-->
<!--END: req_billing_address2-->
[CustomerInfo_city]
[billing_city]
<!--START: req_billing_city-->
<!--END: req_billing_city-->
[CustomerInfo_country]
[CountryDropDown]
<!--START: req_billing_country-->
<!--END: req_billing_country-->
[CustomerInfo_state]
[state]
<!--START: req_billing_state-->
<!--END: req_billing_state-->
[CustomerInfo_zip]
[billing_zip]
<!--START: req_shipping_zip-->
<!--END: req_shipping_zip-->
<!--END: allow_different_billing-->
<!--START: samebilling_billing-->
<!--START: showsamebillingasshipping-->
[checkout3_Header-billingaddress]
[billing_firstname]
[billing_lastname]
<!--START: billing_company-->
<!--END: billing_company-->
[billing_address]
<!--START: billing_address2-->
<!--END: billing_address2-->
[billing_city]
[billing_state]
[billing_zip]
[billing_country]
[checkout2_shippinginfochange]
<!--END: showsamebillingasshipping-->
[shipping_firstname]
[shipping_lastname]
[shipping_company]
[shipping_phone]
[shipping_address]
[shipping_address2]
[shipping_city]
[shipping_country]
[shipping_state]
[shipping_zip]
<!--END: samebilling_billing-->
<!--START: GIFTCERTIFICATES-->
[viewcart_giftcertificates-header]
<!--START: DISPLAY_GIFTCERTIFICATES-->
[certificate_name]
[discount_amount]
[discount_balance]
<!--END: DISPLAY_GIFTCERTIFICATES-->
<!--END: GIFTCERTIFICATES-->
[checkout3_methodofpaymentselect]
<!--START: CCGATEWAY-->
[payment_description]
[payment_description_message]
[id]
[FIRSTOPTIONCHECKED]
[payment_description]
[CustomerInfo_creditcardnumber]
[CustomerInfo_creditexpiration]
[monthlist]
[yearlist]
[CustomerInfo_cardtype]
[cctype]
<!--END: CCGATEWAY-->
<!--START: LINKGATEWAY-->
[payment_description]
[payment_description_message]
[FIRSTOPTIONCHECKED]
[payment_description]
<!--END: LINKGATEWAY-->
<!--START: CUSTOM-->
[payment_type]
[payment_description]
[FIRSTOPTIONCHECKED]
[payment_type]
<!--START: CUSTOM_FIELD-->
<!--END: CUSTOM_FIELD-->
<!--END: CUSTOM-->
[checkout3_Header-comment]
[checkout3_commentmessage]
[checkout3_Header-comment]
[checkout3_submitbutton]
[checkout3_Header-shippingmethodinfo]
[oshipmethod]
[shoppingcart_shipping]
[SHIPPING]
[checkout3_shippingmethodchange]
[checkout2_Header-shippinginfo]
[checkout2_shippinginfomessage]
[shipping_firstname]
[shipping_lastname]
[shipping_company]
[shipping_address]
[shipping_address2]
[shipping_city]
[shipping_state]
[shipping_zip]
[shipping_country]
[checkout2_shippinginfochange]
[checkout1_Header-shoppingcart]
The file contains the following code blocks:
“CATEGORY_HEADER”
Used to place HTML content on the top of this page, changeable
from settings -> Design -> Titles & Content
“SHOPPING_CART_ITEM”
Template for how shopping cart items should be displayed on the
checkout page.
“allow_different_billing”
“samebilling_billing”
Based on the admin setting, ether allow customer to enter a
billing address or use the shipping address instead.
“CCGATEWAY”
“LINKGATEWAY”
“CUSTOM”
These 3 blocks define how online credit cards and offline credit
cards are displayed.
“GIFTCERTIFICATES”
Lists any gift certificates that are being used, block is only
displayed if Gift certificates have been applied to the order.
“checkout_questions”
Contains the area where checkout questions are displayed.
“checkout_questions_templates”
Contains the different templates for how the checkout questions
are displayed (for text, checkbox, drop down, etc.)
“CATEGORY_FOOTER”
Used to place HTML content on the bottom of this page,
changeable from settings -> Design -> Titles & Content
09. "checkout-step4.html"
3dCart Versions 2.0+
09-01Purpose
This template defines the layout of the checkout “thank you” page, the page
which is displayed when an order has been placed.
09-02Notes
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDNAMES
[checkout1_step]
[checkout2_step]
[checkout3_step]
[checkout4_step]
<!--START: ordercompleted-->
[checkout4_Header-ordercompleted]
<!--START: invoicedata-->
[checkout4_invoicemessage]
<!--END: invoicedata-->
[thankyoumessage]
<!--END: ordercompleted-->
The template contains a table and displays the “thank you”
message specified on the payment method (Using
“[thankyoumessage]”). This template could also include all of the
blocks from the invoice_print template if you wanted to display a
complete invoice to the client.
The file contains the following code blocks:
“CATEGORY_HEADER”
Used to place HTML content on the top of this page, changeable
from settings -> Design -> Titles & Content
“CATEGORY_FOOTER”
Used to place HTML content on the bottom of this page,
changeable from settings -> Design -> Titles & Content
As well as all the code blocks from invoice_print.html
template.
10. "checkout-step2_multiple.html"
3dCart Versions 2.2+
10-01Purpose
This template defines the layout of the checkout (page 2) of the 3 step
checkout. (Similar to checkout-step2.html, however, this one is used when
an order contains multiple “ship to” addresses.)
10-02Notes
The template contains a form which is used by the customer to
select a shipping method No changes should be done to the form
as the field names/values are very important and should not be
changed. Adding or removing fields could cause the form to stop
working. You can however, change the look/feel of the form using
CSS/HTML.
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDNAMES
[checkout1_step]
[checkout2_step]
[checkout3_step]
[checkout4_step]
[checkout2_Header-shippinginfo]
<!--START: address_block-->
[package_number]
[checkout2_Header-shippingmethods]
[checkout2_shippinginfomessage]
[oshipfirstname]
[oshiplastname]
[oshipcompany]
[oshipaddress]
[oshipaddress2]
[oshipcity]
[oshipstate]
[oshipzip]
[oshipcountry]
[shipment_id]
[checkout2_shippinginfochange]
[checkout2_shippingmethodsmessage]
<!--START: CARRIER-->
<!--START: displayblock-->
[OPTION-SHIPPER]
[shipment_id]
[shipment_id]
[OPTION-SHIPPER]
<!--END: displayblock-->
[OPTION-SHIPPER]
[shipment_id]
[OPTION-SHIPPER]
<!--START: SHIPPING_OPTION-->
[shipment_id]
[ID]
[SELECTED]
[OPTION-DESCRIPTION]
[OPTION-PRICE2]
<!--END: SHIPPING_OPTION-->
<!--END: CARRIER-->
<!--END: address_block-->
The file contains the following code blocks:
“CATEGORY_HEADER”
Used to place HTML content on the top of this page, changeable
from settings -> Design -> Titles & Content
“SHOPPING_CART_ITEM”
Template for how shopping cart items should be displayed on the
checkout page.
“CARRIER”
Template for how a shipping carrier method is displayed.
“INSURANCE”
Displays insurance options. Block is removed if no insurance
options apply.
“checkout_questions”
Contains the area where checkout questions are displayed.
“checkout_questions_templates”
Contains the different templates for how the checkout questions
are displayed (for text, checkbox, drop down, etc.)
“CATEGORY_FOOTER”
Used to place HTML content on the bottom of this page,
changeable from settings -> Design -> Titles & Content
11. "checkout-step3_multiple.html"
3dCart Versions 2.2+
11-01Purpose
This template defines the layout of the checkout (page 3) of the 3 step
checkout. (Similar to checkout-step3.html, but this template is used when
an order has multiple “ship to” addresses.)
11-02Notes
The template contains a form which is used by the customer to
enter their billing information. No changes should be done to the
form as the field names/values are very important and should not
be changed. Adding or removing fields could cause the form to
stop working. You can however, change the look/feel of the form
using CSS/HTML.
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDNAMES
[checkout1_step]
[checkout2_step]
[checkout3_step]
[checkout4_step]
[checkout2_Header-shippinginfo]
<!--START: shipment-->
[oshipfirstname]
[oshiplastname]
[oshipcity]
[oshipstate]
[oshipzip]
[oshipcountry]
<!--END: shipment-->
[checkout2_shippinginfochange]
[checkout3_Header-ordersummary]
[shoppingcart_subtotal]
[SUBTOTAL]
[shoppingcart_discount]
[DISCOUNT]
[shoppingcart_shipping]
[SHIPPING]
[shoppingcart_taxes]
[TAX]
<!--START: GIFTCERTS-->
[shoppingcart_total]
[TOTAL]
[shoppingcart_giftcertificate]
[GIFTCERTS]
<!--END: GIFTCERTS-->
[shoppingcart_balance]
[BALANCE]
<!--START: allow_different_billing-->
[checkout3_Header-billingaddress]
[checkout3_billingcomment]
[CustomerInfo_firstname]
[billing_firstname]
<!--START: req_billing_firstname-->
<!--END: req_billing_firstname-->
[CustomerInfo_lastname]
[billing_lastname]
<!--START: req_billing_lastname-->
<!--END: req_billing_lastname-->
[CustomerInfo_company]
[billing_company]
<!--START: req_billing_company-->
<!--END: req_billing_company-->
[CustomerInfo_phone]
[billing_phone]
<!--START: req_billing_phone-->
<!--END: req_billing_phone-->
[CustomerInfo_address]
[billing_address]
<!--START: req_billing_address-->
<!--END: req_billing_address-->
[CustomerInfo_address2]
[billing_address2]
<!--START: req_billing_address2-->
<!--END: req_billing_address2-->
[CustomerInfo_city]
[billing_city]
<!--START: req_billing_city-->
<!--END: req_billing_city-->
[CustomerInfo_country]
[CountryDropDown]
<!--START: req_billing_country-->
<!--END: req_billing_country-->
[CustomerInfo_state]
[state]
<!--START: req_billing_state-->
<!--END: req_billing_state-->
[CustomerInfo_zip]
[billing_zip]
<!--START: req_shipping_zip-->
<!--END: req_shipping_zip-->
<!--END: allow_different_billing-->
<!--START: samebilling_billing-->
<!--START: showsamebillingasshipping-->
[checkout3_Header-billingaddress]
[billing_firstname]
[billing_lastname]
<!--START: billing_company-->
<!--END: billing_company-->
[billing_address]
<!--START: billing_address2-->
<!--END: billing_address2-->
[billing_city]
[billing_state]
[billing_zip]
[billing_country]
[checkout2_shippinginfochange]
<!--END: showsamebillingasshipping-->
[shipping_firstname]
[shipping_lastname]
[shipping_company]
[shipping_phone]
[shipping_address]
[shipping_address2]
[shipping_city]
[shipping_country]
[shipping_state]
[shipping_zip]
<!--END: samebilling_billing-->
[checkout3_methodofpaymentselect]
<!--START: CCGATEWAY-->
[payment_description]
[payment_description_message]
[id]
[FIRSTOPTIONCHECKED]
[payment_description]
[CustomerInfo_creditcardnumber]
[CustomerInfo_creditexpiration]
[monthlist]
[yearlist]
[CustomerInfo_cardtype]
[cctype]
<!--END: CCGATEWAY-->
<!--START: LINKGATEWAY-->
[payment_description]
[payment_description_message]
[FIRSTOPTIONCHECKED]
[payment_description]
<!--END: LINKGATEWAY-->
<!--START: CUSTOM-->
[payment_type]
[payment_description]
[FIRSTOPTIONCHECKED]
<!--START: CUSTOM_FIELD-->
<!--END: CUSTOM_FIELD-->
<!--END: CUSTOM-->
[checkout3_Header-comment]
[checkout3_commentmessage]
[checkout3_Header-comment]
[checkout3_submitbutton]
The file contains the following code blocks:
“CATEGORY_HEADER”
Used to place HTML content on the top of this page, changeable
from settings -> Design -> Titles & Content
“SHOPPING_CART_ITEM”
Template for how shopping cart items should be displayed on the
checkout page.
“allow_different_billing”
“samebilling_billing”
Based on the admin setting, ether allow customer to enter a
billing address or use the shipping address instead.
“CCGATEWAY”
“LINKGATEWAY”
“CUSTOM”
These 3 blocks define how online credit cards and offline credit
cards are displayed.
“GIFTCERTIFICATES”
Lists any gift certificates that are being used, block is only
displayed if Gift certificates have been applied to the order.
“checkout_questions”
Contains the area where checkout questions are displayed.
“checkout_questions_templates”
Contains the different templates for how the checkout questions
are displayed (for text, checkbox, drop down, etc.)
“CATEGORY_FOOTER”
Used to place HTML content on the bottom of this page,
changeable from settings -> Design -> Titles & Content
12. "Error.html"
3dCart Versions 2.0+
12-01Purpose
This template is used for displaying errors to customers.
12-02Notes
This template also utilizes one or more global variables.
CODE BLOCKS / FIELDSETS
[dberror_returnpage]
[dberror_name]
[dberror]
<!--START: RETURNMESSAGE-->
[error_returnmessage]
[dberror_returnpage]
<!--END: RETURNMESSAGE--> - Creates
a link to the previous page.
13. "extrapage.html"
3dCart Versions 2.0+
13-01Purpose
This template is used for displaying content pages (this template
is used for menu links and extra pages).
13-02Notes
CODE BLOCKS / FIELDSETS
[content] - Displays page content.
<!--START: BODY_HEADER-->
[PAGE_FULLLINE]
[htmlpage] - Displays page name.
<!--END: BODY_HEADER-->
<!--START: SUB_PAGES--> - Creates navigation to sub-pages.
<!--START: SUB_PAGES_FORMAT-->
[id]
[extra]
[sub_pages_title] - Displays sub-page name.
<!--END: SUB_PAGES_FORMAT-->
<!--END: SUB_PAGES-->
14. "fedex_tracking.html"
3dCart Versions 2.2+
14-01Purpose
Display FedEx tracking information.
14-02Notes
CODE BLOCKS / FIELDSETS
<!--START: results-->
[trackno]
<!--START: service_description-->
<!--END: service_description-->
<!--START: package_count-->
<!--END: package_count-->
<!--START: signedforby-->
<!--END: signedforby-->
<!--START: delivery_date-->
<!--END: delivery_date-->
<!--START: shipto_address-->
<!--END: shipto_address-->
<!--START: activity-->
[location]
[description]
[date_time]
<!--END: activity-->
<!--END: results-->
15. "feed_detail.html"
3dCart Versions 2.0+
15-01Purpose
Displays the details of a database feed.
15-02Notes
CODE BLOCKS / FIELDSETS
[feed_description] - Feed description/content.
<!--START: BODY_HEADER-->
[PAGE_FULLLINE]
[feed_title] - Feed title.
[feed_created] - Feed creation date.
<!--START: PREVFEED--> – Creates a link to the previous feed.
<!--END: PREVFEED-->
<!--START: NEXTFEED--> - Creates a link to the next feed.
<!--END: NEXTFEED-->
<!--START: feed_author--> - Displays author.
<!--END: feed_author-->
<!--END: BODY_HEADER-->
<!--START: feed_additionalfield#--> - Displays additional content field if it exists.
<!--END: feed_additionalfield#-->
16. "feed_page_x.html"
3dCart Versions 2.0+
16-01Purpose
Display a list of all database feeds. You can have more than 1 feed
layout. You can create as many layouts as you like by replacing the X with
1,2,3,4… etc. The default feeds page template is feed_page_0.html, if you
would like to specify a different feed template for a particular database feed,
this can be done by selecting a different template from the list on the
database feeds page.
16-02Notes
CODE BLOCKS / FIELDSETS
<!--START: BODY_HEADER-->
[PAGE_FULLLINE]
[htmlpage]
<!--END: BODY_HEADER-->
<!--START: SUB_PAGES-->
[content]
<!--START: SUB_PAGES_FORMAT-->
[id]
[extra]
[sub_pages_title]
<!--END: SUB_PAGES_FORMAT-->
<!--END: SUB_PAGES-->
<!--START: feedblock--> - This code block repeats for each feed.
[feed_title]
[feed_created]
[feed_shortdescription]
<!--START: feed_author-->
<!--END: feed_author-->
<!--START: feed_description-->
[feedlink]
[feeds_morelink]
<!--END: feed_description-->
<!--END: feedblock-->
17. "frame.html "
3dCart Versions 2.0+
17-01Purpose
This file defines the overall navigation and user interface of the
store. 99.9% of the time, this is the only template you will ever
need to edit!
17-02Notes
CODE BLOCKS / FIELDSETS
[TITLE]
[META]
