Accommodating Languages Other Than English

CloudRadial doesn't support native localization. However, for both our client's preferences and for localization needs, the sidebar is customizable and can theoretically support any language injection.

In a simple scenario, Partners can simply change the menu text to the language of their choice.

However, we commonly see our Partners struggle with a varied clientele that consists of clients that speak different languages - for example, a Canadian MSP with clients in Quebec may have some clients that speak only English while others only speak French. 

To address this challenge, you can utilize token substitutions to vary the language of the sidebar on a company-by-company basis.

Note! Before following the instructions below, it is critical that you understand how tokens work.

Let's look at how to accomplish this in three stages.

• Establishing Token Substitutions for Language Variances
• Setting Default Text Token Values
• Varying Language for Certain Clients

1. Establishing Token Substitutions for Language Variances

1. Navigate to Partner > Settings
2. Click on Account & Branding at the top right, under Setup
   
                            
   
   
3. Select the Sidebar tab
4. Instead of renaming the sections to a specific language, use token values in their place
   • For example, instead of "Home" for the Home section, write @Home in its place
   • The easiest way to accomplish this is to simply write in the @ sign in front of each menu text                
     
     
5. Select Submit to finalize the process

At this stage, you should see all of your sidebar menu text options display as the token values themselves - with the @ sign and all. The reason for this is that we have not yet created tokens to substitute these values, so CloudRadial is interpreting them literally (for now). 

2. Setting Default Text Token Values

Now, we'll need to set global defaults for the menu tokens we created.

To do so:

1. Navigate to Partner > Settings
2. Select Tokens under the Configuration menu
   
                                        
   
   
3. Use the +Add button at the top right to add tokens 
   • You will want to add a token for each section you need to be customized. Based on step #4 from the section above, you'd need @Home, @Company, @Applications, and so on.
   • For the value of each token, enter the language you want to be the default for every client.
     
     
     
     
4. Select Submit to finalize your changes

At this stage, the sidebar text should change to your token values. To an average person, the menu items should look no different than how they were before you started this text modification project

However, since we've injected the token value as an additional layer in front of the sidebar text, we can now vary it for specific companies (which we'll do in the next step).

3. Varying Language for Certain Clients

For clients that deviate from your main language, we'll need to redefine tokens for them. 

To do so:

1. Navigate to Partner > Clients
2. Select a specific client by clicking on them
3. Navigate to the Tokens tab for that client
4. Add the same tokens that you did in the global Tokens area
   • But for the value, change it to be whatever language they require
   • The token for the individual client must match the same global token name exactly
5. Select Submit to finalize the process

The company with the company-specific tokens will now display the text you have chosen. Remember that CloudRadial first looks for company-specific tokens first, then global ones. If it finds a matching token value at the company level, it will apply that and ignore the global token value.

This is the basis for creating a global template of token values with company-specific exceptions.