display_child_products
Generate a list of child products
Example
[%display_child_products id:'[@sku@]' template:'default'%]
[%param *header%]
<h4>Child Products</h4>
[%/param%]
[%param *footer%]
[%/param%]
[%/display_child_products%]Usage
The display_child_products tag prints a list of child products associated with the SKU specified in the ID parameter.
For more information about the product templates, see the thumb list tag
Parameters
| Name | Options | Description |
|---|---|---|
| `id:''` | String | Product SKU |
| `limit:''` | Integer | The limit 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. This parameter is required even if it is empty |
| `sortby:''` | String | `brand`, `name`, `sku`, `shippingweight`, `sortorder` |
| `*header` | HTML & b@se tags | Renders a single usable space above the body |
| `*footer` | HTML & b@se tags | Renders a single usable space below the body |
| `ifempty:''`, `*ifempty` | HTML & b@se tags | If the display_child_products returns no results, it'll load this block instead |
Data Tags (header/footer)
| Name | Example | Description |
|---|---|---|
| `[@limit@]` | 5 | Limit set in the parameters |
| `[@total@]` | 10 | Total number of child products |
| `[@total_showing@]` | 5 | Number of child products displayed |
Data Tags
These tags are available in the template specified in the template:'' parameter.
| 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 |
| `[@child_rndm@]` | – | MKgtM | Unique identifier for the child product when displayed |
| `[@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 | Name of the theme template assigned to the child product. Blank is default. |
| `[@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](https://galaxy.maropost.com/kb/articles/687-product-import-and-export-fields). |
| `[@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 | 1 | Sort order (ascending order) |
| `[@itm_sortorder2@]` | Sort Order 2 | 2 | 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 |
| `[@parent_sku@]` | Parent | 17MD-P | SKU of the parent product |
| `[@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 |
| `[@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 |
| `[@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 |
| `[@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 |