Note: This documentation is for Moodle 2.7. For up-to-date documentation see Language FAQ.

Language FAQ: Difference between revisions

From MoodleDocs
(→‎See also: forum discussion link)
(→‎How can I find where a language string is located?: further info thanks to David in https://moodle.org/mod/forum/discuss.php?d=272816)
 
(40 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{stub}}
{{Language}}
==Which is the official language for Moodle?==
The [http://lang.moodle.org/mod/forum/discuss.php?d=2617 "official"] language for Moodle is actually the Australian English (''hey mate!'') , which in 100% the same as UK English.


==Where can I set the default language for the site?==
==Where can I set the default language for the site?==


''Site Administration > Language > [[Language settings]]''
''Site Administration > Language > [[Language settings]]''
==Will installing several language packs decrease my server performance?==
Installing many (20+) language packs have [https://moodle.org/mod/forum/discuss.php?d=241098 almost 0 impact] on Moodle performance.


==How can I change a word or phrase used in Moodle?==
==How can I change a word or phrase used in Moodle?==


#Access ''Administration > Language > [[Language editing]]''.
In ''Administration > Site Administration > Language > Language customization''.
#Click the "Edit words or phrases" link in the middle of the page.
#On the edit words or phrases page click the "Switch lang directory" button and a local language folder, ''parentlanguage_local'', will automatically be created in ''moodledata/lang''. Files of edited strings will then be saved in this folder. This is necessary to prevent changes that you make being overwritten by a newer language pack when updating your Moodle site.
#Choose a file to edit. You may need to search through a few files before finding the file containing the word you wish to change. The file ''moodle.php'' contains all common site-wide phrases.
#Change the word or phrase.
#Click the "Save changes" button. The changed phrase will be highlighted in a different colour.


==I want to help improving a existing language pack. Where do I start?==
See [[Language customization]] for details.
You can contact the maintainer of the language pack and ask where you can help. See [[Translation credits]] for a list of translators. The top name of each language pack is the current language pack maintainer. If you don't get any response, you can email [mailto:translation@moodle.org translation@moodle.org].


==I've found an error in a language pack. Who do I contact?==
==How can I find where a language string is located?==


Please contact the language pack maintainer. See [[Translation credits]] for contact details.
Tick the 'Show origin of languages strings' checkbox in ''Administration > Site administration > Development > Debugging'' then visit the page containing the string you want to customize. Add to the URL of the page <code>?strings=1</code> (or if it doesn't work try <code>&strings=1</code>) then reload the page.
 
==Why are my changes not saved if I edit a language pack with the Moodle language pack editor?==
 
This could be caused by a PHP accelerator. Try switching it off (usually in php.ini).
 
==I've set a default site language but when I log in it switches to English. Why?==
 
By default, Moodle detects a user's language from their browser setting. This language auto-detection may be disabled so that the default site language is used instead in ''Site administration > Language > [[Language settings]]''.
 
==I've set a default site language, but the Moodle calendar is in English. Why?==
 
If your Moodle calendar is not translated, then the string 'locale' (for *nix servers) or the string 'localewin' (for Windows servers) in the 'langconfig.php' file is wrong (or your server is not configured to support the language). There are quite a few languages that are not supported by Windows servers and the localewin server can not be set. In that case, you have to run your Moodle on a *nix server to make the translation of your Moodle calendar work. See [[:dev:Translation_langconfig]] for details.
 
==How can I provide course content in more than one language?==
 
Labels, web pages, activity descriptions etc. may be provided in more than one language using the [[Multi language content|Multi language content filter]].
 
==How can I provide course headings in more than one language?==
 
Set the multi language content filter to apply to content AND headings in ''Administration > Site administration > Plugins > Filters > Manage filters''.
 
==How can I disable (hide) the language dropdown menu on the site front page?==
 
Go to ''Administration > Site administration > Language > Language settings'' and un-tick the 'Display language menu' checkbox.
 
==Are there any short cuts for editing a language?==
Yes, but be careful.  You can make use of the customize language process.  Basically copy the php files that contain the strings you want to change to the moodledata/lang/local folder.  For example, copy the /lang/en/moodle.php file to someplace.  Edit the file with a search and replace with whole word and case sensitive turned on, change Teacher to Instructor and Teachers to Instructors, do the same for teacher and teachers.  Now copy that saved copy of the moodle.php file to the  moodledata/lang/en_local folder.  Be careful not to change the String name.
 
Because it is a customization, Moodle will not erase the xx_local language files in Moodledata with an upgrade.  Moodle will upgrade any language folders it finds in the moodle/lang folder.
 
==Is it possible to customise language strings per theme?==
Not by default, as when strings are customised, they are customised for the whole site. However, it is possible to make a new language  pack based on your main language and apply that pack to the course which has the theme. See this forum post for more information: https://moodle.org/mod/forum/discuss.php?d=220671


== See also ==
== See also ==


* Using Moodle [http://moodle.org/mod/forum/view.php?f=26 Languages forum]
* Using Moodle [http://moodle.org/mod/forum/view.php?f=26 Languages forum]
* [[Language editing]]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=131927#p604462 Edited Strings Not Visible] forum discussion


[[Category:Language]]
Using Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=131927#p604462 Edited Strings Not Visible]
* [http://moodle.org/mod/forum/discuss.php?d=163375 Language customization in 2.0]
 
[[Category:FAQ]]
[[Category:FAQ]]


[[fr:FAQ de langue]]
[[fr:FAQ de langue]]
[[de:Sprache FAQ]]
[[es:Idioma FAQ]]

Latest revision as of 09:35, 17 October 2014

Which is the official language for Moodle?

The "official" language for Moodle is actually the Australian English (hey mate!) , which in 100% the same as UK English.

Where can I set the default language for the site?

Site Administration > Language > Language settings

Will installing several language packs decrease my server performance?

Installing many (20+) language packs have almost 0 impact on Moodle performance.

How can I change a word or phrase used in Moodle?

In Administration > Site Administration > Language > Language customization.

See Language customization for details.

How can I find where a language string is located?

Tick the 'Show origin of languages strings' checkbox in Administration > Site administration > Development > Debugging then visit the page containing the string you want to customize. Add to the URL of the page ?strings=1 (or if it doesn't work try &strings=1) then reload the page.

Why are my changes not saved if I edit a language pack with the Moodle language pack editor?

This could be caused by a PHP accelerator. Try switching it off (usually in php.ini).

I've set a default site language but when I log in it switches to English. Why?

By default, Moodle detects a user's language from their browser setting. This language auto-detection may be disabled so that the default site language is used instead in Site administration > Language > Language settings.

I've set a default site language, but the Moodle calendar is in English. Why?

If your Moodle calendar is not translated, then the string 'locale' (for *nix servers) or the string 'localewin' (for Windows servers) in the 'langconfig.php' file is wrong (or your server is not configured to support the language). There are quite a few languages that are not supported by Windows servers and the localewin server can not be set. In that case, you have to run your Moodle on a *nix server to make the translation of your Moodle calendar work. See dev:Translation_langconfig for details.

How can I provide course content in more than one language?

Labels, web pages, activity descriptions etc. may be provided in more than one language using the Multi language content filter.

How can I provide course headings in more than one language?

Set the multi language content filter to apply to content AND headings in Administration > Site administration > Plugins > Filters > Manage filters.

How can I disable (hide) the language dropdown menu on the site front page?

Go to Administration > Site administration > Language > Language settings and un-tick the 'Display language menu' checkbox.

Are there any short cuts for editing a language?

Yes, but be careful. You can make use of the customize language process. Basically copy the php files that contain the strings you want to change to the moodledata/lang/local folder. For example, copy the /lang/en/moodle.php file to someplace. Edit the file with a search and replace with whole word and case sensitive turned on, change Teacher to Instructor and Teachers to Instructors, do the same for teacher and teachers. Now copy that saved copy of the moodle.php file to the moodledata/lang/en_local folder. Be careful not to change the String name.

Because it is a customization, Moodle will not erase the xx_local language files in Moodledata with an upgrade. Moodle will upgrade any language folders it finds in the moodle/lang folder.

Is it possible to customise language strings per theme?

Not by default, as when strings are customised, they are customised for the whole site. However, it is possible to make a new language pack based on your main language and apply that pack to the course which has the theme. See this forum post for more information: https://moodle.org/mod/forum/discuss.php?d=220671

See also

Using Moodle forum discussions