Languages

SMSPlus offers its users the ability to run the application as a multilingual platform, where the administrator of the application can use the language file to translate the 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 the 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 the 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 the default English language and will translate it to the language of your choice. Once you are done translating the language file, you will need to upload and put this file into the folder specified 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 the “Language Code” field. 

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 the 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. The 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. The following message will appear on your screen upon saving the contact details successfully.

The 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 a 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 a translation of all of these languages, it is just showing the language names that were earlier added using the “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 the “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 the 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.