mooWiki - Everything mooSocial

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Translation ======

__//**I/Introduction:** // __

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 [[https://www.loc.gov/standards/iso639-2/php/code_list.php|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/|http://www.poedit.net/]] to easily edit the .po files

===== I. How to use POEDIT =====

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)

{{:how_to:68123e3e60d258f99827ed250f0bb687.jpg}}

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

Now we start translating the backup:

Open poedit and select //Create new translation//

{{:how_to:54f53428c587b9ed3f0288fb665f2188.jpg}}

#Select //Create New Translation//

Select a //po // file in eng/LC_Messages:

{{:how_to:2f0ff632340dc677a6eeebebd3cd0f8b.jpg}}

#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:

{{:how_to:ab230b52d12160584523ae0e339fc3dc.jpg}}

#Select your language.

The //poedit// layout explanation:

{{:how_to:4cd36e66101fc111460c63e06e1d6ce8.jpg}}

#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:

{{:how_to:f7da19b85ec9c0a46ae82d6e3c5eb298.jpg}}

#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:

{{:how_to:c5e6640f065c4d8c581dc1be06181f3b.jpg}}

#1 Select text string

#2 Select suggestion

After translation is done, save with '//default.po' // and continue.

{{:how_to:1aad8f8f0298a8ba1ddeb74974729243.jpg}}

#Press //save// button

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

{{:how_to:3198edbc4b0dd0e67043d807af902304.jpg}}

#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

{{:how_to:d952adc2e1e16c37906081bf0b733b45.jpg}}

#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:

{{:how_to:142bbce5ff76ff8577ef47d707044ccd.jpg}}

===== II. How to translate 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.

To use this method, an installed package is required. (Please access this link if you dont know how to install a language package: [[:admin_dashboard:site_manager:languages_manager|https://moosocial.com/wiki/doku.php?id=admin_dashboard:site_manager:languages_manager]])

==== Translating Menu: ====

Taking example, now we go on a try with Home on menu. Let's get to the Menu section in Admin Dashboard/System Admin/Menu.

After pressed on dropdown button to explore Home menu settings, we will see a Translation button below the Navigation Label's field:

{{:how_to:90a9442980c33aceadcac24f70fbdc00.png}}

//#Press on Translation to begin translating the Home menu title.//

Now, the Translation popup is displayed, all you need to do is input your translated content to the language you preferred and press on Save Change to make it effective:

{{:how_to:40b4bf1bd8e4ee7d10df414841a86701.png}}

//#Input your translated content to the preferred language's field, save change to make it effective.//

Let us return to Front-end and see how it's effective, remember to change language to your preferred language.

{{:how_to:7a98fe3a969a4ad59e2dcb0861aaa41e.png}}

//#Change language to your preferred language.//

Now, the content you applied for Home menu is now taken effect from translation:

{{:how_to:f91acf18c6eb174c600bd12b0606f47c.png}}

//#The content is now translated.//
==== Translating Widget: ====

To begin translating a widget, we must go to Layout Editor in Admin Dashboard, which located: Admin Dashboard/Site Manager/Themes Manager/Layout Editor.

With this guideline, we taking an example on Who's Online widget which is at Home page.

Now go to Layout Editor, select Home Page at dropdown and begin editing.

{{:how_to:b164853be52c993f594ac38180b9a2b9.png}}

//#Select Home page to begin editing.//

Next, we find the Who's Online widget, press on it's edit button.

{{:how_to:0b7b22bdfc96c4f63b8b7e6730f9860c.png}}

//#Press on edit button on widget you wanted to begin translating//.

Now the edit pop up displayed, we need to press on Translation to begin translation

{{:how_to:65c1822bd5c1be0decf3ddb4031ada7e.png}}

//#Press on Translation.//

Now, input translated text to your preferred language, then click save change to make it effective.

{{:how_to:ec1acf3cfca9b86eac674074ea0577d4.png}}

//#Input your translated text, and save change to make it effective.//

Now at Front-end, users that using your preferred language will see it translated.

{{:how_to:c8a0eaf0d8099549a8ab220a5e7e3532.png}}

//#The preferred language is now translated the Widget Title.//
==== Translating Category Name ====

This article will show you how to translate a Category Name, taking example on a Video's Category. First of all we must get to the Category Manager from Videos Manager

{{:how_to:62db93764208d75e8161c6125cb07c6c.png}}

//#Go to the Plugin Category's Manager.//

Now select a Category you want to translate.

{{:how_to:e0225e53e674515ac5373bd8fbbf3808.png}}

//#Select a Category to begin translating.//

When the pop up displayed, find the Translation button, its located below Category Name's field.

{{:how_to:fca46bdefd57269e9cfb2b63a5c2c73c.png}}

//#Press on Translation button when popup displayed.//

Now, just like the others, we will have to input translated text to the preferred language, press on Save Change to make it effective.

{{:how_to:4750f7a76be3faaec3eb376346f24a13.png}}

//#Input your translated text and Save Change.//

Now let's see how the Front-end being effected.

{{:how_to:da245be8d9293a6b92606388bc992691.png}}

//#User will see 'Movies' Category translated to 'Filming'.//

{{:how_to:178c48778d60dabfddeaba4e53831bef.png}}

//#The Category has been translated.//

----

**END**