Translation

Overview

The TechChange platform gives users the ability to navigate the platform in different languages. Translations for static content will already be provided while user-generated content must be manually translated. If you are creating a multilingual course on the platform, you will need to provide the translations for your custom course content. This guide will walk you through how multi-language content is delivered on the platform as well as how you can set up your courses to provide a multilingual experience for your users.

Supported Languages

The TechChange platform supports translation of platform content for the following languages:

• Arabic
• English
• French
• Hindi
• Portuguese
• Romanian
• Spanish
• Swahili

Please reach out to the Tech Team to request support for a new language.

Content Types

Content on the platform consists of both static content and user-generated content. Static content on the platform, such as button labels and menu item text, will already have translations provided. Any user-generated content, however, will need to be manually translated. See below for an overview of each type of content.

Static Content

Static content refers to any text throughout the platform that cannot be customized by a partner organization. A few examples include:

• Button text throughout the platform
• Login and registration form text
• Settings page text

Static content will translate automatically depending on the partner organization's default language and the user's language setting (see Language Settings for more details). Translation support for static content is currently limited to the languages listed above.

User-Generated Content

User-generated content is any text that is created by a user on the platform. For example, this can be a student's comment on a discussion thread or a chat message. It can also be any content added by an administrator such as course content, a description for the catalog listing, or application form questions. Translations for this type of content are not automatically provided and must be explicitly specified if you intend to make your course available in multiple languages. See Creating a Multi-Language Course for more details.

Language Settings

The various language settings on the platform will determine the language of the content that a user sees. A default language can be set within both the organization and course context. Note that whenever possible, the platform will prioritize an individual user's language setting if a translation in that language is available. If not, the default language of the context will be shown.

Organization

As an administrator, you can choose the default language for the organization. The default language will be used in the case where an individual user has not selected a preferred language. If no default language is set for the organization, English will serve as the fallback. You can update the default language for an organization as follows:

1. Navigate to the homepage of the Admin Portal.
2. Click the Settings button.
3. Select the General menu item.
4. Select the default language from the list of possible options.
5. Click the Save Changes button.

Courses and Tracks

A default language must be specified when creating a new course or track. This setting determines the fallback translation to use if a translation for course content does not exist in the user's preferred language. See the section Choose the Default Language below for more information.

User

A user's language setting takes highest priority. This setting will only be defined when a user explicitly sets their language on the platform. The platform language for a user can be changed by clicking on the user avatar in the top right corner of the screen. From the dropdown menu, click the Change Language option and select the desired language from the dropdown. After selecting the language, you should see the platform UI language change.

If a user has not set their language on the platform, we will attempt to guess their preferred language from the user's browser language setting.

Creating a Multi-Language Course

As discussed above, only static content will be automatically translated on the platform. Course content created by administrators will need to be manually translated. This section will walk you through the steps required to translate content for a course.

Choose the Default Language

When you create your course from the admin portal, you will need to specify a default language. This will be the fallback language for users viewing the course when there is no available translation that matches their personal language setting. For example, consider a course that only has English and Spanish translations. If the default language for the course is set to English and a user has their personal language set to French, they will see the course content in English since there is no French translation available.

Create the Base Content

Once you have created your course on the platform and have determined a default language for the course, you can now begin to add your content. This content will serve as the basis for all other translations and should be written in the course default language as determined in the previous step. Note the Language form field as you add content to the platform for resources, menu items, forms, polls, quizzes, etc.

Translate the Base Content

Once you have finalized your base content, you are now ready to export the content from the platform to pass on to your translation team. After the translation team has made the necessary updates to the exported files, you'll be able to import the translation into your course by uploading the files back onto the platform. This section will outline the steps of this process in more detail.

Content to Translate

Below is the list of admin-generated content that needs to be translated for a fully internationalized experience. Note that depending on your specific set-up for a course, some or all of these will need to be translated. Until all content types have multi-language support within a single course, it is possible that you will need to create a separate course for each language. Note that not all content types are exportable and may need to be manually re-created through the platform.

Multi-language support outside of courses:

• Profile form
• Post-Registration form

Multi-language support within a single course:

• Application form
• Catalog Listing pages
• Chat messages (via AI translations)
• Course session resources
• Course session forms, polls, and quizzes
• Course session navigational menu items
• Event descriptions
• Discussion thread descriptions

Separate course required for each language:

• Chat channel titles and descriptions (no CSV export)
• Certificates (no CSV export)
• Discussion thread titles and comments (no CSV export)
• Event titles and videos (no CSV export)

No multi-language support:

• Emails
  • The default copy for transactional emails have translations. However, we do not currently support translations of custom email content or session-specific transactional emails. A common work-around is to include all translations within the custom email body, e.g. "Name / Nombre / Nom".

The following sections outline the steps required to translate admin-generated content.

Translating the Course Session Content

Export Course Session Resources, Menu Items, Forms, Polls, and Quizzes for Translation

1. Navigate to the Admin Portal page for the course session (i.e. the page listing all enrollments)
2. Click the Export button on the right side of the page.
3. Select the Resource Translations menu item.
4. The zip file, Session_Resource_Translations_MM-DD-YYYY.zip, will be automatically downloaded to your computer. This zip file will contain a copy of each existing translation for the session resources, menu items, forms, polls, and quizzes. Extract the contents of the zip file to a location on your computer and find the CSV for the default language.
5. The CSV file will contain 3 columns: id, type, and content. The translation team should only make changes to the content column. You CANNOT CHANGE the data in the id and type columns. See example output below:

Import Translated Course Session Resources, Menu Items, Forms, Polls, and Quizzes

