Product Subscriptions

The following is a table of the subscription variables available from within the '$product' variable.

Categories

The following is a table of the category variables available from within the '$product' variable.

Prices

The following is a table of the pricing variables available from within the '$product' variable.

📘

In the table above, the "Currency" column describes whether the price held in the variable described will be:

• Always in the default currency (Default)
• Converted into the currently selected display currency (Selected)
• Converted (if required) into some other currency (GBP, EUR, etc)

Finance Options

Stock

Stock Action on Zero

{$product.stock_action_on_zero}

Using this variable you can specify whether you want elements of the page to appear, such as the "Add to Basket" button.  For example, if the product had 0 stock, you could use the following code to determine what to do:

        {if ($product.stock_action_on_zero == '3' && $product.product_stock == '0')}
			I can display my pre-order button here.  
		{elseif ($product.stock_action_on_zero == '0' && $product.stock_stock == '0')}
			Display no button as they cannot purchase it now the stock is 0.  
		{else}
			Display my add to basket button here.  
		{/if}

Stock

{$product.product_stock} will reveal the stock for the master product.  

Shipping

The following is a table of the shipping variables available from within the '$product' variable.

Display Next Day Shipping

You can clearly display when a customer may expect to receive their goods if next day delivery is available using the below code.

First of all we ensure it is in stock:

  {if $product.product_stock > 0}
   <p>Want guaranteed delivery by XXpm {$shipping_estimate}?

 Order in the next
    {if $order_by.hours}{$order_by.hours} {if $order_by.hours == '1'}hour{else}hours{/if}{/if}
    {if $order_by.hours AND $order_by.minutes > 0} and {/if}
    {if $order_by.minutes > 0}{$order_by.minutes} {if $order_by.minutes == '1'}minute{else}minutes{/if}{/if}

   and choose XXX on the checkout.

Breadcrumbsh1. h2. Standard Breadcrumbs

The standard breadcrumbs will operate in a way as you would expect - they will link back to the category you just came from.
This works on finding out their last category, and therefore if someone lands directly onto the page it will show nothing.

        {foreach from = $breadcrumbs item=breadcrumb name="breadcrumbs"}
            {if $smarty.foreach.breadcrumbs.last}
                <li>{$breadcrumb.name}</li>
            {else}
                <li><a href="{$breadcrumb.url}">{$breadcrumb.name}</a></li>
            {/if}
        {/foreach}

Breadcrumbs

Associated Categories

This will show every single other category that the product is in, line by line

{foreach from = $associated_categories item=associated_category name="associated_category"}
        <a href="{$associated_category.url}">{$associated_category.name}</a>{if !$smarty.foreach.associated_category.last}|{/if}
{/foreach}

Associated Categories v2

An improved version of Associated Categories, as it groups the items together, so that instead of displaying it such as: "Clothing" and then another one being "Leggings" it would display as:

Clothing | Leggings

<li>This product can be found in:</li>
{foreach from=$product.id|productInCategories item="associated_category" name="associated_categories"}
        <li><a href="{$associated_category.url}">{$associated_category.name}</a></li>
        {/foreach}
</ul>

Additional Fields

Variables

You can access any additional field from the template using:

{$product_fields.fieldname}

The fieldname is converted into a completely lowercase, characters and digits only version.

Some examples:
"Field Type" would become $product_fields.field_type

"Brand" would become $product_fields.brand

"Diamond Shape and Size" would become $product_fields.diamond_shape_and_size

Table

You can include all of the additional fields that an admin has entered for the product on the page like so:

If you are to use this feature, you will need to ensure that the jQuery tooltip.js is included

                {if $additionalFields}
                        <table id="additionalfields" cellpadding="0" cellspacing="0">
                        {foreach from = $additionalFields item=field}
                                <tr>
                                        <td class="light">
                                        {if $field.field_description}
                                        <a href="#" title="{$field.field_description|nl2br}" class="tooltip">{$field.field_name}</a>
                                        {else}
                                        {$field.field_name}
                                        {/if}
                                        </td>
                                        <td>{$field.field_value}</td>
                                </tr>
                        {/foreach}
                        </table>
                {/if}

Promotions

You can show what promotions the product applies to on the details page:

Variables

$xxx.promotion_name
This is the name that an admin has entered as the promotion in Aurora

$xxx.promotion_product_text
This allows for the admins to enter some specific text that they want to appear

{if $product.promotions}
2  {foreach from=$product.promotions item="promo"}
3    {if $promo.promotion_type != 'buy_x_get_y_free' AND $promo.promotion_product_text}
4      <div class="details_promo">{$promo.promotion_product_text}</div>
5    {/if}
6  {/foreach}
7{/if}

Attributesh1. Imagesh1. All images use MagicZoom and therefore must include the required files referenced below:

Images

👍

Please note that product images URIs can be obtained using product_image_uri in conjunction with the variables described below.

Main Image

We use {strip} to remove any whitespace that can cause issues in some browsers

{strip}
        {foreach from=$product_images key=count item=imageArray name=images}
            <ul class="productthumbs">
                {foreach from=$imageArray item=image}
                    <li>
                        <a href="/images/ac_product_images/product_image_data/resizeandpad:900:1111/{$image}" rel="zoom1" rev="/images/ac_product_images/product_image_data/resizeandpad:280:356/{$image}" title="" onclick="return false;">
                            <img src="/images/ac_product_images/product_image_data/resizeandpad:74:112/{$image}" alt="" {if $count > 0} style="display: none;"{/if}/>
                        </a>
                    </li>
                {/foreach}
            </ul>
        {/foreach}
    {/strip}

