Cart.liquid - Revision history

Admin: /* Ordering Multiple Quantities */

2011-06-24T02:15:05Z

Ordering Multiple Quantities

Admin: /* Ordering Multiple Quantities */

2011-06-24T02:14:47Z

Ordering Multiple Quantities

Admin: /* Unique Line Items */

2011-06-24T02:13:14Z

Unique Line Items

Admin: /* Unique Line Items */

2011-06-24T01:49:12Z

Unique Line Items

Admin: /* Unique Line Items */

2011-06-24T01:48:24Z

Unique Line Items

Admin at 01:47, 24 June 2011

2011-06-24T01:47:41Z

Admin: /* Example Cart Template */

2011-06-24T01:39:02Z

Example Cart Template

Admin: /* Example Cart Template */

2011-06-24T01:38:12Z

Example Cart Template

Admin at 01:36, 24 June 2011

2011-06-24T01:36:56Z

Admin: New page: This template is used to render the shopping [Liquid Template Variables - cart|cart]] page. This is where the customer can review all the items purchased before proceeding to checkout. ...

2008-09-16T08:18:15Z

New page: This template is used to render the shopping [Liquid Template Variables - cart|cart]] page. This is where the customer can review all the items purchased before proceeding to checkout. ...

New page

This template is used to render the shopping [Liquid Template Variables - cart|cart]] page.

This is where the customer can review all the items purchased before proceeding to checkout.

You should always include a condition to check whether the shopping cart is empty or not.

For example:

<pre>{% if cart.item_count == 0 %}</pre>

To the list all the items in a cart, use the following code:

<pre><ul>
{% for item in cart.items %}
<li>{{ item.quantity }} x {{ item.title }}</li>
{% endfor %}
</ul></pre>

This example would create a list of all items in the cart including the quantity of each item.

In addition, a cart should include the price of each item, and the total amount of all the purchases.

==Variables==

In '''cart.liquid''' you have access to the following variables:

* [[Liquid Template Variables - cart|cart]] - The current cart.
* [[Liquid Template Variables - handle|handle]] - The handle of the cart.

