Install the Shipment + Cart feature

Edit on GitHub

Install feature core

Prerequisites

To start feature integration, overview, and install the necessary features:

NAME VERSION
Spryker Core 202404.0
Shipment 202404.0
Cart 202404.0
Prices 202404.0

Install the required modules using Composer

Run the following commands to install the required modules:

composer require spryker/shipment-cart-connector: "^2.1.0" spryker/shipment-type-cart: "^1.0.0" --update-with-dependencies
Verification

Make sure that the following modules have been installed:

MODULE EXPECTED DIRECTORY
ShipmentCartConnector vendor/spryker/shipment-cart-connector
ShipmentTypeCart vendor/spryker/shipment-type-cart

Set up transfer objects

Run the following command(s) to apply transfer changes:

console transfer:generate
Verification

Make sure the following changes have been applied in transfer objects:

TRANSFER TYPE EVENT PATH
ShipmentMethods class Created src/Generated/Shared/Transfer/ShipmentMethodsTransfer
ShipmentMethod class Created src/Generated/Shared/Transfer/ShipmentMethodTransfer
Order class Created src/Generated/Shared/Transfer/OrderTransfer
Quote class Created src/Generated/Shared/Transfer/QuoteTransfer
Item class Created src/Generated/Shared/Transfer/ItemTransfer
Expense class Created src/Generated/Shared/Transfer/ExpenseTransfer
MoneyValue class Created src/Generated/Shared/Transfer/MoneyValueTransfer
Money class Created src/Generated/Shared/Transfer/MoneyTransfer
CartPreCheckResponse class Created src/Generated/Shared/Transfer/CartPreCheckResponseTransfer
Message class Created src/Generated/Shared/Transfer/MessageTransfer
CartChange class Created src/Generated/Shared/Transfer/CartChangeTransfer
Currency class Created src/Generated/Shared/Transfer/CurrencyTransfer
ShipmentGroup class Created src/Generated/Shared/Transfer/ShipmentGroupTransfer
Shipment class Created src/Generated/Shared/Transfer/ShipmentTransfer
ShipmentMethodsCollection class Created src/Generated/Shared/Transfer/ShipmentMethodsCollectionTransfer
ShipmentType class Created src/Generated/Shared/Transfer/ShipmentTypeTransfer
ShipmentTypeCollection class Created src/Generated/Shared/Transfer/ShipmentTypeCollectionTransfer
ShipmentTypeConditions class Created src/Generated/Shared/Transfer/ShipmentTypeConditionsTransfer
ShipmentTypeCriteria class Created src/Generated/Shared/Transfer/ShipmentTypeCriteriaTransfer
CheckoutResponse class Created src/Generated/Shared/Transfer/CheckoutResponseTransfer
CheckoutError class Created src/Generated/Shared/Transfer/CheckoutErrorTransfer
Store class Created src/Generated/Shared/Transfer/StoreTransfer

Set up behavior

Register the following plugins:

PLUGIN SPECIFICATION PREREQUISITES NAMESPACE
CartShipmentCartOperationPostSavePlugin Recalculates the shipment expenses. Replacement for CartShipmentExpanderPlugin Spryker\Zed\ShipmentCartConnector\Communication\Plugin\Cart
CartShipmentPreCheckPlugin Validates if current shipment method is still valid in cart shipments. Spryker\Zed\ShipmentCartConnector\Communication\Plugin\Cart
SanitizeCartShipmentItemExpanderPlugin Clears quote shipping data if a user modified quote items. Spryker\Zed\ShipmentCartConnector\Communication\Plugin\Cart
ShipmentTypeCheckoutPreConditionPlugin Validates if selected shipment type have relation to selected shipment method, current store and is active. Spryker\Zed\ShipmentTypeCart\Communication\Plugin\Checkout\ShipmentTypeCheckoutPreConditionPlugin

Pyz\Zed\Cart\CartDependencyProvider

<?php

namespace Pyz\Zed\Cart;

use Spryker\Zed\Cart\CartDependencyProvider as SprykerCartDependencyProvider;
use Spryker\Zed\Kernel\Container;
use Spryker\Zed\ShipmentCartConnector\Communication\Plugin\Cart\CartShipmentCartOperationPostSavePlugin;
use Spryker\Zed\ShipmentCartConnector\Communication\Plugin\Cart\SanitizeCartShipmentItemExpanderPlugin;

class CartDependencyProvider extends SprykerCartDependencyProvider
{
    /**
     * @param \Spryker\Zed\Kernel\Container $container
     *
     * @return \Spryker\Zed\CartExtension\Dependency\Plugin\ItemExpanderPluginInterface[]
     */
    protected function getExpanderPlugins(Container $container)
    {
        return [
            new SanitizeCartShipmentItemExpanderPlugin(),
        ];
    }

    /**
     * @param \Spryker\Zed\Kernel\Container $container
     *
     * @return \Spryker\Zed\CartExtension\Dependency\Plugin\CartOperationPostSavePluginInterface[]
     */
    protected function getPostSavePlugins(Container $container)
    {
        return [
            new CartShipmentCartOperationPostSavePlugin(),
        ];
    }
}

src/Pyz/Zed/Checkout/CheckoutDependencyProvider.php

<?php

namespace Pyz\Zed\Checkout;

use Spryker\Zed\Checkout\CheckoutDependencyProvider as SprykerCheckoutDependencyProvider;
use Spryker\Zed\Kernel\Container;
use Spryker\Zed\ShipmentTypeCart\Communication\Plugin\Checkout\ShipmentTypeCheckoutPreConditionPlugin;

class CheckoutDependencyProvider extends SprykerCheckoutDependencyProvider
{
    /**
     * @param \Spryker\Zed\Kernel\Container $container
     *
     * @return list<\Spryker\Zed\CheckoutExtension\Dependency\Plugin\CheckoutPreConditionPluginInterface>
     */
    protected function getCheckoutPreConditions(Container $container): array
    {
        return [
            new ShipmentTypeCheckoutPreConditionPlugin(),
        ];
    }
}
Verification
  • Make sure that if you change items in the cart (add, remove or change quantity) then all the shipping methods are sanitized.
  • Make sure that if you deactivate shipment type selected during the checkout, you will receive a validation error on checkout summary page.

Install feature frontend

Follow the steps below to install the feature frontend.

Prerequisites

Install the required features:

NAME VERSION
Shipment 202404.0
Cart 202404.0

Add translations

Add translations as follows:

  1. Append glossary according to your configuration:

src/data/import/glossary.csv

>shipment_type_cart.checkout.validation.error,Selected delivery type "%name%" is not available,en_US
shipment_type_cart.checkout.validation.error,Die ausgewählte Lieferart "%name%" ist nicht verfügbar,de_DE
  1. Import data:
console data:import glossary
Verification

Make sure that the configured data has been added to the spy_glossary table in the database.