product_history

product_history

Generates a list of recently viewed products in a session

Example

[%product_history limit:'10' template:'default'%]
    [%param *header%]
        <h4>Browsing History</h4>
    [%/param%]
    [%param *footer%]
    [%/param%]
[%/product_history%]

Usage

The product_history tag generates a list of products that the user has viewed the product page of during their session based on the limit. The limit parameter must be in place for the tag to work and the session length will depend on a number of different factors. Sessions are also tied to the user account, so this tag will persist through different sessions if the user views items while logged in.

For more information about the product templates, see the thumb_list tag.

Parameters

Name Options Description
limit:'' Integer The limit of products stored in the history, the limit must be at least 1
template:'' Name of the template without the .template.html Loads the template specified. If there is no value, it will load the default product template
ifempty:'' HTML & b@se tags If the product_history returns no results, it'll load this block instead
*header HTML & b@se tags Renders a single usable space above the body
*body HTML & b@se tags Runs an array for result
*footer HTML & b@se tags Renders a single usable space below the body

Data Tags (body)

Name Product Field Example Description
[@acc_code@], [@custom_label@] Custom Label/Code 220/MDC Product identifier for eBay or accounting integration
[@actual_height@] Assembled Height 0.420 Assembled height in metres
[@actual_length@] Assembled Length 0.990 Assembled length in metres
[@actual_width@] Assembled Width 1.200 Assembled width in metres
[@allow_oversell@] Inventory Policy y y - Don't track inventory for this SKU, n - Track inventory for this SKU
[@arrival_date@] Date arrival 2018-12-31 Displays date if in the future or nothing if the date is today or in the past (YYYY-MM-DD)
[@artisit_author@] Author/Artists John Green Name of the author or artist
[@availability_description@] Availability Description New stock arriving in December Details of when the product will be available
[@available_preorder_quantity@] 79 The total of the Qty on Hand and Preorder Qty
[@barcode@] UPC/EAN 9310353080316 UPC or EAN (Barcode)
[@base_unit@] Base Unit of Measure kg The base unit of measure (ctn, ea, L,ml, cm, m, lb, g, kg)
[@base_unit_qty@] Base Unit Per Qty 2.0000 For display purposes only. Multiplies the actual qty by this qty. For example if base unit qty is 1.9 then a qty of 2 will display as 3.8
[@brand@] Brand Kingston Product brand
[@count@] 0 Index number for each child product
[@cubic@] Cubic 0.010626 Shipping length x width x height in cubic metres
[@date_created@] 2017-11-08 Date the product was created (YYYY-MM-DD)
[@display_template@] Website Design Template custom Template used to display the product page. Blank is the default template. Not used for displaying the product thumbnail
[@editable_bundle@] Editable Kit n Is this product an editable kit
[@extra@] Extra Options **Gift Message;*-TEXT_FIELD-;LENGTH=+80 Non-inventoried extras you offer the customer at the point of purchase. See Product Import and Export Field Definitions
[@format@] Format Soft Cover The format of the product
[@has_components@] 0 Does this product have kit components. 0 - no, 1 - yes
[@has_from_price@] 1 Is the price of this child product is used on the thumbnail. Normally the cheapest but can be changed to the dearest. 1 - yes, 0 - no
[@has_mlp@] 0 Does this product have Multi Level Pricing. 0 - no, 1 - yes
[@height@] Shipping Height 0.230 Shipping height in metres
[@inpromo@] 1 Is the product on promotion. 0 - no, 1 - yes
[@instock@] 1 Is the product in stock. 0 - no, 1 - yes
[@inventory_id@] 22343 Unique number for this product
[@is_kit@] 0 Is this a kitted product. 0 - no, 1 - yes
[@itm_gp_id@] 0 A unique id for kits/variations/parent items, typically for internal use
[@itm_sortorder@] Sort Order 1 10 Sort order (ascending order)
[@itm_sortorder2@] Sort Order 2 20 Sort order (ascending order)
[@length@] Shipping Length 0.220 Shipping length in metres
[@limited_stock@] 1 Displays true when the stock is lower then the global configuration for "low stock"
[@manufacturer_model@] Manufacturer model number A7DC/K The manufacturers model number of the product
[@misc1@], [@misc2@], etc custom field name The Fault in Our Stars Custom product fields
[@mlp_price@] Multilevel Pricing 71.00 Cheapest multi level price unless regular price is cheaper
[@model@], [@name@] Name Turtles All the Way Down Product name
[@notax@] Tax Free Product n Tax Free Product. n - does attract tax, y - does not attract tax
[@preorder@] 1 Is the product on pre-order. 0 - no, 1 - yes
[@preorder_date@] Date arrival 2018-12-31 Returns date if in the future otherwise blank (YYYY-MM-DD)
[@preorder_quantity@] Preorder Qty 80 Quantity of the product available to be purchased on pre-order
[@price@] Price 100.00 Product price based on the group the customer is assigned to. Does not take into account promo pricing
[@product_subtype@] Subtype Paperback The product subtype
[@product_type@] Type Book The product type
[@promo_price@] Promo Price 90.00 Product promotional price based on the group the customer is assigned to
[@promo_save@] 10.00 Difference between the regular price and the promo price (percentage)
[@retail@] RRP 125.00 Recommended retail price
[@rndm@] wlvvg Random string for each product returned by this function
[@save@] 28.00 Percentage difference between the RRP and the selling price
[@save_price@] 35.00 Difference between the RRP and the selling price
[@service_only@] Service Item n Service product. Shipping methods and rates are ignored for service items
[@sh_type_id@] Shipping Category 1 ID number of the shipping category. Blank if Service Item is selected
[@short_description@] Short Description Turtles All the Way Down is a young adult novel written by American author John Green Short product description (up to 255 characters)
[@single_price@] 110.00 Price for one of this product
[@sku@] SKU 17MD-Black Product SKU
[@start_date@] Date arrival 2018-07-31 The date the next order from the supplier is due to arrive (YYYY-MM-DD)
[@store_price@] 110.00 Price for one of this product
[@store_quantity@] Qty On Hand 26 Available stock to sell. It is calculated by the total of all the warehouses minus the committed stock
[@subtitle@] Subtitle New book by John Green Normally appears below the name of the product on product pages
[@tax_inc@] Tax Inclusive y Price include tax. n no, y - yes
[@thumb@] Main /assets/thumb/17MD-Black.jpg Main product image thumbnail. If the child product has no image the parent image is returned
[@thumb_1@], [@thumb_2@], etc Alt 1, Alt 2, etc /assets/alt_1_thumb/17MD-Black.jpg Alt product images thumbnails
[@unit@] Selling Unit of Measure g The selling unit of measure. Can appear on invoices, etc
[@url@] Product URL http://www.mysite.com/turtles-all-the-way-down Product web address
[@weight@] Shipping Weight 0.1000 Shipping weight on kilograms
[@width@] Shipping Width 0.210 Shipping width in metres

Was this article useful?

Be notified when this page is updated. Optional.