Products

Products are defined using a <jamcart-add> HTML tag. This implements the desired behaviour (adding an item to shopping cart) and transmits the required data to JamCart.

Examples

Simple Example

<jamcart-add name="Strawberry Jam" price="10.99"></jamcart-add>

Note: The closing tag </jamcart-add> is required and may not be omitted or made self-closing.

Full Example

<jamcart-add id="PS00326"
  include-form-data
  image="/static/strawberry-jam.jpg"
  open-cart
  name="Strawberry Jam"
  price="10.99"
  quantity="3"
  url="/strawberry-jam"
  verify-url="/strawberry-jam"
  >
  <span>Click</span> Me!
</jamcart-add>

Appearance

The appearance may be fully customized. Any HTML included inside of the <jamcart-add> tag will completely replace the default appearance.

Attributes

id
String
Alias for product-id.
include-form-data
Boolean
When true, all fields in the containing form are saved as additional data for this product. Requires <jamcart-add> to be contained within a <form> tag or throws an error.
image
URL
Path to the product's image. This will be displayed in the customer's shopping cart.
intangible
Boolean
An intangible item does not require shipping. During checkout, if all items are intagible, shipping address will not be collected.
name
String
Required
The product's name. This is displayed in the customer's shopping cart and on invoices.
open-cart
Boolean
If true, will automatically open the shopping cart after this item has been added.
price
Decimal
Required
Price per unit in the currency specified during installation. Must use . as the decimal separator.
product-id
String
A unique identifier for this product. This can be anything: SKU, ISBN, or another ID used by your own systems.
quantity
Integer
Number of units of the product to add. Default is 1.
url
URL
Location of the product's page. This is used as a link in the customer's shopping cart.
verify-url
URL
Location to crawl back when verifying product price. See security for more information. Default is window.location.href.