This article presents a possible use case and corresponding sample flow that your app can support. It provides a useful starting point as you plan your app's implementation.
Suppose you're developing an app for managing book collections, and you want your Wix users (bookstore owners) to be able to translate the book collection data from the primary language en-us into other languages on their site.
Use the createSchema() method to define which fields of your book and collection entities are translatable. This step only needs to be done once. The fields parameter maps each field name (as a string) to an object specifying the data type (like text or image) and any constraints (like minimum or maximum length). The string acts as a key, which you'll use when adding translation content. The Create Schema method returns a schema ID that is also required for adding the translation content in the following step.
In our example, we define two schemas with the following fields:
| Schema | Fields |
|---|---|
| Book |
|
| Book Collection |
|
Ask the Wix user to specify the site's primary language. Call the createContent() method with the schema ID and the string key for each field to add your app's default content in the site's primary language. This content will serve as the base for all future translations across different locales.
For example, if the site's primary language is en-us, your default translatable content (field values) for a book may look like this:
The Wix user translates the book and book collection content via the Translation Manager. When they save the translations, the Translation Manager automatically calls the Translation Content API to store the updated content and mark it as ready to publish.
When a site visitor views the site in a language other than the site’s primary language, call queryPublishedContent() to retrieve and display the publish-ready translated content in their language. This ensures site visitors see the appropriate translations for their locale.