How to translate contents in dotCMS

This document is used for the Content / Translation Management team who are responsible for translating the English version to other languages once it is completed by development team.

1 - Search for contents / widgets

Once you are logged in, go to Content > Search
In the Type dropdown, you can find all the content types (Ex. [SiteCommon]Jumbotron) and widgets (Ex. [SiteCommon]CreditCardFormWidget). Content types are used for pure text content, while widgets contain special built-in JavaScript functionalities.

2 - Copy the contents / widgets

Select the site you want to work on from the top left dropdown.
Select the content type / widget you want to create content for, you can see the list of available content under selected site.
For each of the content in the content type / widget you selected, make a copy and then update the details of the copied version to desired language.
Example: Copy the "Billing Details - euphoricfeet confirm page - EN" to create DE version. The title needs to be kept the same, just change the language code for identification.
Example: Copy the "common credit card form - regular order page - EN" to create DE version.

Note: When editing in the WYSIWYG editor, please ensure that you are working on the WYSIWYG mode (not CODE) mode. It is more user friendly to edit. Please refer to the screenshot below for details.

3 - Naming convention for contents / widgets

{common}_[Site Name]_[Language]_[Title] - [page type] : Secondstreamtv_EN_item order - confirm page
common: Indicate that this contents / widgets is re-usable among all sites, they don't need to be duplicated for any new site. Please note that since they are reused in many sites, any changes will affect all the sites which are using them. A new version is required if there is any specific requirement for a single site.
Title: Name of the content / widget. For content, in order to search easily, please use the first sentence for title.
Page type: The type of the pages that use this content / widget.
Language code: Language version of the content / widget.

4 - Translating data files

Data files contains the general data which is used in every page of a site, such as header, footer, social links, validation errors.
Data files can be found in Browser > application > data
To create a new data file, open the desired file, download it by clicking the download link.
Copy the downloaded content to an editor, update the text with translation, save it to a new name with correct language code, then upload it into dotCMS by using the option in the top right menu.

Reference

For details of Content Types and Widgets, refer to the wiki page below.