free_gifts
Generates a list of items that are assigned to the "Freebies" section in Neto by Maropost
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 Tags (header/footer)
| 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](https://www.netohq.com/support/s/article/Product-Fields-2) |
| `[@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 |