Language customisation

Changing words or phrases

Words or phrases (in any language) used on the site may be easily changed by an administrator using the language customisation feature. For example, you may want to change the word "Course" to "Unit".

1. Go to Site administration > Language > Language customisation and choose the language you wish to customise.
2. Click the "Open language pack for editing" button. (This may take some time to process.)
3. Once the language pack has loaded, click the "Continue" button.
4. Find the string you wish to customise using the filter settings, then clicking "Show strings". See below for details of how to find the component and string identifier.
5. Make your changes in the "Local customisation" box.
6. Click "Apply changes and continue editing" if you want to use another filter or edit other file(s), otherwise click "Save changes to the language pack" to save all of the changes you have made.

Importing and exporting language customisations

Custom strings may be imported and (with the capability tool/customlang:export) exported from Site administration > Language > Language customisation.

Finding the component and string identifier

• We will use an example where the user wants to replace 'Courses' with 'Assessments' in the Dashboard of Moodle 3.3 Boost theme.

• Go to Site administration > Development > Debugging.
• Tick the 'Show origin of languages strings' tickbox then save changes.
• Go to the page containing the string you want to customise and in the address bar, append the following to the URL: either

  ?strings=1

  or

  &strings=1

  (depending whether there is already a parameter).
• Reload the page.

• The page will then be displayed with component and string identifies in curly brackets after each string, for example "{nocourses/block_myoverview}". The first part, before the /, is the string identifier. The last part is the component e.g. block_myoverview.php. If there is nothing after the / (e.g. "{courses/}" ) then the string is in moodle.php.
• You will then use this information to customize your language strings.

Using the obtained information in order to change the intended strings

1. Go to Site administration > Language > Language customization.
2. Choose the English (en) language pack.
3. Open language pack for editing.
4. Click on the 'Continue' button.
5. Select the moodle.php component (in this particular case)
6. Type courses as the string identifier (in this case)
7. Click on the 'Show strings' button
8. Type your locally customized string, replacing 'Courses' with 'Assessments'.

• After saving the changes into the language pack, you can check that you achieved the intended change:

• Remember to always check that you have only changed the intended strings in the intended places.
• Repeat the procedure with all the strings that you want changed (e.g. course, no courses,...)
• Clear language string caches by going to Site administration > Development > Purge all caches.

Filter settings

Language filter

• Show strings of these components - Click or Ctrl+click to select one or more files.
• Customised only - tick the box to display only those strings that are already present in your xx_local pack.
• Help only' - tick the box to display only help strings, that is the texts used when clicking the yellow question mark icon.
• Modified only - tick the box to display only the strings that are modified since the last checked in string into the language pack.
• Only strings containing - insert a phrase that must appear in the string. For example, if you put a word 'student' here, you will get only those strings that contain this word.
• String identifier - see above.

Local customisation highlighting

• Customised strings (already saved in a file) are highlighted in green.
• Modified strings (not saved in a file yet) are highlighted in blue.
• Customised strings for deletion are highlighted in red.

More about language packs

Moodle is translated into many languages - see Language packs for Moodle 4.3 for their list and the translation completion status. The translations are distributed as language packages (or just lang packs) that are maintained by kind volunteers, community contributors and Moodle Partners.

Moodle site administrators can customise any language pack to fit their individual needs. Editing the language pack files directly is not recommended, since any changes would be silently overwritten during the next upgrade. Instead, you should use the language customisation feature, which automatically creates a local language pack that holds all your changes from the official pack.

Local language packs have the same structure as official ones. They are saved in your Moodle data directory in moodledata/lang/xx_local/ folder where 'xx' is the code of the language. You have to have the official language pack installed before you can customise it. A local language pack should contain just strings you have customised - there is no need to create a copy of a whole official language pack.

When displaying a string, Moodle first looks whether a local customisation exists in moodledata/lang/xx_local/component_file.php. If so, it is used. If not, the string from the official language pack is used. (If the string has not been translated yet, the original English version is displayed). Please note that the strings are cached for better performance so if you modify a file directly in your xx_local pack then you will have to purge Moodle caches afterwards. Caches are purged automatically when using the language customisation feature.

Workflow of the language customisation (click to enlarge)

How to backup and restore a customised language pack

This is handy when you have made customisations of your language pack and you want to install these changes on another server.

If you customised a language pack xx, the only folder you need to back up is $CFG->dataroot/lang/xx_local. All others without the _local suffix are standard packages that can be installed and uninstalled via the admin tool.

Once the folder is restored on another server, you will have to manually purge caches from the admin interface to allow the in-built string manager to re-read the *_local folders and start using them.

Sharing a language customisation

• If you have made a language customisation for a specific need, which is shared by other people (e.g. a kids version of your national language, intended for your school, but also useful for other schools), please consider sharing it as a child language in AMOS.
• If your country uses a language that is not exactly the same as an existing language pack listed in the translation credits, and you have made a customisation that better suits the needs of your fellow country Moodle users, you might want to consider starting a child language pack in AMOS (e.g. Canadian French, which has over 1000 changes from the French parent language).

In either case, contact the parent language pack maintainer listed in the translation credits and/or our translation coordinator, Koen, translation@moodle.org.

Adding formatting

Help strings (with names ending in _help) allow for the use of Markdown for basic formatting (paragraphs and lists).

For all strings, you can add formatting using HTML tags.

Changing the font size and colour of a language string

You can use language customization to change the font size and colour for any (core or additional plugin) Moodle string.

See the following example taken from a Spanish forum user who wanted to have a distinct large red coloured text for the 'Answer the questions...' prompt in the feedback activity:

You could also add an image to a customized language string, as in this forum post.

Moodle Mobile language strings customisation

See Custom language strings in the Moodle Mobile guide for admins.

Language customization of langconfig.php file

Using language customization for parentlanguage inside langconfig.php in an existing Moodle server, where you add a parent language (while the AMOS parentlanguage string is actually empty) will ask for the installation of said parent language in the server, but will not substitute the missing translations in the child language with those of the parent language; English will be shown.

See also

• Duplicate entry 'en-373-AM' forum discussion about error when attempting to edit a lang pack
• Changing one word across the whole site forum discussion

Any questions?

Please post in the Languages forum on moodle.org.