Languages

SMSPlus offers its users an ability to run the application as a multilingual platform, where the administrator of the application can use the language file to translate application (Field Labels, Page Title & Description, Help Notes and Options etc.) in as many languages as he wants. A list of all languages appears on the top right area of the admin as well as client side of the dashboard, for the user to use the application by conveniently selecting the preferred language.

How Multilingual Works? 

From the list of languages that appear on the title bar of the dashboard under "Select Language", only those languages having an active translation uploaded can be selected to effectively  and appropriately translate field labels, options, page descriptions, help notes and titles, into the selected language. Selecting a language that doesn't have complete translation uploaded via language file, would only result in translating the specific page  that user would be browsing at that time, and that too using 3rd party translate tool (Google Translate etc.). So to completely translate the language of the application, you would need to opt the proper way. 

Upon deployment, you can access the language file to download, translate into the preferred language and upload to make it work. The path to access the language file to translate is the following. 

yourdomain.com/resources/lang/en.file.php

 

You will download the file in default English language and will translate it to the language of your choice. Once you done translating the language file, you will need to upload and put this file into the folder specific for the newly translated language. The folder name where you put in the translated file should be the same short identifier/classifier that you provide in “Language Code” field. 

Navigate to Languages 

Admin Main Navigation -> Setup -> Languages 

The page that appears on your screen upon clicking Languages under the Setup will show you a table that consists of the information about all the languages you have added to the system so far. If you are landing on the page for the first time, you may only see a default language. More languages will appear in this table once you add them. 

Add a Language 

Scope of this “Add Language” page covers functionality to add name of the language to appear in the list of available languages, putting forward language code to get the appropriate language file called from the database. Earlier in this article, we already have discussed how different languages work to get the application translated. In the following area, we'll discuss the fields/selections of Add a Language page that appears after clicking "Add a Language" from the top right area of the table (View Languages Table). 

Language  

Name of the language here, i.e. French, Dutch etc. The name that you put in this field will start appearing in the list of available languages under “Select Language” on the top right area of admin as well as the client side of the dashboard. Later, selecting the language from the list will translate the labels, descriptions, help notes and titles into the selected language. 

But make sure you already did the translation work and have uploaded the required version in the language folder, as mentioned above. System not being able to locate the specific file with the translation will load the Default English language.

Language Code  

You need to fill this field with the short language classifier/ identifier that mostly is the combination of two or three letters, like en for English, da for Danish etc.

Also the name of the folder where you put in the file carrying the translation should have the name of the same short code, in order to choose the correct file of translation. Like if you put fr for French language here in this field, the folder where you put the French translation of the language file should also be the fr. See the following path.

Yourdomain.com/resources/lang/fr.file.php  

Saving Details 

Select one of the following options to proceed.

Save & Exit 

Clicking on this option will save the details/preferences, and get you out of the process you were at. Following message will appear on your screen upon saving the contact details successfully.

Record has successfully been saved.

Save & Add Another 

This option will save the current details/preference, and will automatically reopen the same page/process with fresh fields/preferences to continue the process with new entry.

Cancel 

Get out of the process without saving details/preferences.

View Available Languages  

The table that appears on the page after clicking "Languages" under "Setup" from the main navigation has the following columns/rows. 

Serial 

 

Serial number of the records in the table

Language

List of all available languages.  This list doesn’t show that the application has translation of all of these languages, it is just showing the language names that were earlier added using “Add Language” page.

Language Code 

It shows the assigned short identifier/classifier for the respective languages in the list.

Actions 

 

Edit	Click the button to reach “Edit Language” page to update the language name or short identifier language code. But make sure if you update the Language Code, you will also need to update the folder within “Lang”, otherwise system will remain unable to locate the accurate language file translation.
Delete	Click to “Delete”  the Language entry from the list, it just deletes the Language name and language code entry, but it doesn’t delete the Translation file from the “Lang” folder.