Install new language

Two ways to create a new language into your site:

+ Installed existing language

Admin panel -> site manager -> languages manager -> Not installed language tab -> Click on “Install” button to install your desired languages. If the languages that you want to install is not inside the list, please contact us for support

+ Create a new language

Admin panel -> site manager -> languages manager ->  Click on “Create New language” button to create a new language

Translate the phrases that have not be translated to your language yet
If the the language that you just installed or created is not fully translated, you need to translate more by yourself. Please follow the below steps to do that.

Admincp -> Site manager > Language Manager

# Click Translate icon (see below screenshot)

# Search phrases you want to translate or change

# Select one result from the list and translate or change it to new phrase

# Save and clear global cache and browser cache to check again

Translate for Menu or Widget using Admin Dashboard

In this section, we will show you how to Translate Menu’s title, Widgets Title, Categories of the plugin to other languages.
Translate Menu

If your language is RTL, please follow the below steps to enable it.

1. Login as Administrator

2. Go to language manager

3. Click on a language to edit, check option “RTL” and save changes.

Clear browser and global cache to test again.

1. Manage Mailing Template

You can configure Mails content that will send to users. There are many templates of emails for cases or roles.

#Mail templates manager layout.

Let’s take a look at the Templates list:

#Templates.

Now we take example on Welcome Mail:

First, select Welcome at Choose Email field to config, this email template is used for sending to new Members signed up.

#1: Select Language for the template.

#2: Emails Templates.

#3: Description of the template.

#4: Subject of the Email Template.

#5: Message to users.

#6 Save Changes button.

*In #5: Message to users, [header] and [footer] are email templates, they will display in your emails sent to users, you can config them by selecting Choose Emails field.

2. Translate email

Goto System Admin >> Mails

In Manager Mail Template tab,

Choose Por in language pack (example we choose Por language), if not have Por language yet, please see to install new language https://moosocial.com/knowledge-base/how-to-install-new-language/

there are many template emails in Choose email

We choose each of them and translate into Por language at Subject and Message body

Example Header template, we translate as bellow

Click Save change to save email template.

Now, example we translate email template Friend Request to Por language,

After change translate we have bellow

Click Save Changes  to save template email.

Goto System Admin >> System Settings >> Genneral

Select Por at Default Language and click Save settings.

At front end, we change language to Por language

Now the site translate into Por language.

When a user A ask friend request with other user B, user B will receive email in Por language.

 

POEDIT is used for translating static data (ex: notifications, messages, error messages…etc)

Find our language package, located at [mooSocial/app/Locale/], look for a folder eng, this is English default language, copy this folder and paste into location you preferred (backup)

 

#eng folder contains English language, copy & paste to your preferred location.

Now we start translating the backup:

Open poedit and select Create new translation

#Select Create New Translation

Select a po file in eng/LC_Messages:

#1 Select PO Translation files filter.

#2 Choose default.po located at [eng/LC_message/].

The poedit will ask your language for the translation, as example, to Vietnamese:

#Select your language.

The poedit layout explanation:

#1 The original text strings

#2 Translation strings

#3 Suggestion for translation (dictionary)

#4 Source text

#5 Translation

There are 2 ways to translate:

First, we can translate text string manually, click on the text string you want to translate and input your language to Translation text box:

#1 Select string you want to translate

#2 Input your translation

Second, the suggestion for translation, click on the text string you want to translate, then select any of suggestion:

#1 Select text string

#2 Select suggestion

After translation is done, save with ‘default.po’ and continue.

#Press save button

Now change your language package folder’s name, within 3 letters, ex: vie (Vietnamese), copy this folder into [yourmooSocial/app/Locale/]

#Change your translated language folder’s name and copy & paste into [yourmooSocial/app/Locale]

Open Admin Dashboard and go to Site Manager/Languages Manager/Not Installed Languages.

Now press on the install button

#Press on Install button to start installing new language.

Wait for the install process is completed.

After successfully installed, users can change to new language:

 

There are three methods for translate mooSocial

– Direct translate

– Download language package and translate

– Use plugin (you have to pay a cost)

I. Direct translate

It is very easy to translate mooSocial to your language. The default language file can be located at app/Locale/eng/LC_MESSAGES/default.po. If you want to translate mooSocial to a language that is not already in the Locale folder, you can copy the default language folder to a new folder (e.g. fra) and start translating the new language file using your favorite text editor (use UTF-8 to avoid problems). The language folder name must conform to the ISO 639-2 standard.

The msgid must be the english language string. This means it must not be changed. The one that contains the translation is msgstr.

To install the new language after uploading the language folder to Locale folder, go to Admin Panel → Site Manager → Languages Manager → Not Installed Languages then click Install. It is necessary to clear Global Cache when using a new Language by going to Admin Dashboard → Clear Global Cache.

Note: use Poedit from http://www.poedit.net/ to easily edit the .po files, you can use poedit to translate mooSocial here https://moosocial.com/knowledge-base/how-to-use-poedit/

II. Download language package and translate

You can download language packages for mooSocial  for free at https://moosocial.oneskyapp.com/collaboration/ then follow the below instructions to install them into your mooSocial site.

The language packages will send by email to you.

Extract the download file, you will see the following folders: cake.po, default.po, mail.po, permission.po and setting.po.

Create a new folder for your language pack. Such as For French, you should name the folder as “fra” at [yourmoofolder\app\Locale],

for other languages, please refer here to know how to name the folder https://community.moosocial.com/topics/view/1314/codes-for-the-representation-of-names-of-languages .

Create a sub folder name “LC_MESSAGES” inside “fra” folder.

Open cake.po folder, rename the file inside this folder to cake.po, open default.po and rename the find inside this folder to default.po….do the same for all above folders. After all files have been renamed, please copy all files into the “LC_MESSAGES” folder that you create above. Now, you have a language pack for French language and it’s ready for install.

Go to Admin Dashboard >>> Site Manager >>> Languages Manager.

Choose tab Not install Languagues  and find the uninstall language (fra language) click install.

Go to Admin Dashboard >>> Clear Global Caches

At the front end, we click to English to choose Fra language to translate

III. Use pluging

Translate Tool plugin helps to easily translate mooSocial to your desired  language directly in admin panel instead of editing po file in web folder. It also helps to translate content entered by members such as status updates, comments, blogs, topics…into your current selected language using Google Translate Service.

Main features:

+ Translate content entered by members such as status updates, comments, blogs, topics…into your current selected language using Google Translate Service.
+ Translate all labels in mooSoical into your languages directly in admin panel instead of editing po file in web folder.

Admin features:

+ Enable Translation
+ Enable Feeds Translation
+ Enable Comments Translation
+ Enable Blogs Translation
+ Manage all language phrases and allow you to translate all phrases in po file to  your languages directly in admin panel.

Importance: Google Translate Service is required.

Video guide

Translate language for Menu or Widget using Admin Dashboard

In this section, we will show you how to Translate Menu’s title, Widgets Title, Category Name, which are dynamic data by using Admin Dashboard.

Translate Menu