The Single-Selection Menu form allows you to add a custom single-selection menu field to the User Profile form.
Note:
You must click Save for changes to take effect.
- Title
The name of your Single-Selection Menu field. - Description
This is the description of the field as shown to your users. You should describe here what the field is intended for, and if it is required field or not, and/or if it is private from other users or not. - Profile Field Category
It is possible to group custom user profile fields into categories so that they can be logically grouped. The primary purpose of doing this is to allow different categories to be shown in different tabs or blocks on a user's profile page (in addition to being shown in the 'About Me' tab). See the User Profile Field Categories article for more information. - Options
In this box, put each value that should appear as a menu item. Make sure to separate each option with a new line carriage return ("Enter" key). - Set Default Default: Yes, Including a First Blank Item
- None
The selected option will be a blank field. If you require this field, this will force the user to make a choice. - Yes, Including a First Blank Option
This sets the first option above as selected but also creates a blank option allowing the user to choose nothing if this field isn't required. - Yes, but No First Blank Option
This also sets the first option above as selected but doesn't allow the user to choose a nothing since their is no empty option to choose from.
- None
- Display Order
This sets the order in which fields are displayed. The default is to add it to the end of your current fields. Display order starts at 1 and can be any whole positive number (don't use decimals or fractions). - Field Required Default: No
- Yes, at registration and profile updating
User will be required to complete this field at registration and when updating their profile. - Yes, always
User will be required to complete this field at registration. Enabling this setting will force all users to complete it before they can continue using your forum. This applies only if the field is shown on the "Edit Your Details" page. - No
Completion of this field is optional. - No, but display at registration
Completion of this field is optional but it will appear at registration.
- Yes, at registration and profile updating
- Field Editable by User Default: Yes
- Yes
User may edit this field at any time. - No
User may never edit this field. - Only at registration
User may only edit this field at registration or if it is set to be required and it is blank.
- Yes
- Private Field Default: No
If this is set to Yes, this field can be filled in by the user but will only be viewable to those with the proper usergroup permission. - Field Searchable on Members List Default: Yes
If this is set to No, users will not be able to search using this field on the Member's List Advanced Search. - Show on Members List Default: Yes
If this is set to Yes, this field will be displayed on the Member's List for each user.
<<<Screenshot of Optional Input section>>>
- Allow user to input their own value for this option Default: No
If this is set to Yes, the user will be allowed to fill in a text input field as an alternative to the options you have given for this field. - Max length of allowed user input Default: 100
The maximum number of characters that the member will be allowed to input. - Field Length Default: 25
The width of the input box in characters. - Regular Expression
You may require this field's contents to match a PCRE-type regular expression. For example, you could have a field that is for the user's ICQ number. Since ICQ numbers consist of only numerals, you could write a regular expression to check for non-numerals.
Example:If you want to allow an empty response to be given, you need to account for it within the regex:^[0-9]{7,8}$
See PHP.net for more information on regular expressions.^[0-9]{7,8}$|^$
- Which page displays this option? Default: Edit Profile
This controls what page the profile field is displayed on. Most likely you want to leave this on "Edit Profile" but if you wish to create your own user options that can be manipulated via template conditionals then select "Options". This field will then appear on the "Options" page of the User CP. Also, this field will not appear when viewing a user's profile.