User Tools

Site Tools


how_to:translate_moosocial

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
how_to:translate_moosocial [2015/09/03 07:06]
mooeditor [Translating Category Name]
how_to:translate_moosocial [2016/06/03 00:17]
Line 1: Line 1:
-====== 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 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 → 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, 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.// 
  
how_to/translate_moosocial.txt · Last modified: 2016/06/03 00:17 (external edit)