Skip to main content
Version: 2024.4

Checkout Steps

For each checkout step (e.g. delivery address, delivery date, ...) there has to be a concrete checkout step implementation. This implementation is responsible for storage and loading of necessary checkout data for each step. It needs to extend \Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager\AbstractStep and implement \Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager\CheckoutStepInterface.

Following methods have to be implemented:

  • commit($data): Is called when step is finished and data needs to be saved.
  • getData(): Returns saved data for this step.
  • getName(): Returns name of the step.

Configuration of Checkout Steps:

See configuration for checkout step configuration.

Sample Implementation of a Checkout Step:

<?php

namespace Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager;

/**
* Class \Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager\DeliveryAddress
*
* sample implementation for delivery address
*/
class DeliveryAddress extends AbstractStep implements CheckoutStepInterface
{
/**
* namespace key
*/
const PRIVATE_NAMESPACE = 'delivery_address';

public function getName(): string
{
return 'deliveryaddress';
}

/**
* sets delivered data and commits step
*/
public function commit(mixed $data): bool
{
$this->cart->setCheckoutData(self::PRIVATE_NAMESPACE, json_encode($data));

return true;
}

/**
* returns saved data of step
*/
public function getData(): mixed
{
$data = json_decode($this->cart->getCheckoutData(self::PRIVATE_NAMESPACE));

return $data;
}
}

Working with Steps:

<?php

$manager = Factory::getInstance()->getCheckoutManager($cart);
$step = $manager->getCheckoutStep("deliveryaddress");
$address = new stdClass();
//fill address
$manager->commitStep($step, $address);

$step = $manager->getCheckoutStep("deliverydate");
$manager->commitStep($step, $data);
$cart->save();