Customizing languages with custom strings

Out-of-the-box, TopClass supports French, French Canadian, German, and Spanish localizations in addition to English. Administrators who want to customize these localizations or set up their own localizations can use Custom Strings to replace Default Values for a language.
Access Custom Strings by going to System Administration > System Settings > Custom Strings.

Setting up Custom Strings

To set up Custom Strings, do the following:

1. Go to System Administration > System Settings > Custom Strings.

2. Click the Default Values tab.

3. From the Language drop-down, select the language to customize.

4. Set up custom strings:

   1. In the content field, highlight strings to customize.

   2. Right-click the selected strings and choose Copy.

   3. Click the Custom Values tab.

   4. Paste strings into the content field.

   5. Modify the strings to contain the desired translation.

   🚧

   Warning

   Do not modify string names. Only string values, which are the text after the = sign in each string, can be modified.

   

   6. Select Save.

Adding new Custom Strings after TopClass updates

TopClass offers the ability to download new localization strings added in updates as a deltas.zip file, allowing Administrators to translate newly-added strings with ease and then copy the strings into the Custom Values area. The .zip file contains the following files:

• help.properties
• onboarding.properties
• resources.properties

Do the following:

1. Go to System Administration > System Settings > Custom Strings.
2. From the Language drop-down, select the language to customize.
3. Select Download Latest String Updates to download the deltas.zip file.
4. Right-click the deltas.zip file and choose Extract All....

5. Translate the strings:

   1. Open one of the files.
   2. Replace each string after the = sign with the new translation.

   

   👍

   Example

   Eusebía is a Super Administrator, and she is setting up a Latin American Spanish translation to better serve her community. She replaces the string help.strPurchaseAdditionalAttemptsNumber=Set the number of attempts a student receives with each purchase. with help.strPurchaseAdditionalAttemptsNumber=Establezca el número de intentos que un estudiante recibe con cada compra.

   3. Repeat steps a-c for all files.

6. Add the custom strings to TopClass:

   1. Go to System Administration > System Settings > Custom Strings.
   2. Click the Custom Values tab.
   3. From the Language drop-down, select the language to customize.
   4. From the custom string files edited in step 5, select the text, then right-click and Copy the strings.
   5. Right-click and Paste the strings into the Custom Values content field.
   6. Click Save.