In addition, all [[Liquid Variable Reference#Global objects|global variables]] are available.

@@ Line 112: / Line 112: @@
 You may wish to allow a customer to order more than one item at a time when they add products to the cart.
-This can be achieved simply by providing a <code>quantity</code> parameter within the <code><nowiki><form></nowiki></code> in the <code>product.liquid</code> template.
+This can be achieved simply by providing a <code>quantity</code> parameter within the <code><nowiki><form></nowiki></code> tag in the <code>product.liquid</code> template.
 The parameter can be hard-coded in the <code><nowiki><form></nowiki></code> tag. For example,

@@ Line 114: / Line 114: @@
 This can be achieved simply by providing a <code>quantity</code> parameter within the <code><nowiki><form></nowiki></code> in the <code>product.liquid</code> template.
-The parameter can be hard-coded in the form tag. For example,
+The parameter can be hard-coded in the <code><nowiki><form></nowiki></code> tag. For example,
 <pre>

← Older revision		Revision as of 02:13, 24 June 2011
Line 107:		Line 107:
	<form method="post" action="/cart/add?unique=true">		<form method="post" action="/cart/add?unique=true">
	</pre>		</pre>
		+
		+	=== Ordering Multiple Quantities ===
		+
		+	You may wish to allow a customer to order more than one item at a time when they add products to the cart.
		+
		+	This can be achieved simply by providing a <code>quantity</code> parameter within the <code><nowiki><form></nowiki></code> in the <code>product.liquid</code> template.
		+
		+	The parameter can be hard-coded in the form tag. For example,
		+
		+	<pre>
		+	<form method="post" action="/cart/add?quantity=2">
		+	</pre>
		+
		+	Alternatively, you can allow the customer to choose the quantity to order by adding an input text field, or even a select drop down or radio buttons field.
		+
		+	An example of a text field would be
		+
		+	<pre>
		+	<input type="text" name="quantity">
		+	</pre>
		+
		+	Similarly, a select or radio buttons field can be created within the form, providing that the name ''quantity'' is used for the field.

@@ Line 102: / Line 102: @@
 Please see [[Asking your customer for additional information]] for further information on how to add a custom note to a product.
-If you require a product to be added to the cart as a unique line item, even without a custom note, you can force this behaviour by adding the parameter ''unique=true'' to the <code><nowiki><form></nowiki></code> tag in the code>product.liquid</code> template.
+If you require a product to be added to the cart as a unique line item, even without a custom note, you can force this behaviour by adding the parameter ''unique=true'' to the <code><nowiki><form></nowiki></code> tag in the <code>product.liquid</code> template.
 <pre>
 <form method="post" action="/cart/add?unique=true">
 </pre>

@@ Line 98: / Line 98: @@
 By default, all new line items that have an additional custom ''note'' attached to them, will be added as a unique line item to the cart.
-This means that the customer can add the same product variation to the cart with different custom notes and each will be treated as a separate line item. There unique line items can also be individually managed in the cart and the quantity field can be changed independently from all other line items, enabling the customer to order multiple quantities of the same custom line item.
+This means that the customer can add the same product variation to the cart with different custom notes and each will be treated as a separate line item. These unique line items can also be individually managed in the cart and the quantity field can be changed independently from all other line items, enabling the customer to order multiple quantities of the same custom line item.
 Please see [[Asking your customer for additional information]] for further information on how to add a custom note to a product.

← Older revision		Revision as of 01:47, 24 June 2011
Line 91:		Line 91:

	In addition, all [[Liquid Variable Reference#Global objects\|global variables]] are available.		In addition, all [[Liquid Variable Reference#Global objects\|global variables]] are available.
		+
		+	== Additional Form Parameters ==
		+
		+	=== Unique Line Items ===
		+
		+	By default, all new line items that have an additional custom ''note'' attached to them, will be added as a unique line item to the cart.
		+
		+	This means that the customer can add the same product variation to the cart with different custom notes and each will be treated as a separate line item. There unique line items can also be individually managed in the cart and the quantity field can be changed independently from all other line items, enabling the customer to order multiple quantities of the same custom line item.
		+
		+	Please see [[Asking your customer for additional information]] for further information on how to add a custom note to a product.
		+
		+	If you require a product to be added to the cart as a unique line item, even without a custom note, you can force this behaviour by adding the parameter ''unique=true'' to the <code><nowiki><form></nowiki></code> tag in the code>product.liquid</code> template.
		+
		+	<pre>
		+	<form method="post" action="/cart/add?unique=true">
		+	</pre>

← Older revision		Revision as of 01:39, 24 June 2011
Line 24:		Line 24:

	The <code>cart.liquid</code> template requires a <code><nowiki><form></nowiki></code> to be added to the template in order for the cart to be submitted to the checkout.		The <code>cart.liquid</code> template requires a <code><nowiki><form></nowiki></code> to be added to the template in order for the cart to be submitted to the checkout.
		+
		+	Here is an example of the required elements for the cart form.

	<pre>		<pre>

@@ Line 53: / Line 53: @@
              <p>{{ item.product.description | strip_html | truncate: 120 }}</p>
              <p><small>{{ item.note | strip_html }}</small></p>
-           /div>
+          </div>
          </td>
          <td class="col2">{{ item.price | money }}</td>

@@ Line 1: / Line 1: @@
-This template is used to render the shopping [Liquid Template Variables - cart|cart]] page.
+This template is used to render the shopping [[Liquid Template Variables - cart|cart]] page.
 This is where the customer can review all the items purchased before proceeding to checkout.
@@ Line 21: / Line 21: @@
 In addition, a cart should include the price of each item, and the total amount of all the purchases.
-==Variables==
+=== Example Cart Template ===
 In '''cart.liquid''' you have access to the following variables: