Setting up a user self-registration form
This article explains how to create a Sitekit CMS form that submits the form input to the user database. This allows site visitors to register and create a user in a pre-defined user group.
For the user to be successfully created upon submission of the form, the form must pass values for all fields in the user database (even if they are null values). This is carried out by using the following string in the ‘Sitekit and additional URL’ field in the form configuration:
http://www.yourdomain.com/admin/ws/userfunctions.asmx/AddUser?UserAddSiteID=SiteID&UserAddUserGroupID=UserGroupID&UserAddExpiryDate=1/1/2100&UserAddDepartment=&UserAddTelephone=&UserAddFax=&UserAddJobTitle=&UserAddAdditionalInfo=&UserAddCustomField1=&UserAddCustomField2=&UserAddCustomField3=&UserAddCustomField4=&UserAddCustomField5=&UserAddCustomField6=&SUCCESS=User%20created
In the above string, www.yourdomain.com must be changed to a domain associated with the licence, SiteID must be changed to the site ID, and UserGroupID changed to the ID of the User Group that registrants are to be added to.
- A full list of associated domains can be found in Configure > Domains
- The SiteID can be found in Configure > Site Settings
- The User Group ID can be found in Manage > User Groups
All the fields held in the User database are listed below. All fields must either be added as form fields, or passed in the above string (with or without a value).
UserAddFullNameUserAddEmailUserAddUsernameUserAddPasswordUserAddExpiryDateUserAddDepartmentUserAddTelephoneUserAddFaxUserAddJobTitleUserAddAdditionalInfoUserAddCustomField1UserAddCustomField2UserAddCustomField3UserAddCustomField4UserAddCustomField5UserAddCustomField6
The names of the fields that are displayed to the user can be overridden in the advanced field options (‘Override field label’) in the Form Designer.
The group which users are being associated with must have self-registration enabled. Edit the group in question and enable "Allow Self Registration" (at the very foot of the configuration options) and save the change.
Self-registration forms can be used in conjunction with email verification. If so, the self-registered user will not be able to log in until they have verified their email address.