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

Additional name fields: Difference between revisions

From MoodleDocs
No edit summary
(rewrite, screenshots)
Line 1: Line 1:
{{Accounts}}
{{Accounts}}
==Additional names profile fields==
{{New features}}In Moodle 2.6 onwards, as well as first name and surname, the following additional name fields may be used:
 
{{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:


* First name - phonetic
* First name - phonetic
Line 8: Line 6:
* Middle name
* Middle name
* Alternate name
* Alternate name
[[File:26names.png]]


==Administration settings==
==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''.
[[File:participants-after.png|thumb|List of users with full names displayed]]
.
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 default setting is ''language'', which means that names are displayed according to information from the language pack used on the site. Alternatively, the following placeholders may be used:
The following placeholders are available:
 
* firstname
* firstname
* lastname
* lastname
Line 20: Line 20:
* middlename
* middlename
* alternatename
* alternatename
* language (used on its own so that the language pack determines how user names are displayed)


[[File:26names.png]]
For example, a user with first name John, surname Doe, middle name James, first name phonetic Jon, and surname phonetic Dough will have their name displayed as


===Example 1===
*John James Doe when 'Full name format' is set to ''firstname middlename lastname'' and
{| class="wikitable"
*Doe John (Dough Jon) when 'Full name format' is set to ''lastname firstname (lastnamephonetic firstnamephonetic)''
!First name  
!Surname
!Middle name
!Surname - phonetic
!First name - phonetic
|-
|John
|Doe
|James
|Dough
|Jon
|}


'''Full name format setting'''
Users with the [[Capabilities/moodle/site:viewfullnames|View full names capability]] (by default users with the role of manager, teacher or non-editing teacher) can always see first and last names, regardless of the "Full name format" setting.


<blockquote>firstname middlename lastname</blockquote>
Note for sites upgrading from an earlier version: The 'Full name format' setting was previously in ''Site policies''.


will display:
==User profile settings==


<blockquote>John James Doe</blockquote>
Users can enter additional names by editing their profile in ''Administration > My profile settings > Edit profile''.


Other characters can be included in the setting such as commas and parenthesis.
First name, surname and any additional names specified by an administrator in 'Full name format' are listed in the General section. Additional names not specified in 'Full name format' are listed in an "Additional names' section.


===Example 2===
{|
 
| [[File:name fields in general section.png|thumb|Name fields as specified in 'Full name format']]
'''Full name format setting'''
| [[File:additional name fields.png|thumb|Additional name fields]]
 
|}
<blockquote>lastname firstname (lastnamephonetic firstnamephonetic)</blockquote>
 
will display:
 
<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==
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.


[[es:Nombres de campo adicionales]]
[[es:Nombres de campo adicionales]]
[[de:Zusätzliche Namen]]
[[de:Zusätzliche Namen]]

Revision as of 10:54, 7 November 2013

New feature
in Moodle 3.6!
In Moodle 2.6 onwards, as well as first name and surname, the following additional name fields may be used:

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

File:26names.png

Administration settings

List of users with full names displayed

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 default setting is language, which means that names are displayed according to information from the language pack used on the site. Alternatively, the following placeholders may be used:

  • firstname
  • lastname
  • firstnamephonetic
  • lastnamephonetic
  • middlename
  • alternatename

For example, a user with first name John, surname Doe, middle name James, first name phonetic Jon, and surname phonetic Dough will have their name displayed as

  • John James Doe when 'Full name format' is set to firstname middlename lastname and
  • Doe John (Dough Jon) when 'Full name format' is set to lastname firstname (lastnamephonetic firstnamephonetic)

Users with the View full names capability (by default users with the role of manager, teacher or non-editing teacher) can always see first and last names, regardless of the "Full name format" setting.

Note for sites upgrading from an earlier version: The 'Full name format' setting was previously in Site policies.

User profile settings

Users can enter additional names by editing their profile in Administration > My profile settings > Edit profile.

First name, surname and any additional names specified by an administrator in 'Full name format' are listed in the General section. Additional names not specified in 'Full name format' are listed in an "Additional names' section.

Name fields as specified in 'Full name format'
Additional name fields