Translating Applications for Ecwid
Ecwid has over 1.5 million registered merchants all around the world. To fulfill their needs, Ecwid is translated into over 50 languages in the storefront and 21 languages in the Ecwid Control Panel.
Your application will be accessible by all of these merchants. To make sure they have the best experience, your application should be translated into as many languages as possible.
Learn how to translate your app using the guides below.
Ecwid’s API Platform allows you to have a fully translated application for users from different countries.
Your app is translated in the following areas:
- App details page: texts, images
- Application itself: app interface, app tab name (for native apps), etc.
Find out how to translate each part of the app below.
Translating the application interface
Applications in Ecwid work in three different parts of an Ecwid store:
- Application tab in Ecwid Control Panel (native apps)
- External website (external apps)
- Find out how your app gets the payload (check your app iframe URL in your browser’s dev tools)
- Get lang field value from the payload based on step 1
- Load the text labels based on the language of Ecwid CP
- Create a copy of this document: https://docs.google.com/document/d/1afEm_MFFPVHlA5eZOHYpDn9VQrwkmqb8h-9z5dR0_vU/edit?usp=sharing
- Complete all of the fields, including the language and the app name
- Submit it to the Ecwid team for review
Translating the storefront
It is available right after Ecwid starts to load on the page, so your app knows the storefront language right away.
Once the app knows the language, it needs to load the corresponding labels when initializing in a storefront. If the current language is not supported, the app has to load default text labels.
For example, if storefront in Spanish and the app doesn’t support it yet, make sure to load the English version of text labels for interfaces.
Translating native apps
Native applications can embed into Ecwid Control Panel to provide settings or the main feature of your app.
You are able to translate the native application interface based on the language of the Ecwid Control Panel. The merchant’s active language is provided in the authentication payload your application receives.
So, to translate a Native app, follow these steps:
If the current language is not supported, use the fallback labels. For example, load English text if the user’s language is Spanish and you don’t have Spanish translations yet.
For more details on getting info from payload, check Ecwid API Docs.
Translating external apps
External apps are accessed outside of the Ecwid Control Panel, so your app has full control of the information about the user, like browser language, geolocation, etc.
Make sure to show your interface in the appropriate language based on the merchant who is installing and accessing your app.
In any case, you can get the store office country in the information about store profile in Ecwid REST API.
Translating app details page
Your app details page has these elements: (screenshot). You are able to translate them into any language the Ecwid Control Panel supports.
To translate your app details page, you will need to follow these steps:
Once approved, the Ecwid team will apply the changes and the info you submitted to your app.