Implementation Scenarios
Below are examples of TMF best practice implementations. The scenarios lay out configuration requirements to support frequent localization needs.
Scenario A
Conditions
- Single country
- Multiple languages (English, Spanish)
- Master content in English folder
Site Structure
This is the preferred site structure. If you are focusing on only one country, the country folder is optional.
![image021.png image021.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1641iF90EC46BB891A797/image-dimensions/247x196?v=v2)
Your TMF folder structure should look like this:
![image023.png image023.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1642i53B7A858525461A3/image-dimensions/248x301?v=v2)
Locales Config
Configure US-EN
- Select the appropriate country and language, in the example it’s “United States” for country and “English” for language.
- Select the Site Root. In this case, it could be “/US/en/”.
![image024.png image024.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1643i44C514C8D660F4F6/image-dimensions/338x375?v=v2)
Configure US-ES
- Select the appropriate country and language, in the example it’s “United States” for country and “Spanish” for language.
- Select the Site Root. In this case, it could be “/US/es/”.
![image025.png image025.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1644i8581507941D9F5E9/image-dimensions/328x358?v=v2)
Use TMF to derive the content
- Create master content in “/US/en/”.
- Select one of the content pages and click Edit > Form.
- Expand TMF panel.
- If you don’t see the TMF input fields like the screenshot below, please double check if locale configs are properly set up or template files are correctly implemented.
- Choose where you want to send for translation. In this case, US-ES is the only option available in the list.
![image026.png image026.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1645i9AE791FA868FD786/image-dimensions/424x408?v=v2)
- Tick “US-ES” checkbox and click Save.
- TMF will create a same asset in the selected locale folder.
- Refresh the input screen.
![image027.png image027.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1646i9D0EAA2B83418D67/image-size/medium?v=v2&px=400)
- Click Existing Translation link to check the asset.
Scenario B
Conditions
- Multiple countries (United States, Canada)
- Multiple languages (English, Spanish, French)
- Master content in United States > English folder
Site Structure
This is the preferred site structure. If you are focusing on only one country, the country folder is optional.
![image028.png image028.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1647i501ACAD224A2F293/image-dimensions/259x282?v=v2)
TMF Configuration
Your TMF folder structure should look like this.
![image030.png image030.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1649i518FE1A8765E3FCB/image-dimensions/275x391?v=v2)
Locales Config
Configuring CA-EN
- Select the appropriate country and language, in the example it’s "Canada” for country and “English” for language.
- Select the Site Root. In this case, it could be “/Canada/en/”.
![image031.png image031.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1650iD2FF219B9D1F37AD/image-dimensions/291x323?v=v2)
Configuring CA-FR
- Select the appropriate country and language, in the example it’s "Canada” for country and "French" for language.
- Select the Site Root. In this case, it could be “/Canada/fr/”.
Configuring US-EN
- Select the appropriate country and language, in the example it’s "United States” for country and "English" for language.
- Select the Site Root. In this case, it could be “/US/en/”.
Configuring US-ES
- Select the appropriate country and language, in the example it’s "United States” for country and "Spanish" for language.
- Select the Site Root. In this case, it could be “/US/es/”.
Use TMF to derive the content
- Select one of the content pages and click Edit > Form.
- Expand TMF panel.
- If you don’t see the TMF input fields like the screenshot below, please double check if locale configs are properly set up or template files are correctly implemented.
- If you don’t see the TMF input fields like the screenshot below, then please double check if locale configs are properly set up and template files are correctly implemented.
- Choose where you want to send for translation.
![image033.png image033.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1651i0D69D69564420EE8/image-dimensions/406x475?v=v2)
- Select locale(s), tick the checkbox(es) and click Save.
- TMF will create an asset in the selected locale folder(s).
- Refresh the input screen.
![image034.png image034.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1652i3AD6BE4DCF316FB6/image-dimensions/449x475?v=v2)
- Click Existing Translation link to check the asset.
Scenario C
Conditions
These are the same conditions as Scenario B but the Translation Rule is configured to limit the accessible locales.
- Multiple countries (United States, Canada)
- Multiple languages (English, Spanish, French)
- Master content in United States > English folder
Site Structure
This is the preferred site structure. If you are focusing on only one country, the country folder is optional.
![image028.png image028.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1647i501ACAD224A2F293/image-dimensions/271x295?v=v2)
TMF Configuration
Your TMF folder structure should look like this:
![image030.png image030.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1649i518FE1A8765E3FCB/image-dimensions/239x340?v=v2)
Locales Config
Configuring CA-EN
- Select the appropriate country and language, in this case it’s “Canada” for country and “English” for language.
- Select the Site Root. In this case, it “/Canada/en/” .
![image031.png image031.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1650iD2FF219B9D1F37AD/image-dimensions/292x324?v=v2)
- Hide all the locales (US-EN, US-ES).
![image035.png image035.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1653i93718D6230EBAE5B/image-size/medium?v=v2&px=400)
Configuring CA-FR
- Select the appropriate country and language, in this case it’s “Canada” for country and “French” for language.
- Select the Site Root. In this case, it could be “/Canada/fr/”.
- The screenshot below is a recommended setup for the destination locale. This will only allow the selected locale content to be derived.
![image036.png image036.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1654i33C6C2C0DDC11FD9/image-size/medium?v=v2&px=400)
Configure US-EN
- Select the appropriate country and language, in this case it’s “United States” for country and “English” for language.
- Select the Site Root. In this case, it could be “/US/en/”.
- Hide all the locales (CA-EN, CA-FR) except US-ES.
![image037.png image037.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1655iF0C2EA42BDF511AD/image-size/medium?v=v2&px=400)
Configure US-ES
- Select the appropriate country and language, in this case it’s “United States” for country and “Spanish” for language.
- Select the Site Root. In this case, it could be “/US/es/” or “/US-es/” based on the folder structure.
- The screenshot below is a recommended setup for the destination locale. This will only allow the selected locale content to be derived.
![image036.png image036.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1656i03B653CA26DC8AAA/image-size/medium?v=v2&px=400)
Use TMF to derive the content
- Select one of the content pages and click Edit > Form.
- Expand TMF panel.
- If you don’t see the TMF input fields like the screenshot below, please double check if locale configs are properly set up or template files are correctly implemented.
- If you don’t see the TMF input fields like the screenshot below, then please double check if locale configs are properly set up and template files are correctly implemented.
- Confirm that it only shows the selected locales in the Translation Rule. Choose where you want to send for translation.
![image038.png image038.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1657iCD71A5DA10117909/image-dimensions/465x307?v=v2)
- Select locale(s), tick the checkbox(es) and click Save button.
- TMF will create a same asset in the selected locale folder(s).
- Refresh the input screen.
![image039.png image039.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1658iF42002D7F710B140/image-dimensions/465x243?v=v2)
- Click Existing Translation link to check.
Scenario D
Conditions
These are the same conditions as Scenario B but the Translation Rule is configured to limit the accessible locales
- Multiple master contents in the project
- Multiple countries (United States, Canada)
- TMF configuration folder per country folder
- Multiple languages (English, Spanish, French)
Site Structure
This is the preferred site structure.
![image040.png image040.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1659i9E5EF33F28C0F436/image-dimensions/233x285?v=v2)
TMF Configuration
TMF folder for Canada
![image041.png image041.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1660i3B873605C1748339/image-dimensions/224x310?v=v2)
TMF folder for US
![image042.png image042.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1661iF145034BEA75A679/image-dimensions/218x283?v=v2)
Locales Config
Configuring CA-EN
- Select the appropriate country and language, in this case it’s “Canada” for country and “English” for language.
- Select “/Canada/en/” folder for the Site Root.
![image031.png image031.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1662iDBB3010B5AD5F9BD/image-dimensions/263x292?v=v2)
Configuring CA-FR
- Select the appropriate country and language, in this case it’s “Canada” for country and "French" for language.
- Select “/Canada/fr/” folder for the Site Root.
Configuring US-EN
- Select the appropriate country and language, in this case it’s "United States" for country and "English" for language.
- Select “/US/en/” folder for the Site Root.
Configuring US-ES
- Select the appropriate country and language, in this case it’s "United States" for country and "Spanish" for language.
- Select “/US/es/” folder for the Site Root.
Use TMF to derive the content
- Create master content in “/US/en/” folder
- Create master content in “/Canada/en/” folder
- Select one of the content pages and click Edit > Form.
- Expand TMF (Translation Model Framework) panel.
- If you don’t see the TMF input fields like the screenshot below, please double check if locale configs are properly set up or template files are correctly implemented.
- Tick “US-ES” checkbox and click Save button.
![image026.png image026.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1663i6C425EB9BCD96E19/image-dimensions/433x417?v=v2)
- TMF will create a same asset in the selected locale folder.
- Refresh the input screen.
![image027.png image027.png](https://community.crownpeak.com/t5/image/serverpage/image-id/1664i14DC1E0EF692E075/image-dimensions/501x174?v=v2)
- Click Existing Translation link to check the asset.