tqExpert Help


For eCommerce, the productList tqTag enables tqAdmins (with suitable permissions) to enter products into the product catalog.

productList - Syntax

<tqtag name="productLists0type="productListmaxItems="1dynamicGrow | pageMainProduct >

productList - Parameters

Parameter Name Type Mandatory Strict | Transitional Case Sensitive Description
type Text + S + must be productList
name Text + S + should be unique tqtag name in the template. no spaces/commas/single quote/double quotes allowed
title Alpha Numeric + S - The title of the tqtag. This title will be presented only at the back-end system.  no spaces/commas/single quote/double quotes allowed
delimiter Alpha Numeric  - S + the system will add this delimiter at the end of each product except last one (e.g. delimiter="&nbsp|&nbsp")
dynamicGrow   - T + dynamicGrow tells the system to copy the tqtag for each product retrieved maxItems numbers of times.
maxItems Number - S   The max number of products to display in a page
pageMainProduct   - T + used for product page, this tells the system to take the product received via the url.
When pageMainProduct is used only one product will be retrieved from the database.

productList - Local Variables

Name Type Size Description
addDate datetime   The datetime the product was added. Can be formated using @addDate@df:[format]!
addToCartAction text 100 Url that adds the specific product line item to the shopping cart. (e.g. <a href="?section=<shopping cart section>&amp;@addToCartAction@&amp;quantity=1">add to shopping cart</a>
amountSold number 12 Number of items sold from the specific product line item.
backToCategoryLink text 100 Back to product category page.
careBy text 30 Represents the company that providing the product warrantee.
catalogID text 30 product catalog ID
content text 65535 Product content in current user language.
counter number 6 Running number from 1 to n
currency text 10 Product currency name (e.g. Dollar,Euro)
currencyID number 3 Product currency database ID
daysOfSupply number 3 Time to supply the product to the customer
defaultItemID number 8 Default line item for current product.
defaultPicID number 8 Default picture ID for product.
defaultSupplyID number 8 The default supplier of the product
description text 65535 Product short description in user language
endDate datetime   The last date the product is for sale on the website
evenOrOdd text 4 Returns even or odd for each product retrieved
freeShipping text 4 on or off
hasGift text 4 Does this product comes with a gift
id number 8 product database ID.
isSale text 4 on if product is on Sale, off if not.
lineItemCatalogID text 30 line item cateloge ID
longDescription text 65535 Product content
membersDiscount number 3 Not functional
monthCare number 3 Number of months the product is under warentee
numOfItemsInStock number 6 Number of items currently aviliable in stock
ourPrice number 6 Website selling price.
priceInUserCurrency number 6 Website price in user-selected currency
productBigImage text 350 product big picture
productLink text ~100 Url to product page
productMediumImage text 350 Product medium picture
productName text 100 Product name or title
productSmallImage text 350 product small picture
productTypeID number 6 The product type ID
realPrice number 6 Market price
realPriceInUserCurrency number 6 Market price in user-selected currency 
remarks text 65535 Products remarks
shortDescription text 65535 Product short description
startDate datetime   The first date the product is available for sale.
title text 100 Product title
userCurrency text 10 User-selected currency mark (e.g. $)
vendorID number 6 Product Vendor ID
views number 8 Number of users looked at the product
weight number 6 Product line item weight.
yousavemoney number 6 The difference between market price and website price.
youSaveMoneyInUserCurrency number 6 The difference between market price and website price in user selected currency
yousavepercent number 6 The percent difference (discount) between website price and market price

productList - Examples

Example 1 - productList tqtag use inside product page
<tqtag name="productLists0type="productListmaxItems="1pageMainProduct >
            <li>Is Sale</span><tqoption type="onSale" alternative0="no"><img src="images/{!yes!}0" alt="img" /></tqoption></li>
            <li>New In Website</span><tqoption type="new" alternative0="no"><img src="images/{!yes}0" alt="img" /></tqoption></li>
            <li>In Stock</span><tqoption type="inStock" alternative0="no"><img src="images/{!yes!}0" alt="img" /></tqoption></li>
            <li>Is BestSeller</span><tqoption type="bestSeller" alternative0="no"><img src="images/{!bestSeller-yes!}0" alt="img" /></tqoption></li>
            <li>Is Gift</span><tqoption type="gift" alternative0="no"><img src="images/{!yes!}0" alt="img" /></tqoption></li>
            <li>Is Deliverty</span><tqoption type="freeShipping" alternative0="no"><img src="images/{!yes!}0" alt="img" /></tqoption></li>
            <a href="@productMediumImage@">
                <img src="@productMediumImage@" alt="img" id="productBigPic" />
        <p>@productName@ | catalog #: @catalogID@</p>
        <form method="post" id="f2" action="@shoppingCartSection@&@addToCartAction@">
            <table border="0" cellpadding="0" cellspacing="0" style="display:block;">
                <tqoption type="productCustomProperties" maxItems="10" alternative0="@noAdditionalProducts@">{!
                    <td >
                        <div class="item">
                                <p class="norm11" >@customProductName@</p>
                                <img src="@customProductSmallImage@" height="40" alt="img" />
                                <p class="red11B">@customProductPrice@ @currency@<span class="red9B"></span></p>
                                <input name="additionalID[]" id="additionalID@lineItemID@" type="checkbox" value="@lineItemID@" onclick="addRemoveExtra('additionalID@lineItemID@','@customProductPrice@');" class="chk2" />
        </div> <!--scrollHold_2 -->
        <p class="bold12 center">Real PRice : @realPrice@ @currency@</p>
        <p class="red15B center">Price in website : @ourPrice@ @currency@</p>
        <p class="red12B center">savings : @yousavemoney@ @currency@ (@yousavepercent@)</p>
        <p class="bold12 center">product extras price : <span id="extraPrice">0</span> @currency@</p>
        <br />
        <input type="hidden" name="quantity" id="quantity" value="1" />
        <div class="addtoBag_btn"">
            <a href="javascript:submitForm('f2');">@buyNow@</a>

Example 2 - productList tqtag via auto pilot or caregory page
<tqtag name="productDynamicGrowtype="productListmaxItems="3dynamicGrow >
        <img src="@productSmallImage@" alt="" />
        <h3>@productName@<br />@shortDescription@<br />price: @priceInUserCurrency@ </h3>
        <a href="@productLink@">Read More</a>

productList - tqOptions

With the productList tqtag you can use the following tqoptions: bestSeller, freeShipping, gift, head, if, inStock, lastItemInRow, morePics, new, onSale, siteHaveBetterPrice, tail.

productList - Templates

The templates below implement this tqTag. After you click a link, use your browser commands to view the page source.

User Notes

  Add Note

Topic: productList