What is multiple languages add-on?

Multiple Languages - an add-on that allows your customers to select the localization of the shop-bot from a list of languages you have added.

How to set up multiple languages?

⚠️ It is assumed that you have already connected Google Sheets. If not click here.

Open your Google Sheets table → switch to the Texts sheet.

Add a new column and enter a name for it in the first cell. In this example we will name our column: TRANSLATION_LANG.

Add your own versions of the translation for every line in the table.

After translating the standard messages and buttons of the shop-bot, you need to add a translation for everything that you added to the shop-bot yourself.

You will most likely need translations for:

welcome message

keyboard buttons and messages when they are pressed

order statuses

button labels

checkout messages.

For each custom text or label you need to add a system name to the _id column.

Every name for the custom text or label must:

start with t_

contain no spaces (you can use underscores _ instead)

contain only English characters and numbers

To translate the names and descriptions of categories, switch to the Categories sheet.

Add columns with headings in the format below, as well as the translation itself (for each language):

translation.label.TRANSLATION_LANG

To translate the name and description of products, switch to the Products sheet.

Add columns with headings using the formats below (for each language):

for names (including translations for the product variations names) - translation.name.TRANSLATION_LANG

for descriptions - translation.description.TRANSLATION_LANG

if you are using product variations, add another column that will contain name of the main (parent) product for each variation - translation.productGroupName.TRANSLATION_LANG

Now import your translation.

Open your Dashboard → Settings page → Integrations tab → Google Sheets section → Texts subsection → Import button.

Add translation to the bot settings.

Add names of your custom texts that start with t_ (hereinafter referred to as variables) to the fields and settings you need.

Each individual variable must be enclosed in $ when used, for example: $t_welcome_message$.

Now add a language switcher.

Dashboard → Keyboard page → add a button of the Settings type and enter a proper variable you created in its Message / Settings field.

Finally we can enable the add-on itself.

Dashboard → Add-ons page → Multiple languages section → Enable button.

Set up the plugin.

Click the Settings button → Add language selection message.

Add as many supported languages as you need.

Fill in the fields for each language: Language ID, Language name, Currency

In the Language ID field, copy/paste your TRANSLATION_LANG from the translations table.

Click the Save button.

How to set up different currencies for each language?

Open add-on settings.

Use the Currency field to enter ISO 4217 currency codes per each added language.

Click Save.

Updated on: 02/09/2022