Differences

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

--- how_to:translate_moosocial [2016/06/03 00:17]
+++ how_to:translate_moosocial [2016/06/03 04:17]
mooadmin
@@ 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 [[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**

mooWiki - Everything mooSocial

User Tools

Site Tools

Differences

Page Tools