Migration guide - QuickOrderPage

Edit on GitHub

Upgrading from version 2.* to version 4.0.0

In order to dismantle the Horizontal Barrier and enable partial module updates on projects, a Technical Release took place. Public API of source and target major versions are equal. No migration efforts are required. Please contact us if you have any questions.

Upgrading from version 1.* to version 2.*

At version 2.0.0 we’ve introduced a couple of features for the Quick Order page. First of all, there is a brand new possibility to search for concrete products by name or SKU using a widget (reusable functionality). Now, a user is able to add items to a shopping list from the Quick Order form. After the user selected a certain product from the search field, price and measurement unit (if the module is installed and product already has unit) will be displayed. A price is getting recalculated on every quantity field change taking into account volume prices. Quantity is validated against quantity restrictions if configured. While adding to cart packaging units will be applied to a product if present.

To perform the migration, follow the steps:

  1. This feature requires ProductPageSearch 3.x.x.
  2. Generate transfers:
vendor/bin/console transfer:generate
  1. Build frontend:
vendor/bin/console frontend:yves:install-dependencies  
vendor/bin/console frontend:yves:build
  1. Some files were re-organized, so if you had overwritten classes and templates on project level please check our release notes.
  • quick-order-form-field-list.twig was removed
  • components/molecules/quick-order-rows/quick-order-rows.twig has changes
  • quick-order.twig and quick-order-form.twig now use new data from controller
  • quick-order-async-render.twig was renamed to quick-order-row-async.twig
  • TextOrderParser was moved to SprykerShop\Yves\QuickOrderPage\TextOrder, getParsedTextOrderItems() was renamed to parse().
  1. Change the removed deprecated code with its substitution.
  • Deprecated constants were removed QuickOrderPageConstants::ALLOWED_SEPARATORS, QuickOrderPageConstants::PRODUCT_ROWS_NUMBER. Use QuickOrderPageConfig instead.

Estimated migration time: 2h