Multi-Language Support
Resolving Conversion Issues
Important!This section is only relevant to Web sites that upgrade to Ektron CMS400.NET Release 4.7 or higher and which, prior to the upgrade, had content blocks in more than one language. If your site does not meet both criteria, you can ignore this section.
When you upgrade to 4.7 or higher, the Database Upgrade utility prompts you to select a language. All content blocks in your site are then assigned that language. (Prior to Release 4.7, content blocks did not have a language attribute.) If all content blocks are not in the selected language, you must resolve that discrepancy.
For example, assume for the sake of simplicity that your pre-4.7 Web site had four content blocks: three English and one French. During the database upgrade, you select English. Three content blocks are then assigned the correct language, but the fourth content block, which should be assigned French, is also assigned English. You cannot simply change a content block's language assignment. When resolving the discrepancy, there are two possible scenarios.
Scenario 1
Prior to 4.7, your site had a unique content block in French (id number 4). To resolve this, copy the content block to a new French edition with the same id number. Then, delete the English edition.
Before Upgrade
Content block id Language attribute Actual language 1 not available English 2 not available English 3 not available English 4 not available FrenchAfter Upgrade
Content block id Language attribute Actual language 1 English English 2 English English 3 English English 4 English FrenchAfter Following Procedure Listed Below
Content block id Language attribute Actual language 1 English English 2 English English 3 English English 4 (deleted) English English 4 French FrenchProcedure for Scenario 1
To change a content block's language, follow these steps.
NoteBefore beginning this procedure, make sure
- the correct language for the content block is enabled. See Determining Which Languages are Available.
- metadata has been defined for the new language. See Adding a Metadata Definition
- Within Ektron CMS400.NET, navigate to the View Content screen on content block 4.
- From the Add drop-down list, select French.
- Ektron CMS400.NET creates a French edition of the content block.
- Check in that edition of the content block.
- Delete the English edition of the content block.
Scenario 2
Prior to 4.7, your site had English and French content blocks (id numbers 3 and 4) that presented the same content in each language. You want to leave the English content alone, create a French edition of that content block with the same id number, then delete the French content block.
The advantage of this solution is that both editions of the content block have a single id number. So, when a site visitor selects a language and navigates to that page, Ektron CMS400.NET displays the edition of the content block for the selected language.
To resolve this, create a French edition of the English content block, copy the French content, then delete the French content block.
Before Upgrade
Content block id Language attribute Actual language 1 not available English 2 not available English 3 not available English 4 not available FrenchAfter Upgrade
Content block id Language attribute Actual language 1 English English 2 English English 3 English English 4 English FrenchAfter Following Procedure Listed Below
Content block id Language attribute Actual language 1 English English 2 English English 3 English English 3 French French 4 (deleted) na naProcedure for Scenario 2
To solve the language conversion issue explained in scenario 2, follow these steps.
NoteBefore beginning this procedure, make sure
- the correct language for the content block is enabled. See Determining Which Languages are Available.
- metadata was defined for the new language. See Adding a Metadata Definition
- Within Ektron CMS400.NET, navigate to the View Content screen of content block id 3.
- From the Add drop-down list, select French.
- Ektron CMS400.NET creates a French edition of content block 3.
- Translate the title into French.
- Delete the English elements of content block 3 (content, summary, metadata, schedule, and comments).
- Check in the French edition of content block 3.
- Copy and paste all relevant elements of the French content block (id 4) into the French edition of content block 3 (content, summary, metadata, schedule, and comments).
- Delete content block id 4. See Also: Deleting a Content Block