This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
how_to:translate_moosocial [2015/06/10 07:18] mooeditor |
how_to:translate_moosocial [2016/01/08 02:43] mooeditor |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Translation ====== | ====== Translation ====== | ||
- | __//**I/Introduction:** //__ | + | __//**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 ISO 639-2 standard. | + | 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. | The msgid must be the english language string. This means it must not be changed. The one that contains the translation is msgstr. | ||
Line 11: | Line 11: | ||
Note: use Poedit from [[http://www.poedit.net/|http://www.poedit.net/]] to easily edit the .po files | Note: use Poedit from [[http://www.poedit.net/|http://www.poedit.net/]] to easily edit the .po files | ||
- | //__**II/How to use Poedit:** __ // | + | ===== I. How to use POEDIT ===== |
- | Open poedit and select //Create new translation//: | + | 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}} | {{:how_to:54f53428c587b9ed3f0288fb665f2188.jpg}} | ||
Line 19: | Line 29: | ||
#Select //Create New Translation// | #Select //Create New Translation// | ||
- | Next, we must select //po // file and open it: | + | Select a //po // file in eng/LC_Messages: |
- | {{:how_to:42a2ac3341a43a9af2d86b5e21f7e4dc.jpg}} | + | {{:how_to:2f0ff632340dc677a6eeebebd3cd0f8b.jpg}} |
- | #1 Select PO Translation files. | + | #1 Select //PO Translation files// filter. |
- | #2 Choose //default.po // located at [mooSocial/app/locale/eng/LC_message/] | + | #2 Choose //default.po // located at [eng/LC_message/]. |
- | The poedit will ask your language for the translation, example, to Vietnamese: | + | The //poedit// will ask your language for the translation, as example, to Vietnamese: |
{{:how_to:ab230b52d12160584523ae0e339fc3dc.jpg}} | {{:how_to:ab230b52d12160584523ae0e339fc3dc.jpg}} | ||
#Select your language. | #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, press save button 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. | ||
+ | |||
+ | 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** | ||