1. After the CSV file has been updated to include the translated data in the content column, navigate back to the Admin Portal page for the course session (i.e. the page listing all enrollments).
2. Click on the Settings tab.
3. Scroll down to find the Import Translations section.
4. Select the language of your translation from the Language dropdown.
5. Click the Browse button.
6. Navigate to the updated CSV file in your file browser and click to open.
7. Click the Import button.
8. Make sure your platform language is set to the language matching the imported translation and navigate to the course session. You should see the translated content displayed for the course session resources, menu items, forms, polls, and quizzes.
9. If you wish to make edits to the translation, you can do so either directly from the content editors on the platform or by repeating the CSV import process.

Translating the Course Content

Export Course Content, Catalog Listing, and Application Form for Translation

1. Navigate to the Admin Portal page for the course (i.e. the page listing all course sessions)
2. Click on the Settings tab.
3. Scroll down to find the Translations -> Export course data for translation section.
4. Click the Export button.
5. The zip file, Course_Translations_MM-DD-YYYY.zip, will be automatically downloaded to your computer. This zip file will contain a copy of each existing translation for the course details, catalog listing, and application form. Extract the contents of the zip file to a location on your computer and find the CSV for the default language.
6. The CSV file will contain 3 columns: id, type, and content. The translation team should only make changes to the content column. You CANNOT CHANGE the data in the id and type columns. See example output below:

Import Translated Course Content

1. After the CSV file has been updated to include the translated data for the content column, navigate back to the Admin Portal page for the course (i.e. the page listing all course sessions).
2. Click on the Settings tab.
3. Scroll down to find the Translations -> Import translation data for course section.
4. Select the language of your translation from the Language dropdown.
5. Click the Browse button.
6. Navigate to the updated CSV file in your file browser and click to open.
7. Click the Import button.
8. Make sure your platform language is set to the language matching the imported translation and navigate to the catalog listing page. You should see the translated content displayed for the course details, catalog listing content, and application form.
9. If you wish to make edits to the translation, you can do so either directly from the content editor on the platform or by repeating the CSV import process.

Translating the Track Content

Export Track Content, Catalog Listing, and Application Form for Translation

1. Navigate to the Admin Portal page for the track (i.e. the page listing all courses for the track)
2. Click on the Settings tab.
3. Scroll down to find the Translations - Export track data for translation section.
4. Click the Export button.
5. The zip file, Track_Translations_MM-DD-YYYY.zip, will be automatically downloaded to your computer. This zip file will contain a copy of each existing translation for the track details, catalog content, and application form. Extract the contents of the zip file to a location on your computer and find the CSV for the default language.
6. The CSV file will contain 3 columns: id, type, and content. The translation team should only make changes to the content column. You CANNOT CHANGE the data in the id and type columns. See example output below:

Import Translated Track Content

1. After the CSV file has been updated to include the translated data for the content column, navigate back to the Admin Portal page for the track (i.e. the page listing all courses).
2. Click on the Settings tab.
3. Scroll down to find the Translations -> Import translation data for track section.
4. Select the language of your translation from the Language dropdown.
5. Click the Browse button.
6. Navigate to the updated CSV file in your file browser and click to open.
7. Click the Import button.
8. Make sure your platform language is set to the language matching the imported translation and navigate to the catalog listing page. You should see the translated content displayed for the track details, catalog listing content, and application form.
9. If you wish to make edits to the translation, you can do so either directly from the content editor on the platform or by repeating the CSV import process.

Translating the Profile Form

Export Profile Form for Translation

1. Navigate to the Admin Portal page for the organization's profile form.
2. Click the Export button on the right side of the page.
3. Select the Profile Form Translations menu item.
4. The CSV file, Profile_Form_Translations_MM-DD-YYYY.csv, will be automatically downloaded to your computer.
5. The CSV file will contain 3 columns: id, type, and content. The translation team should only make changes to the content column. You CANNOT CHANGE the data in the id and type columns. See example output below:

Import Translated Profile Form

1. After the CSV file has been updated to include the translated data for the content column, navigate back to the Admin Portal page for the organization's profile form.
2. Scroll down to find the Translations -> Import translation data for profile form section.
3. Select the language of your translation from the Language dropdown.
4. Click the Browse button.
5. Navigate to the updated CSV file in your file browser and click to open.
6. Click the Import button.
7. Make sure your platform language is set to the language matching the imported translation and navigate to your profile page. You should see the translated content displayed for the profile form.
8. If you wish to make edits to the translation, you can do so either directly from the content editor on the platform or by repeating the CSV import process.

Translating the Post-Registration Form

Export Post-Registration Form for Translation

1. Navigate to the Admin Portal page for the organization's post-registration form.
2. Click the Export button on the right side of the page.
3. Select the Post-Registration Form Translations menu item.
4. The CSV file, Post_Registration_Form_Translations_MM-DD-YYYY.csv, will be automatically downloaded to your computer.
5. The CSV file will contain 3 columns: id, type, and content. The translation team should only make changes to the content column. You CANNOT CHANGE the data in the id and type columns. See example output below:

Import Translated Post-Registration Form

1. After the CSV file has been updated to include the translated data for the content column, navigate back to the Admin Portal page for the organization's post-registration form.
2. Scroll down to find the Translations -> Import translation data for post-registration form section.
3. Select the language of your translation from the Language dropdown.
4. Click the Browse button.
5. Navigate to the updated CSV file in your file browser and click to open.
6. Click the Import button.
7. Make sure your platform language is set to the language matching the imported translation and navigate to the post-registration form on your settings page. You should see the translated content displayed for the post-registration form.
8. If you wish to make edits to the translation, you can do so either directly from the content editor on the platform or by repeating the CSV import process.