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

User profile fields: Difference between revisions

From MoodleDocs
No edit summary
(rewording, checkbox field in 1.9.3)
Line 2: Line 2:




In Moodle 1.8 onwards, administrators are able to create new user profile categories and fields. Profile fields may be a menu of choices or text input and may be required or not.
In Moodle 1.8 onwards, administrators are able to create new user profile categories and fields. Profile fields may be a menu of choices, text area, text input or a checkbox (in Moodle 1.9.3 onwards) and may be required or not.


New profile fields will appear on each user’s profile page (and on the user sign-up page in Moodle 1.9 onwards).
New profile fields will appear on each user’s profile page (and on the user sign-up page in Moodle 1.9 onwards).
Line 11: Line 11:
'''Important'''
'''Important'''


If the site administrator bulk uploads user data[https://docs.moodle.org/en/Upload_users] via .csv file, it is essential to use the correct convention to represent the new profile field. The convention is profile_field_shortname
If the site administrator bulk [[Upload users|uploads user data]] via .csv file, it is essential to use the correct convention to represent the new profile field. The convention is ''profile_field_shortname''


Replace 'shortname' with the actual short name used for the new profile field eg. dob. So the field should read something like profile_field_dob
Replace 'shortname' with the actual short name used for the new profile field eg. dob. So the field should read something like profile_field_dob


'''Examples of use'''
==Examples of use==


*'''House System'''
*'''House System'''
Line 21: Line 21:
Many schools have a 'House' system where students and staff are assigned to a given House. For example, a school has eight houses, named after its founders: Adderton, Coolock, Gorry, Loretto, McAuley, Mercedes, Tighe and Whitty. The site administrator can add a user profile field that offers a 'Menu of choices' to the user. A default value can also be selected. If the administrator decides to bulk upload House data for users via a .csv file, it is important to represent the above array of values as 1,2,3,4,5,6,7,8 in the file. That is to state, if a user belongs to Adderton House, the value '1' should be entered for the 'House' user profile field in the given record.
Many schools have a 'House' system where students and staff are assigned to a given House. For example, a school has eight houses, named after its founders: Adderton, Coolock, Gorry, Loretto, McAuley, Mercedes, Tighe and Whitty. The site administrator can add a user profile field that offers a 'Menu of choices' to the user. A default value can also be selected. If the administrator decides to bulk upload House data for users via a .csv file, it is important to represent the above array of values as 1,2,3,4,5,6,7,8 in the file. That is to state, if a user belongs to Adderton House, the value '1' should be entered for the 'House' user profile field in the given record.


*'''Birthday Block''' [https://docs.moodle.org/en/Birthday_block]
*[[Birthday block]] (contributed code)
 
 
==See also==
 
*Issue [http://tracker.moodle.org/browse/MDL-9702 MDL-9702] - Custom user profile fields on the signup page


[[Category:Administrator]]
[[Category:Administrator]]


[[fr:Champs du profil]]
[[fr:Champs du profil]]

Revision as of 16:49, 26 September 2008

Template:Moodle 1.8Location: Administration > Users > Accounts > User profile fields


In Moodle 1.8 onwards, administrators are able to create new user profile categories and fields. Profile fields may be a menu of choices, text area, text input or a checkbox (in Moodle 1.9.3 onwards) and may be required or not.

New profile fields will appear on each user’s profile page (and on the user sign-up page in Moodle 1.9 onwards).

For one thing, this means that U.S. users will finally be able to have valid addresses, including *states*, without which an address can be meaningless. (Which state is Springfield in? Oh, 15 of them!)


Important

If the site administrator bulk uploads user data via .csv file, it is essential to use the correct convention to represent the new profile field. The convention is profile_field_shortname

Replace 'shortname' with the actual short name used for the new profile field eg. dob. So the field should read something like profile_field_dob

Examples of use

  • House System

Many schools have a 'House' system where students and staff are assigned to a given House. For example, a school has eight houses, named after its founders: Adderton, Coolock, Gorry, Loretto, McAuley, Mercedes, Tighe and Whitty. The site administrator can add a user profile field that offers a 'Menu of choices' to the user. A default value can also be selected. If the administrator decides to bulk upload House data for users via a .csv file, it is important to represent the above array of values as 1,2,3,4,5,6,7,8 in the file. That is to state, if a user belongs to Adderton House, the value '1' should be entered for the 'House' user profile field in the given record.