Cart Manager

The Cart Manager is responsible for all aspects concerning carts and can manage multiple carts. Important to know is, that in the E-Commerce Framework every user specific product collection is a cart. No matter how it is called (cart, wish list, compare list, ...), all these product collections need the same base functionality. Therefore, all different product collections are carts with a specific name.

Working with Carts

Creating carts

<?php
$manager = Factory::getInstance()->getCartManager();
$cartId = $manager->createCart(array('name' => $cartName));
$cart = $manager->getCart( $cartId );

Adding and removing products

<?php
$manager = Factory::getInstance()->getCartManager();
$cart = $manager->getCartByName($cartName);

$id = $cart->addItem( $product, $amount );
$cart->save();

$cart->removeItem( $id );
$cart->save();


//alternative way

$cartItemId = $manager->addToCart( $product, $amount, $cart->getId() );
//save is done automatically 

$manager->removeFromCart($cartItemId, $cartId);
//save is done automatically 

List products of cart

<?php
$manager = Factory::getInstance()->getCartManager();
$cart = $manager->getCartByName($cartName);

if (count($cart->getItems()) > 0) {
  foreach ($cart->getItems() as $item) {
    $product = $item->getProduct();
 
    //item key
    $cartItemId = $item->getItemKey();
 
    //item amount
    $amount = $item->getCount();
 
    //price info and price
    $priceInfo = $item->getPriceInfo();
    $price = $item->getPrice(); 
  }
}

Price Calculation in Carts

Each cart has a CartPriceCalculator (configuration see below) which is responsible for calculating total sums of the cart. The CartPriceCalculator sums up all product prices to a sub total, adds (or subtracts) so called price modificators like shipping costs, cart discounts, etc. and then calculates a grand total.

See sample below for how to get the different sums:

<?php
// delivers sum without any price modifications
$subTotal = $cart->getPriceCalculator()->getSubTotal();
 
// iterates through all price modifications
foreach ($cart->getPriceCalculator()->getPriceModifications() as $name => $modification) {
    // $name is the label of a modification
    // $modification is an implementation of \Pimcore\Bundle\EcommerceFrameworkBundle\PriceSystem\ModificatedPriceInterface
}
 
// delivers sum including all price modifications
$grandTotal = $cart->getPriceCalculator()->getGrandTotal();

Configuration of Cart Manager

The configuration takes place in the pimcore_ecommerce_framework.cart_manager configuration section which is tenant aware.

pimcore_ecommerce_framework:
    cart_manager:
        tenants:
            # defaults for all cart managers
            _defaults:
                # define service manager id of cart service - following value is default and can be omitted
                cart_manager_id: Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\MultiCartManager

                # configuration for carts - the following values are set by default and can be omitted 
                cart:
                    # service ID of a cart factory which creates individual carts at runtime                    
                    factory_id: Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\CartFactory
                    
                    # options passed to cart factory, e.g. the cart class (available options vary by factory implementation)
                    factory_options:
                        cart_class_name: Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\Cart
                        guest_cart_class_name: Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\SessionCart
        
            default:   
                price_calculator:
                    # list price modificators for cart, e.g. for shipping-cost, special discounts, ...
                    # key is name of modificator
                    modificators:
                        shipping:
                            class: Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\CartPriceModificator\Shipping
                            # configuration options for price modificator
                            options:
                                charge: "5.90"

            # additional checkout tenant for cart manager
            #  - active tenant is set at \Pimcore\Bundle\EcommerceFrameworkBundle\EnvironmentInterface::setCurrentCheckoutTenant()
            noShipping: ~ # inherits from _defaults

Following elements are configured:

• Cart manager service ID: The cart manager is the basic entry point for working with carts. It is responsible for all interactions with different carts and provides functionality as creating carts, adding/removing products and also creates the corresponding price calculator.
• Cart factory service ID: builds carts when needed and can be configured with cart class name and further options varying by factory implementation
• Price calculator factory service ID + options and modificators: The price calculator is a framework for calculation and modification (shipping costs, discounts, ...) of prices on cart level. Each modification is implemented in a CartPriceModificatorInterface class. See Shipping or Discount for examples.

Available Cart Implementations

Following cart implementations are shipped with Pimcore core and can be configured in the factory_options section of the cart manager configuration:

• Session-Cart (class name Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\SessionCart): This cart implementation stores all cart information in the session of the user. If the session is cleared, also the carts are deleted. Use this implementation when no user login is available and storing carts in the database has no benefit.

• Database-Cart (class name Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\Cart): This cart implementation stores all cart information in the database. In this case, it is important that the currently logged in user is set to the E-Commerce Framework Environment with the code snippet in the box below. Use this implementation when user logins are available and the carts should be persisted beyond session lifetime.

Note: if you are using the database cart, don't forget to set the currently logged in user to the environment like follows: Factory::getInstance()->getEnvironment()->setCurrentUserId(YOUR_USER_ID)

Checkout Tenants for Carts

The E-Commerce Framework has the concept of so called Checkout Tenants which allow different cart manager and checkout manager configurations based on a currently active checkout tenant.

The current checkout tenant is set in the framework environment as follows:

<?php
$environment = Factory::getInstance()->getEnvironment();
$environment->setCurrentCheckoutTenant('default');
$environment->save();

$environment->setCurrentCheckoutTenant('noShipping');
$environment->save();

Once set, the cart manager uses all specific settings of the currently active checkout tenant which are configured in the configuration (identified by tenant name).

See also Demo for some examples.

Adding Custom Properties to Cart Items

Following steps are necessary to add additional custom properties to cart items:

1. Extend Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\CartItem implementation and add your custom properties including getters/setters.
2. Extend Cart::getCartItemClassName implementation and make sure your custom CartItem implementation gets returned.
3. Provide the custom properties as key-value pairs in $params parameter in the following methods:
   1. Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\AbstractCart::addItem
   2. Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\AbstractCart::updateItem
   3. Pimcore\Bundle\EcommerceFrameworkBundle\CartManager\CartManagerInterface::addToCart