Prev 4.7. User Management Next

4.7.4. User Registration Fields

The "User Fields" Management allows you to freely modify the fields displayed on registration and account maintenance. Such fields are for example: First Name, Last Name, Telephone,...

The User Field Management can be accessed via "Admin" ⇒ "Manage User Fields".

VirtueMart Administration: Manage User Fields

Figure 4.63. VirtueMart Administration: Manage User Fields


You can add a new field by clicking the "New" button on the toolbar in the User Field List. The Field Form allows you to choose from various field types like

Text Input Field
Textarea
Checkbox
Date
drop down
email

Tip

Some other Field Types will be visible depending on what other Components you have installed on your Joomla!/Mambo:

Newsletter Registration

You can let your new Customers be automatically be subscribed to a Newsletter. The following Components are supported: Letterman.

Captcha Field

Obviously not a good idea if you don't want to bug new Customers, but sometimes necessary to prevent Registration Spam. You can add a Captcha Check to the Registration Form if the SecurityImages Component is installed on your Site.

In our example we will add a new field where users from the EU can fill in the EU VAT ID of their company if applicable.


The Form Fields have the following meaning:

Type

The type of this field. Can't be changed afterwards!

Table Field Name

The name of the column that will be inserted into the table structure of the tables "jos_vm_user_info" and "jos_vm_order_user_info" in your database.

Title

This is the Label of the Field in the Registration / Account Maintenance Form

Description

This description will be shown to the customer in the frontend in a small tooltip besides the field to explain the field.

Required?

If this is set to yes, a value must be provided or chosen, otherwise registration will not be possible.

Show on Account?

This defines wether the field is shown in the account maintenance form or not.

User Read Only?

If this is set to yes, the field is read-only and can't be changed by the customer.

Show at Registration?

If this is set to yes, the field will be shown in the registration form.

Published

Here you can unpublish the field completely, so it won't be shown in any form.

Size

This defines the length of text input fields.

Max Length

This is the maximum number of characters that can be filled into the text field.

Move the customer into the following Shopper Group...

Here you can select into which shopper group the newly registered customer is moved when the EU VAT ID has been succesfully validated.

If you are finished filling in the necessary values, don't forget to Save your changes.

Here is a screenshot of the newly added field "EU Vat ID" in the registration form:


Fields can be reordered, renamed, published, set to be required or not and much more.

Reordering Fields

Fields can be reordered using the blue arrows in the user field list or using the text input fields in each row of the list:


If you have used the input fields to change the ordering of the fields, you must apply your changes by clicking the Save Icon in the top of this column. After that the fields will be reordered.

Publish (show)/Unpublish (hide) Fields

You can publish and unpublish fields by clicking on the icon in the column "Published". After that the publish state will be toggled.

Changing Fields

You can access the field form by clicking a field name in the User Field List. In this form you can modify all settings except the field type.


You can delete all non-system fields from the User Field List. You just need to click on the Trash Bin icon at the end of the row of the item you want to remove. You can also select the checkboxes of the fields which you want to delete and then click the "Remove" button in the toolbar.