User profile fields - Revision history

Tsala: /* See also */

2025-05-01T06:01:34Z

Marycooch: removed gdpr

2024-01-12T11:37:36Z

removed gdpr

← Older revision		Revision as of 11:37, 12 January 2024
Line 57:		Line 57:
	==Translation of custom profile fields==		==Translation of custom profile fields==
	The [[Multi-language content filter]] can be used to provide multilingual field labels to users. Make sure the multi-language content filter is active and applied to content and headings.		The [[Multi-language content filter]] can be used to provide multilingual field labels to users. Make sure the multi-language content filter is active and applied to content and headings.
	~~==GDPR==~~
	GDPR stands for [https://en.wikipedia.org/wiki/General_Data_Protection_Regulation General Data Protection Regulation] and refers to the European Union regulation for data protection for all individuals within the European Union. See [https://docs.moodle.org/dev/GDPR_For_Administrators GDPR For Administrators]
	==See also==		==See also==
	*[[:dev:User profile fields]] developer documentation		*[[:dev:User profile fields]] developer documentation

Marycooch: /* Overview */

2022-02-01T10:20:06Z

Overview

← Older revision		Revision as of 10:20, 1 February 2022
Line 11:		Line 11:
	To create a new profile field, select the profile field format you require from the dropdown list.		To create a new profile field, select the profile field format you require from the dropdown list.

	~~{{New features}}~~		The 'Social' field allows administrators to add back social networks such as Skype ID, MSN / AIM ID which were formerly hard-coded in the user profile if required. If these were already used, they will be retained during the upgraded but converted to these social fields.
	~~New in 3.11: A new~~ 'Social' field allows administrators to add back social networks such as Skype ID, MSN / AIM ID which were formerly hard-coded in the user profile if required. If these were already used, they will be retained during the upgraded but converted to these social fields.
	[[File:socialprofilefield.png\|center]]		[[File:socialprofilefield.png\|center]]

	== Common Settings ==		== Common Settings ==
	All new fields must be given a unique Short Name and a Name (this is displayed on the profile page). You may also choose to enter a Description for the field for your own reference.		All new fields must be given a unique Short Name and a Name (this is displayed on the profile page). You may also choose to enter a Description for the field for your own reference.

Moien: according to moodle 3.11 this issue has 4 options

2022-01-23T09:18:51Z

according to moodle 3.11 this issue has 4 options

← Older revision		Revision as of 09:18, 23 January 2022
Line 1:		Line 1:
	{{Accounts}}		{{Accounts}}
	==Overview==		==Overview==

	Administrators can create new user profile categories and fields in ''Administration > Site administration > Users > Accounts > User profile fields''.		Administrators can create new user profile categories and fields in ''Administration > Site administration > Users > Accounts > User profile fields''.

Line 15:		Line 14:
	New in 3.11: A new 'Social' field allows administrators to add back social networks such as Skype ID, MSN / AIM ID which were formerly hard-coded in the user profile if required. If these were already used, they will be retained during the upgraded but converted to these social fields.		New in 3.11: A new 'Social' field allows administrators to add back social networks such as Skype ID, MSN / AIM ID which were formerly hard-coded in the user profile if required. If these were already used, they will be retained during the upgraded but converted to these social fields.
	[[File:socialprofilefield.png\|center]]		[[File:socialprofilefield.png\|center]]

	== Common Settings ==		== Common Settings ==

	All new fields must be given a unique Short Name and a Name (this is displayed on the profile page). You may also choose to enter a Description for the field for your own reference.		All new fields must be given a unique Short Name and a Name (this is displayed on the profile page). You may also choose to enter a Description for the field for your own reference.

	There are also a number of configuration options common to all custom profile field types:		There are also a number of configuration options common to all custom profile field types:

	;Is this field required?		;Is this field required?
	:This option specifies whether this is a mandatory or optional field for user accounts.		:This option specifies whether this is a mandatory or optional field for user accounts.
Line 35:		Line 31:

	;Who is this field visible to?		;Who is this field visible to?
	:Each custom field can be given one of ~~three~~ visibility settings:		:Each custom field can be given one of '''four''' visibility settings:

	:* Visible to everyone		:* Visible to everyone
	:* Not visible		:* Not visible
	:* Visible to user		:* Visible to user
			:* Visible to user, teachers and admins (moodle 3.11)

	:The Not visible setting would typically be set by an administrator who wants to hold private data on the users. The Visible to user setting would normally be selected for a field that holds sensitive information, while the Visible to everyone setting can be used for any type of information.		:The Not visible setting would typically be set by an administrator who wants to hold private data on the users. The Visible to user setting would normally be selected for a field that holds sensitive information, while the Visible to everyone setting can be used for any type of information.

	== Specific Settings ==		== Specific Settings ==

	There are also a few field type Specific Settings requiring configuration around default value and size.		There are also a few field type Specific Settings requiring configuration around default value and size.

Line 54:		Line 49:

	Also, you will need to visit ''Administration > Site Administration > Users > Accounts > User Profile Fields > Create new Profile Field'' before attempting to upload a file using it. ''Creating an upload file first with custom profile fields'' '''without''' ''creating the User Profile Fields first in Site Administration'' '''will result in the error <u>profile_field_shortname is not a valid field name.</u>'''		Also, you will need to visit ''Administration > Site Administration > Users > Accounts > User Profile Fields > Create new Profile Field'' before attempting to upload a file using it. ''Creating an upload file first with custom profile fields'' '''without''' ''creating the User Profile Fields first in Site Administration'' '''will result in the error <u>profile_field_shortname is not a valid field name.</u>'''

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

	*'''House System'''		*'''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 Adderton, Coolock, Gorry, Loretto, McAuley, Mercedes, Tighe and Whitt in the file. That is to state, if a user belongs to Adderton House, the value 'Adderton' 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 Adderton, Coolock, Gorry, Loretto, McAuley, Mercedes, Tighe and Whitt in the file. That is to state, if a user belongs to Adderton House, the value 'Adderton' should be entered for the 'House' user profile field in the given record.

	*'''U.S. States'''		*'''U.S. States'''
			This can be used to improve ambiguous postal addresses by including (for example) the State.
	This can be used to improve ambiguous postal addresses by including (for example) the State.

	*[[Birthday block]] (contributed code)		*[[Birthday block]] (contributed code)

	==Translation of custom profile fields==		==Translation of custom profile fields==
	The [[Multi-language content filter]] can be used to provide multilingual field labels to users. Make sure the multi-language content filter is active and applied to content and headings.		The [[Multi-language content filter]] can be used to provide multilingual field labels to users. Make sure the multi-language content filter is active and applied to content and headings.

	==GDPR==		==GDPR==
	GDPR stands for [https://en.wikipedia.org/wiki/General_Data_Protection_Regulation General Data Protection Regulation] and refers to the European Union regulation for data protection for all individuals within the European Union. See [https://docs.moodle.org/dev/GDPR_For_Administrators GDPR For Administrators]		GDPR stands for [https://en.wikipedia.org/wiki/General_Data_Protection_Regulation General Data Protection Regulation] and refers to the European Union regulation for data protection for all individuals within the European Union. See [https://docs.moodle.org/dev/GDPR_For_Administrators GDPR For Administrators]

	==See also==		==See also==

	*[[:dev:User profile fields]] developer documentation		*[[:dev:User profile fields]] developer documentation

	[[fr:Champs du profil]]		[[fr:Champs du profil]]
	[[de:Profilfelder]]		[[de:Profilfelder]]
	[[es:Campos del perfil de usuarios]]		[[es:Campos del perfil de usuarios]]

Tim@horizoneducationnetwork.org: clean up, typos fixed: ’s → 's, eg. → e.g.

2021-09-22T16:32:23Z

clean up, typos fixed: ’s → 's, eg. → e.g.

← Older revision		Revision as of 16:32, 22 September 2021
Line 6:		Line 6:
	Profile fields may be a menu of choices, text area, text input or a checkbox and may be required or not.		Profile fields may be a menu of choices, text area, text input or a checkbox and may be required or not.

	New profile fields will appear on each ~~user’s~~ profile page unless "Who is this field visible to?" is set to "Not visible" in which case only the administrator can see the field. The fields can also be displayed on the signup page if "Display on signup page?" is set to "Yes" (although note that they will never be displayed if set to "Not visible").		New profile fields will appear on each user's profile page unless "Who is this field visible to?" is set to "Not visible" in which case only the administrator can see the field. The fields can also be displayed on the signup page if "Display on signup page?" is set to "Yes" (although note that they will never be displayed if set to "Not visible").

	You can set the order in which your custom profile fields appear under the associated profile category using the up/down arrows on the User profiles fields page.		You can set the order in which your custom profile fields appear under the associated profile category using the up/down arrows on the User profiles fields page.
Line 51:		Line 51:
	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''		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 e.g. dob. So the field should read something like profile_field_dob.

	Also, you will need to visit ''Administration > Site Administration > Users > Accounts > User Profile Fields > Create new Profile Field'' before attempting to upload a file using it. ~~<i>~~Creating an upload file first with custom profile fields~~</i> <b>~~without~~</b> <i>~~creating the User Profile Fields first in Site Administration~~</i> <b>~~will result in the error <u>profile_field_shortname is not a valid field name.</u>~~</b>~~		Also, you will need to visit ''Administration > Site Administration > Users > Accounts > User Profile Fields > Create new Profile Field'' before attempting to upload a file using it. ''Creating an upload file first with custom profile fields'' '''without''' ''creating the User Profile Fields first in Site Administration'' '''will result in the error <u>profile_field_shortname is not a valid field name.</u>'''

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

Marycooch: new Social field as per MDL-28452

2021-05-18T15:31:06Z

new Social field as per MDL-28452

← Older revision		Revision as of 15:31, 18 May 2021
Line 11:		Line 11:

	To create a new profile field, select the profile field format you require from the dropdown list.		To create a new profile field, select the profile field format you require from the dropdown list.

			{{New features}}
			New in 3.11: A new 'Social' field allows administrators to add back social networks such as Skype ID, MSN / AIM ID which were formerly hard-coded in the user profile if required. If these were already used, they will be retained during the upgraded but converted to these social fields.
			[[File:socialprofilefield.png\|center]]

	== Common Settings ==		== Common Settings ==

Tsala: /* Translation of custom profile fields */ copying update from 3.3 docs

2018-01-12T07:57:42Z

Translation of custom profile fields: copying update from 3.3 docs

← Older revision		Revision as of 07:57, 12 January 2018
Line 64:		Line 64:

	==Translation of custom profile fields==		==Translation of custom profile fields==
	~~'''Custom profile fields do not support translation''' - they display whatever you type in to all users. It may be possible to use the~~ [[Multi-language content filter]] to ~~embed different languages within~~ the ~~string, but you'd have~~ to ~~experiment to see if that works. See [https://moodle.org/mod/forum/discuss.php?d=354335 this]~~ and ~~[https://moodle.org/mod/forum/discuss.php?d=354158#p1428692 this other] forum threads~~.		The [[Multi-language content filter]] can be used to provide multilingual field labels to users. Make sure the multi-language content filter is active and applied to content and headings.

	==GDPR==		==GDPR==

Marycooch: /* See also */

2017-10-26T09:29:01Z

Germanvaleroelizondo: Added section on ==GDPR==

2017-08-03T18:47:53Z

Added section on ==GDPR==

← Older revision		Revision as of 18:47, 3 August 2017
Line 65:		Line 65:
	==Translation of custom profile fields==		==Translation of custom profile fields==
	'''Custom profile fields do not support translation''' - they display whatever you type in to all users. It may be possible to use the [[Multi-language content filter]] to embed different languages within the string, but you'd have to experiment to see if that works. See [https://moodle.org/mod/forum/discuss.php?d=354335 this] and [https://moodle.org/mod/forum/discuss.php?d=354158#p1428692 this other] forum threads.		'''Custom profile fields do not support translation''' - they display whatever you type in to all users. It may be possible to use the [[Multi-language content filter]] to embed different languages within the string, but you'd have to experiment to see if that works. See [https://moodle.org/mod/forum/discuss.php?d=354335 this] and [https://moodle.org/mod/forum/discuss.php?d=354158#p1428692 this other] forum threads.

			==GDPR==
			GDPR stands for [https://en.wikipedia.org/wiki/General_Data_Protection_Regulation General Data Protection Regulation] and refers to the European Union regulation for data protection for all individuals within the European Union. See [https://docs.moodle.org/dev/GDPR_For_Administrators GDPR For Administrators]

	==See also==		==See also==

Germanvaleroelizondo: Added ==Translation of custom profile fields==

2017-06-22T14:19:54Z

Added ==Translation of custom profile fields==

← Older revision		Revision as of 14:19, 22 June 2017
Line 62:		Line 62:

	*[[Birthday block]] (contributed code)		*[[Birthday block]] (contributed code)

			==Translation of custom profile fields==
			'''Custom profile fields do not support translation''' - they display whatever you type in to all users. It may be possible to use the [[Multi-language content filter]] to embed different languages within the string, but you'd have to experiment to see if that works. See [https://moodle.org/mod/forum/discuss.php?d=354335 this] and [https://moodle.org/mod/forum/discuss.php?d=354158#p1428692 this other] forum threads.

	==See also==		==See also==

← Older revision		Revision as of 06:01, 1 May 2025
Line 57:		Line 57:
	==Translation of custom profile fields==		==Translation of custom profile fields==
	The [[Multi-language content filter]] can be used to provide multilingual field labels to users. Make sure the multi-language content filter is active and applied to content and headings.		The [[Multi-language content filter]] can be used to provide multilingual field labels to users. Make sure the multi-language content filter is active and applied to content and headings.
	~~==See also==~~
	*[[:dev:User profile fields]] developer documentation
	[[fr:Champs du profil]]		[[fr:Champs du profil]]
	[[de:Profilfelder]]		[[de:Profilfelder]]
	[[es:Campos del perfil de usuarios]]		[[es:Campos del perfil de usuarios]]

← Older revision		Revision as of 09:29, 26 October 2017
Line 70:		Line 70:

	==See also==		==See also==
	*[http://youtu.be/5x9etteuayc Custom Profile Fields] MoodleBites video on YouTube
	*[[:dev:User profile fields]] developer documentation		*[[:dev:User profile fields]] developer documentation