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-surcharge:* --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/*

    If mirasvit/module-surcharge-hyva is installed, you don't have to remove it first. From version 1.1.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_MirasvitSurcharge 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 surcharge templates:

    bin/magento hyva:config:generate
    cd /path/to/theme/web/tailwind/
    npm run build-prod
    cd /path/to/project/
  7. Deploy the static view files:

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