Note: This documentation is for Moodle 2.7. For up-to-date documentation see Additional name fields.

Additional name fields

From MoodleDocs
Revision as of 10:00, 7 November 2013 by Gisela Hillenbrand (talk | contribs)

Additional names profile fields

New feature
in Moodle 2.7!
In Moodle 2.6 onwards, the edit profile page (Administration > My profile settings > Edit profile), includes a new section - Additional names - with the following fields:

  • First name - phonetic
  • Surname - phonetic
  • Middle name
  • Alternate name

Administration settings

An administrator can set how names are displayed across the site via the setting "Full name format" (fullnamedisplay) in Administration > Site administration > Users > Permissions > User policies. . The following placeholders are available:

  • firstname
  • lastname
  • firstnamephonetic
  • lastnamephonetic
  • middlename
  • alternatename
  • language (used on its own so that the language pack determines how user names are displayed)

File:26names.png

Example 1

First name Surname Middle name Surname - phonetic First name - phonetic
John Doe James Dough Jon

Full name format setting

firstname middlename lastname

will display:

John James Doe

Other characters can be included in the setting such as commas and parenthesis.

Example 2

Full name format setting

lastname firstname (lastnamephonetic firstnamephonetic)

will display:

Doe John (Dough Jon)

Display

The display of the user's full name is determined by the capability *Add capability here*

participants-after.png


Updating the user's profile

Any additional names that are included in the "Full name format" setting will be displayed directly under the text boxes for first name and surname. All other name fields that are not being used are located under the section "Additional names" further down the page.

Upgrade from previous versions

When upgrading to 2.6, the "Full name format" (fullnamedisplay) setting found in [Administration ► Site administration ► Security ► Site policies] will automatically be changed over. All of the additional name fields will be blank.