Commerce Commerce 1.x Snippets get product

The commerce.get_product snippet is used to get product information for a single product. Use get_products for listing multiple products.

Added in 0.4.

Usage

[[!commerce.get_product? &product=`123`]]

It’s possible to call this snippet both cached and uncached. The benefit of calling it uncached is that automatic sale prices are reflected in the output; but that does come at a small performance penalty.

Properties

  • &product: the ID of the product to load. If this is a comma or double-pipe separated value, only the first (< v0.12) or the first existing (v0.12+) product will be used.
  • &toPlaceholders: Prefix to set product information to placeholders; see below
  • &tpl: Name of a chunk to return the output with; see below
  • &field: Name of a product field to return; see below
  • &sortby: optionally a way to sort products, if specifying a comma-separated list of products in &product. By default, the sort order is the order products appear in the list. Added in 1.3.1.
  • &sortdir: optional sort direction (ASC or DESC). Added in 1.3.1.
  • &toJson: return the product information as a JSON string instead. Added in 1.4.0.
  • &jsonFields: provide a comma-separated list of fields that you want to return in the JSON output of &toJson. By default, all product information is returned, but we strongly recommend filtering that down to just what you need. You can also filter arrays (like the properties field) by providing properties.my_custom_product_property. Added in 1.4.0.

Returning information

Depending on which property you’ve provided to the snippet (&toPlaceholders, &tpl or &field in that order), the snippet will return the product information as follows:

  1. &toPlaceholders will set placeholders with the prefix provided. For example &toPlaceholders=`product` will set placeholders like [[+product.sku]], [[+product.price_formatted]], [[+product.name]] etc.
  2. &toJson will return a JSON string of the product. Optionally, filtered to only return fields provided in &jsonFields.
  3. &tpl can be set to the name of a chunk. The product information (without prefix) will be parsed through that chunk.
  4. &field allows to immediately return a single product field. For example &field=`price_formatted` to return just the formatted product price.
  5. If none of the above are provided, all available product information is dumped to screen in a <pre> tag. Useful for debugging.