To add a language into Projectal, follow these steps:

Getting the latest language file to translate

The first step when wanting to add a new language into Projectal is to get the latest language file from your Projectal.  This serves as the basis for all your language changes.

1. Go to the Management screen by clicking Management on the left sidebar.
2. Click the Languages button to display the Languages screen.
3. Select the English (Default) language and click the Download File button on the Languages screen toolbar.
4. This will download a file called language.json onto your computer.  This text file contains all the strings that are displayed in your Projectal.  
5. Rename the file to indicate the new language that you will be creating.  For example, rename the file to spanish.json.
   
6. There are several ways to translate a language file:
   • Manually editing the file using a text editor on your computer
     
   • Auto translating using a internet-based translation service
     

Manually translating the language file

You can edit the JSON file on your computer using a text editor.  When you open the JSON file, you will see many lines that look like this

"location_new": "New Location",

The format of the lines is as follows:

"<identifier>": "<text to be translated>",

In the above example, the text you can change is "New Location".

Important: Do not change any identifier text, colons, commas or keywords.  You should only change the text to be translated.  If you do make indavertent changes to other text, then the language file may not be able to be loaded by Projectal and you will only see the default English text.

Auto translating using a internet-based translation service

You can also use internet based services that auto-translate JSON files.  Some services are free to use and others are paid.

Example of a free service:

1. Go to https://translate.i18next.com
2. Upload your JSON file.  
3. Specify the source language of your JSON file (it will be typically "en").
4. Specify the target language that you want.  For example, select "es" for Spanish.  
5. Click the Translate (>) button to start the translation.  It may take several minutes to complete the translation.  
6. Once competed, click Download to download the file.  
7. You can edit the downloaded JSON file with a text editor on your computer to check the quality of the translations and make any changes to the final JSON file.
   

Uploading the JSON language file into Projectal

After you have completed your changes to the JSON language file on your computer, then you can add this file into your Projectal so you can add it to a language that you wish to use.

1. Go to the Management screen by clicking Management on the left sidebar.
2. Click the Files button to display the Files screen.
3. Navigate to the folder containing all your language files (or create a new folder to contain all your languages files).
4. Click the Upload File button on the Files screen toolbar.
5. This will display the File Details screen. Select your JSON language file from your computer and click OK to upload it into the folder in Projectal. You are now ready to add the language into your Projectal.
   

Adding your language into Projectal

1. Go to the Management screen by clicking Management on the left sidebar.
2. Click the Languages button to display the Languages screen.
3. Click the Add button on the Languages screen toolbar.
4. This will display the New Language screen.

Name

Enter the name of the language.  For example - "Spanish".

Description

Enter an optional description of the language.

Language Locale

Select the language locale for the language.  This should match the language code that your new language represents.  For example, for Spanish, you may want to choose "Spanish [es]".  Or if you wish to be more specific, you may want to choose "Spanish (Mexico) [MX]".  Projectal uses this information to auto select the language when a user has this same language set in their web browser on their computer.

Language File

Click the Add File button to select the language file that has been previously uploaded into Projectal.

Make Default Language

Select this checkbox if you want all users  to have this language auto selected for them when they log into Projectal the first time.  This is useful if you have a company language file that contains company terminology that you wish to use rather than the default terminology used in Projectal.