Note: You are currently viewing documentation for Moodle 2.2. Up-to-date documentation for the latest stable version is available here: Language editing.
Local language pack
Sometimes, you may wish to change the default terms or language strings used in Moodle. For example, you may wish to replace all occurences of "course" with "class." To ensure that any changes are not overwritten by a new version when upgrading, you need to create your own local language pack as follows:
- Copy the langconfig.php of your language folder (e.g. moodledata/lang/parentlanguage_utf8 or lang/en_utf8) into a new folder (e.g. moodledata/lang/parentlanguage_utf8_local). You will need access to the server to achieve this step - it cannot be done from within Moodle.
- Add a string for parentlanguage to this file, which points to the language which is the most similar to yours (e.g. $string[parentlanguage] = parentlanguage_utf8;).
- Edit only those strings you want to change with the built-in language editor, to be found in Administration >> Configuration >> Language. (currently this does not work with the en_utf8 language pack, see bug #5745)
The hierarchy of language packs can support up to three levels, the parent language, a sitewide local language pack, and a course level language pack. Moodle will first look for a string in the course level language pack, and if it does not find it, it will use the sitewide language pack, and then use the parent language string by default.
If you are having trouble figuring out where a particular string you wish to change is located, you will need to perform a search for it. An easy way to do this is to use a program like AM Code Search which allows you to search for strings inside php files, unlike the Windows search.
Local language pack
To ensure that any changes are not overwritten by a new version when upgrading, you need to create your own local language pack as follows:
- Copy the contents of your language folder (e.g. lang/en) into a new folder (e.g. lang/en_local) - you will need access to the server to achieve this step, it cannot be done from within Moodle.
- Make your local language pack the default for the site via Administration >> Configuration >> Variables.