free_gifts

free_gifts

Generates a list of items that are assigned to the "Freebies" section in Neto

Example

[%free_gifts id:'[@sku@]'%]
    [%PARAM *header%]
        <h4>Free gifts</h4>
    [%/param%]
    [%param *footer%]
    [%/param%]
[%/free_gifts%]

Usage

To utilize this function, you must have the Freebies addon installed.

The free_gifts tag generates a list of products that have been assigned to the free gifts section on a product within the Neto control panel. By default, we load this tag on the product page & the cart page. By assigning the products to the free gifts section within the control panel, this automatically changes the price to $0 when purchased with this product

For more information about the product templates, see the thumb list tag

Parameters

Name Options Description
limit:'' Integer Limit the number of results
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 free_gifts 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 Tag Example Description
[@total_gifts@] 1 Number of free gifts

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 Date at which the item is available. 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
[@assemble_group_fullname@] Full Name (Group) Accessories Kitting group Full Name
[@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 9300675031301 Product 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 Unique number for each product displayed started at 0
[@cubic@] Cubic 0.000250 The shipping width x length x height in metres
[@date_created@] 2016-05-20 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 an edible kit? y - yes, n - no
[@extra@] Extra Options **Gift Message;*-TEXT_FIELD-;LENGTH=+50 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_child@] 0 Has a child / variation 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
[@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
[@item_group@] Group Bulk Only Group of products that require a minimum quantity. See Settings & tools > All settings & tools > Products > Product Groups
[@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
[@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-07-31 Returns date if in the future otherwise blank
[@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_end@] Promo End 2018-12-31 00:00:00 Promotion expiry date and time (YYYY-MM-DD HH:MM:SS)
[@promo_price@] Promo Price 90.00 Promotional price for the pricing group that the customer is assigned to
[@promo_save@] 10.00 Difference between the regular price and the promo price (percentage)
[@promo_start@] Promo Start 2018-12-31 23:59:59 Promotion start date and time (YYYY-MM-DD HH:MM:SS)
[@retail@] RRP 125.00 Recommend retail price
[@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/td> 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
[@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.