Add translations (switch locale)

Step-by-step guide

Local setup is required to add translations.

Code customization and local setup
  1. Ensure that you are running "@scandipwa/scandipwa": "x.x.x". You can check within scandipwa/package.json file.

  2. Set up the project locally by following these instructions.

  3. Navigate to scandipwa folder within your source code folder.

  4. Run command from the terminal npm i @scandipwa/webpack-i18n-runtime

  5. Remove hardcoded locale from app/etc/config.php file by deleting the following lines of code: 'general' => [

    'locale' => [

    'code' => 'en_US'

    ]

    ],

  6. Open scandipwa/package.json file.

  7. Add the locales you wish to have and @scandipwa/webpack-i18n-runtime extension, for example: "scandipwa": {

    "type": "theme",

    "locales": {

    "en_US": true,

    "fr_FR": true

    },

    "parentTheme": "@scandipwa/scandipwa",

    "extensions": {

    "@scandipwa/webpack-i18n-runtime": true

    }

    },

  8. Navigate to scandipwa folder and build your ScandiPWA theme to create added translation files by running the following command: BUILD_MODE=magento npm run start

  9. Add your translations within generated locale file which is located in scandipwa/i18n folder.

  10. Navigate to the repository root folder and run: npm run start

  11. In Magento admin go to Stores > Configuration > General > General > Locale Options.

  12. Switch to your store's scope and change the Locale to the one you created.

  13. Clear cache by going to System > Tools > Cache Management and pressing Flush Cache Storage and Flush Magento Cache.

  14. Open Frontend to ensure that translations are active.

  15. Push all the changes to your repository.

  16. Once the changes are deployed, enable access instance using SSH following these instructions.

  17. Run the following command to enable developer mode: magento deploy:mode:set developer

  18. Change the locale for the store view through your instance admin panel.

  19. Clear cache by going to System > Tools > Cache Management and pressing Flush Cache Storage and Flush Magento Cache.

  20. Run the following commands from your SSH: magento in:rei magento c:c magento deploy:mode:set production

Last updated