Note: You are currently viewing documentation for Moodle 3.9. Up-to-date documentation for the latest stable version of Moodle may be available here: Additional name fields.

Additional name fields: Difference between revisions

From MoodleDocs
(accounts template)
(rewording)
Line 1: Line 1:
{{Accounts}}
{{Accounts}}
{{New features}}
==Additional names profile fields==
 
{{New features}}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:


Moodle 2.6 now has four additional name fields. These fields allow for further detail to be displayed about the user. The additional name fields are:
* First name - phonetic
* First name - phonetic
* Surname - phonetic
* Surname - phonetic
Line 8: Line 9:
* Alternate name
* Alternate name


[[File:26names.png]]
==Administration settings==


==Display==
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 display of the user's full name is determined by the capability *Add capability here*
The following placeholders are available:
 
[[File:participants-after.png]]
 
==Configuration==
 
Configuration of the additional name fields is done in the following Administration page [Administration Site administration Users Permissions User policies].
The setting to change is "Full name format" (fullnamedisplay).
This setting uses the following placeholders:
* firstname
* firstname
* lastname
* lastname
Line 27: Line 20:
* middlename
* middlename
* alternatename
* alternatename
* language (used on its own to force the use of the language pack)
* language (used on its own so that the language pack determines how user names are displayed)
By default it has the place-holder "language" and it will use the local language pack to determine how user names are displayed. (location: /lang/en/moodle.php - fullnamedisplay)


To enable the additional name fields, just enter in the placeholders into the text box. The order that you enter in the names will be the order that they are displayed around Moodle.
[[File:26names.png]]


===Example 1===
===Example 1===
Line 66: Line 58:


<blockquote>Doe John (Dough Jon)</blockquote>
<blockquote>Doe John (Dough Jon)</blockquote>
==Display==
The display of the user's full name is determined by the capability *Add capability here*
[[File:participants-after.png]]


==Updating the user's profile==
==Updating the user's profile==

Revision as of 22:05, 6 November 2013

Additional names profile fields

New feature
in Moodle 3.9!
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.