The Multiple-Line Text Box form allows you to add a custom multiple line text box field to the User Profile form.
Note:
You must click Save for changes to take effect.
- Title
The name of your Multiple-Line Text Box 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. - Default Value
If the member doesn't change this field, then this will be the value stored in their profile. - 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. - Text Area Height Default: 4
This is how many rows high the input should be on the forms. It is recommend that you set this to at least 2. - 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. - 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.
Note:
Multiple-Line Text box fields can not be listed on the Members List.