Thumbnails

Once again we use {strip} to remove any whitespace that can cause issues in some browsers

        {strip}
            {foreach from="`$product_images`" item="image" name="images"}
            {if $smarty.foreach.images.first}
            <a href="/images/ac_product_images/product_image_data/resizeandpad:900:1111/{$image[0]}" id="zoom1" class="MagicZoom MagicThumb mzoverride" rel="zoom-width:420px; zoom-height:500px">
                <img src="/images/ac_product_images/product_image_data/resizeandpad:280:356/{$image[0]}" alt="{$product.product_name}" />
            </a>
            {/if}
            {/foreach}
            {/strip}

Cross Sell, Up Sell and Related Lists

Displaying related products such as Cross-sells, Up-sells and Related Products as defined within Cross Sell, Up Sell and Related Lists can be achieved by utilising the following template variations:

• $cross_sells
• $upsells
• $related_products

These all follow the same format and can be rendered as demonstrated in the following example:

{if $cross_sells}
    <h2>{site_text page="Product Details" part="Link: Also Bought"}</h2>
    {foreach from=$cross_sells item="related"}
        <a href="{$related.product_filename}"><img src="{product_image_uri product=$related width=180 height=180}" alt="{$related.product_name}" /></a><br />
        <a href="#" class="quicklook" rel="{$related.id}">{site_text page="Global" part="Link: Quick Look"}</a><br />
        <h2><a href="{$related.product_filename}">{$related.product_name}</a></h2><br />
        {if $related.product_price_rrp > $related.my_price}
            {site_text page="Global" part="Product Box Label: Was"}: <s>{$related.product_price_rrp|displayPrice}</s>
            {site_text page="Global" part="Product Box Label: Now"}: {$related.my_price|displayPrice}
            <br />
        {else}
            {$related.my_price|displayPrice}<br />
        {/if}
        {if $related.product_stock > 0}
            <b>In Stock</b><br />
        {else}
            <b>Pre Order Now {if $related.product.restock_date|strtotime > 0} - Due In {$related.product.restock_date|strtotime|date:"jS M"}{/if}</b><br />
        {/if}
        {if $related.product_rating > 0}
            {assign var='product_rating' value=$related.product_rating|productRating}
            <img src="/templates/{$templates_dir}/_images/template/star_{$product_rating}.png" alt="" width="74" height="14" /><br />
        {/if}
    {/foreach}
{/if}

Wishlist

The purpose of the wishlist is to engage the customer with the website, and should therefore make it easier to save their details

If they have selected any attributes, it should pass those over and save the exact product selected. Furthermore, the popup should display exactly what they've added and potentially recommend other products they may like at this stagePrinth1. Every details page should have a print friendly version of the page designed and include a link to being able to print it Leave a Messageh1. This should never be directly on the details page, as it is unnecessary clutter that can hinder SEO. Instead you should link to it like so:

<a href="/products/leaveamessage?product\_id={$product.id}" class="leaveamessage" rel="nofollow"><img src="/templates/{$templates\_dir}/\_images/buttons/leaveamessage.gif" alt="" /></a>

To edit the form that appears, you must go to:

templates/DOMAINNAME/products/leaveamessage.tpl.htmlE-mail to Friendh1. <a href="/products/emailtofriend?product\_id={$product.id}" id="emailtofriend" rel="nofollow"><img src="/templates/{$templates\_dir}/\_images/buttons/emailtoafriend.gif" alt="" /></a>

Review Rating

Displaying Product Rating

{if $product.total_reviews > 0}      
{assign var='product_rating' value=$product.product_rating|productRating}
      <img src="/templates/{$templates_dir}/_images/template/star_{$product_rating}.png" alt="" width="74" height="14" property="v:rating" content="{$product_rating}" />
{/if} 

The logic of productRating works by taking the digits after the decimal and deciding whether to round up depending on whether it is greater or equal to 0.50.  If it is, it will round up to the nearest full digit, otherwise it will round down.  If you wanted an alternative, you could easily create your own method using Smarty logic, such as the below:

{$product.product_rating|round:"0":"PHP_ROUND_HALF_UP"} 

Full Code Example

    {if $product.total_reviews > 0}
  <div itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating" xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Review-aggregate">
       <span rel="v:rating" style="display: none;">
         <span typeof="v:Rating">
         <span itemprop="ratingValue" property="v:average">{$product.product_rating|number_format:"1"}</span> out of <span itemprop="reviewCount" property="v:best">5</span>
       </span>
       </span>
    <p class="details_stars">
      {assign var='product_rating' value=$product.product_rating|productRating}
      <img src="/templates/{$templates_dir}/_images/template/star_{$product_rating}.png" alt="" width="74" height="14" property="v:rating" content="{$product_rating}" />
    </p>
    <div class="details_stars_number"><a href="#reviews" rel="nofollow" class="details_view_reviews_link read_review">Read <span property="v:count">{$product.total_reviews}</span> {if $product.total_reviews == '1'}{site_text page="Product Details" part="Text: Review" }{else}{site_text page="Product Details" part="Text: Reviews" }{/if}</a><a href="{if $language_iso}/{$language_iso}{/if}/products/reviews/write/{$product.id}" rel="nofollow" class="details_view_reviews_link write_review" title="">{site_text page="Product Details" part="Link: Write a Review" }</a></div>
        <div class="clear"></div>
    </div>
  {if}

Reviews

Please see Product Reviews

Q&A

Please see Questions and Answers