This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
how_to:translate_moosocial [2015/09/03 03:40] mooeditor [II. How to translate Menu or Widget using Admin Dashboard] |
how_to:translate_moosocial [2016/06/03 00:17] (current) |
||
---|---|---|---|
Line 3: | Line 3: | ||
__//**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. | ||
- | To install the new language after uploading the language folder to Locale folder, go to Admin Panel → 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. | + | 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 | Note: use Poedit from [[http://www.poedit.net/|http://www.poedit.net/]] to easily edit the .po files | ||
Line 13: | Line 13: | ||
===== I. How to use POEDIT ===== | ===== I. How to use POEDIT ===== | ||
- | POEDIT is used for translating static data (ex: notifications, messages, error messages...etc) | + | 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) | 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) | ||
Line 75: | Line 75: | ||
#2 Select suggestion | #2 Select suggestion | ||
- | After translation is done, press save button and continue. | + | After translation is done, save with '//default.po' // and continue. |
{{:how_to:1aad8f8f0298a8ba1ddeb74974729243.jpg}} | {{:how_to:1aad8f8f0298a8ba1ddeb74974729243.jpg}} | ||
Line 103: | Line 103: | ||
===== II. How to translate Menu or Widget using Admin Dashboard ===== | ===== II. How to translate Menu or Widget using Admin Dashboard ===== | ||
- | In this section, we will show you how to Translate Menu's title or Widgets, which are dynamic data by 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]]) | 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: ==== | ==== 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** | ||