• Documentation
  InstallationUsing the Kentico interfaceDeveloping websitesConfiguring KenticoManaging usersSecuring websitesDeploying websitesManaging website contentMultilingual websitesMacro expressionsExternal utilitiesIntegrating 3rd party systemsCustom developmentE-commerce featuresOn-line marketing featuresCommunity featuresRunning Kentico on Microsoft AzureUsing Amazon web services with KenticoCertified extensionsReferencesRelease notes - Kentico 11
• Tutorial
  Getting started with KenticoUsing the Kentico interfaceSite development overviewPortal Engine developmentMVC development
• API Examples
  Content managementOn-line marketingE-commerceSocial and CommunityDevelopmentConfiguration

Using the Custom registration form web part

Use the Custom registration form for situations where you want a different registration form than the one provided by the Registration form web part. For example when you want users to provide different information during registration or if you wish to customize the form's layout.

The following example demonstrates how to add a custom registration form to your site. You need to prepare the custom registration form as an alternative form for user objects.

Creating an alternative form for the User system object

1. Open the Modules application.
2. Edit () the Membership module.
3. Open the Classes tab.
4. Edit () the User (cms.user) class.
5. Switch to the Alternative forms tab.
6. Click Create new form above the list.
7. Fill in the following details:
   • Display name: My registration form
   • Make new fields hidden: yes (checked) - ensures that the alternative does not display new fields added to the object by default.
   • Combine with user settings: yes (checked) - ensures that the form contains all data fields related to users, including user settings.
8. Click Save.

The system creates the alternative form and opens the form's editing interface.

Defining the form fields and layout

1. Switch to the Fields tab of the alternative form's editing interface.

   • Here you can see the fields (database columns) that the system stores for User objects.

2. Select the UserName field in the list on the left, and select the Display field in the editing form check box.

3. Click Save to confirm the change.

4. Repeat the same for the following fields:

   • FirstName
   • Email
   • UserPassword

5. For the UserPassword field, choose the Password with confirmation option in the Form control selector.

6. Go through the remaining fields and uncheck Display field in the editing form.

Adjusting the form layout

To define the registration form's layout:

1. Switch to the Layout tab of the alternative form editing interface.
2. Select Use custom form layout.
3. Click Generate default layout. A default table layout appears in the editor. You can adjust the layout according to your requirements.
4. Click Save when you are finished.

Placing the form on a page

1. Open the Pages application.
2. Select or create a page where you want to add the registration form in the content tree.
3. Switch to the Design tab.
4. Add the Custom registration form web part onto the page.
5. Select My registration form (cms.user.MyRegistrationForm) as the value of the web part's Alternative form property.

If you switch to the live site and view the page, you can see the custom registration form that you created. You can now try to register using the form and verify that the user has been created in Configuration -> Users.