Kentico CMS 7.0 Developer's Guide

Creating a custom registration form

Creating a custom registration form

Previous topic Next topic Mail us feedback on this topic!  

Creating a custom registration form

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

The Custom registration form web part can be used in situations when you want to use a different registration form than the default one provided by the Registration form web part. This is typically when you want users to provide different details or when you want to customize the form's layout.


In the following example, you will learn how to use a custom registration form on your site. You will create an alternative form and use it for registration via the Custom registration form web part. If you are not familiar with the Alternative forms concept, please refer to the Alternative forms chapter first.


1. Go to Site Manager -> Development -> System tables and choose to Edit (Edit) the User system table.




2. Switch to the Alternative forms tab and click the Add_UIElement Create new form button above the list.




3. Fill in the following details:


Display name: My registration form

Code name: MyRegistrationForm

Make new fields hidden: checked; this ensures that new fields added to the system table are not displayed in the alternative form by default.

Combine with user settings: checked; this ensures that all default user fields will be available.


Click Save Save.




4. Your new form is now created and you are redirected to the editing interface of it. Switch to the Fields tab.


On this tab, you can see the fields (columns) defined in the User system table. You can select a field from the list on the left. In the right part, you can modify its properties. We will want our registration form to contain the following fields:







Go through the attributes and check the Display attribute in the editing form check-box for those mentioned above, which will make them visible on our registration form. Click Save Save to confirm the changes for every field. Uncheck the check-box for the remaining fields. For the UserPassword field, also choose the Password with confirmation option in the Form control drop-down.




5. You can also switch to the Layout tab and define the registration form's layout using the built-in WYSIWYG editor.


To do it, check the Use custom layout check box and click the Generate table layout button. A default layout will appear in the editor. Try playing around a bit with the layout or just create something similar to what you see in the screenshot below. Click Save Save when you are finished.




6. Now switch to CMS Desk. Choose or create a page where you want to add the registration form and select it in the content tree. Switch to the Design tab and add (AddWebPart) the Membership -> Custom registration form web part to the page. Set the following property of the web part:


Alternative form - cms.user.MyRegistrationForm


7. If you switch to the live site now and go to your page with the Custom registration form web part, you should see the custom registration form that you created. You can now try to register to your website using the form and verify that the user has been created in Site Manager -> Administration -> Users.