Skip to main content

How to upgrade the extension

To upgrade the extension, follow these steps:

  1. Back up your store's database and web directory.

  2. Log in to the SSH console of your server and navigate to the root directory of your Magento 2 store.

  3. Run the following command to update the current extension along with all dependencies:

    composer require mirasvit/module-shipping-restriction:* --update-with-dependencies

    In some cases, the commands above may not be applicable, or you may be unable to update only the current module. If that's the case, you will need to upgrade all Mirasvit modules in a bundle. The command above will have no effect in such scenarios.
    Instead, run the following commands to update all Mirasvit modules installed in your store:

    composer update mirasvit/*

    On a Hyvä store, version 1.2.0 needs hyva-themes/magento2-theme-module 1.3.14 or later and, if you use it, Hyvä Checkout 1.3.1 or later. With an older Hyvä composer refuses the update, so upgrade Hyvä first.

    If mirasvit/module-shipping-restriction-hyva is installed, you don't have to remove it first. From version 1.2.0 Hyvä support ships inside the extension itself, and composer takes the old package off during this update. No settings are lost, and setup:upgrade removes the retired Hyva_MirasvitShippingRestriction module name from app/etc/config.php for you.

  4. Install the updates by running the following command:

    php -f bin/magento setup:upgrade
  5. Clean the cache by running the following command:

    php -f bin/magento cache:clean
  6. On a Hyvä storefront, rebuild the theme assets, so the build picks up the shipping restriction templates from their new location:

    bin/magento hyva:config:generate
    cd /path/to/theme/web/tailwind/
    npm run build
    cd /path/to/project/

    On a theme older than Hyvä 1.4, run npm run build-prod instead.

    If you overrode one of the extension's Hyvä templates in your theme, move the override: Hyva_MirasvitShippingRestriction::cart/shipping.phtml is now Mirasvit_ShippingRestriction::cart/shipping-hyva.phtml, and Hyva_MirasvitShippingRestriction::checkout/shipping/method-list.phtml is now Mirasvit_ShippingRestriction::checkout/shipping/method-list-hyva.phtml. An override at the old path is no longer read.

  7. Deploy the static view files:

    rm -rf pub/static/*; rm -rf var/view_preprocessed/*;
    php -f bin/magento setup:static-content:deploy