Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Language editing.

Language editing: Difference between revisions

From MoodleDocs
(edit words or phrases, image added)
(→‎Edit words or phrases: steps to edit a word or phrase)
Line 7: Line 7:
== Edit words or phrases ==
== Edit words or phrases ==
[[Image:edit words or phrases.png|thumb|Edit words or phrases in Moodle 1.8]]
[[Image:edit words or phrases.png|thumb|Edit words or phrases in Moodle 1.8]]
From Moodle 1.6 onwards, text may be changed by editing the language strings, either via ''Administration > Language > Language editing'' or directly i.e. in ''moodledata/lang/''.
From Moodle 1.6 onwards, text may be changed by editing language strings, either via ''Administration > Language > Language editing'' or directly i.e. in ''moodledata/lang/''.


* Click the button "switch" 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 will prevent your local changes to be overwritten by a newer language pack while updating.
To edit a word or phrase:
* When returning to edit further strings, check that files of edited strings will again be saved to the folder ''parentlanguage_local'', switching folder if necessary.
#Access ''Administration > Language > Language editing''.
#Click the "Edit words or phrases" link in the middle of the page.
#On the edit words or phases 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 to be overwritten by a newer language pack when updating.
#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.
 
If you wish to make further changes later, be sure to check that files of edited strings will again be saved to the folder ''parentlanguage_local'', switching folder if necessary.


Note: From Moodle 1.9 onwards, the option to switch is no longer provided and edited strings are automatically saved in the local language folder.
Note: From Moodle 1.9 onwards, the option to switch is no longer provided and edited strings are automatically saved in the local language folder.

Revision as of 08:54, 5 October 2007

Location: Administration > Language > Language editing


Language editing in Moodle 1.6

The language editing interface enables you to easily change any word or phrase used on the site. For example, you may want to change the word "Course" to "Area".


Edit words or phrases

File:edit words or phrases.png
Edit words or phrases in Moodle 1.8

From Moodle 1.6 onwards, text may be changed by editing language strings, either via Administration > Language > Language editing or directly i.e. in moodledata/lang/.

To edit a word or phrase:

  1. Access Administration > Language > Language editing.
  2. Click the "Edit words or phrases" link in the middle of the page.
  3. On the edit words or phases 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 to be overwritten by a newer language pack when updating.
  4. 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.
  5. Change the word or phrase.
  6. Click the "Save changes" button. The changed phrase will be highlighted in a different colour.

If you wish to make further changes later, be sure to check that files of edited strings will again be saved to the folder parentlanguage_local, switching folder if necessary.

Note: From Moodle 1.9 onwards, the option to switch is no longer provided and edited strings are automatically saved in the local language folder.

Changes in 1.9

Template:Moodle 1.9* From Moodle 1.9 onwards, only users with the capability moodle/site:langeditmaster may modify the master language packages (i.e. those being saved in moodledata/lang/). It is prevented from all roles by default. It is expected that only language maintainers will manually allow this to themselves.

  • From Moodle 1.9 onwards, only users with the capability moodle/site:langeditlocal may customize the site translation (i.e. files being saved in moodledata/lang_local/). Admins are allowed to do this by default.
  • TODO: Ability to edit language files in non-standard locations, i.e. string files for various types of plugin (e.g. blocks, database presets, 3rd party modules etc.)
  • Several GUI improvements including tabs
Moodle 1.9 admin/lang.php interface

Previous admin/lang

Text in Moodle 1.5 may be changed by editing the language strings, either via Administration > Configuration > Language or directly e.g. in lang/en.

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.

See also