Sylius/docs/bundles/SyliusOrderBundle/cart_actions.rst

Routing and default actions
===========================

Routing for cart-actions is available in the ShopBundle. 
The ShopBundle is not individually available but it is included in the Sylius/Sylius repository.
You can see the usage guide for these actions below.

Cart summary page
-----------------

To point user to the cart summary page, you can use the ``sylius_shop_cart_summary`` route.
It will render the page with the `cart` and `form` variables by default.

The `cart` is the current cart and `form` is the view of the cart form.

Adding cart item
----------------

In our simple example, we only need to add the following link in the places where we need the "add to cart button".

.. code-block:: html

    <a href="{{ path('sylius_shop_cart_item_add', {'productId': product.id}) }}">Add product to cart</a>

Clicking this link will add the selected product to the cart.

Removing item
-------------

On the cart summary page you have access to all the cart items, so another simple link will allow a user to remove items from the cart.

.. code-block:: html

    <a href="{{ path('sylius_shop_cart_item_remove', {'id': item.id}) }}">Remove from cart</a>

Where `item` variable represents one of the `cart.items` collection items.

Clearing the whole cart
-----------------------

Clearing the cart is simple as clicking the following link.

.. code-block:: html

    <a href="{{ path('sylius_shop_cart_clear')}}">Clear cart</a>

Basic cart update
-----------------

On the cart summary page, you have access to the cart form, if you want to save it, simply submit the form
with the following action.

.. code-block:: html

    <form action="{{ path('sylius_shop_cart_save') }}" method="post">Save cart</a>

You cart will be validated and saved if everything is alright.