Registration Web Part
The Registration Web Part lets shoppers create a profile to use on your e-commerce site. This Web Part gathers the appropriate personal information necessary to create an account and set up the site login information, and lets shoppers set passwords for their accounts.
You can configure the Registration Web Part to use a shopper's e-mail address as the unique identifier, or you can configure it to let the shopper specify a unique user name. At a minimum, the Registration Web Part collects the first and last name of the shopper. You can configure this Web Part to gather additional information if needed.
You can configure the Registration Web Part to employ a challenge-response system if the shopper forgets the password, or you can employ a password recovery process. For the challenge-response system, shoppers specify a question and an answer during creation of their accounts. If the shopper forgets the password and the shopper correctly answers the challenge question, the system grants access to the Web site.
Architecture
You can use the Registration Web Part in two possible deployment environments: Windows SharePoint Services (WSS) and Microsoft Office SharePoint Server (MOSS). The Web Part has two implementations:
RegistrationWizardWebPart: Dynamically loads the RegistrationWizard user control
RegistrationWizard.ascx: Lets an unregistered shopper create a profile for the shopping site. The control uses the Membership provider to create a new profile by using the API UserProfile service. The RegistrationWizard.ascx file contains a CreateUserWizard Web control.
Properties
The following table lists the mapping of the properties for the Registration Web Part.
Property |
Maps to |
|---|---|
"Security question's answer" label text |
AnswerLabelText |
"Security question's answer is required" message |
AnswerRequiredErrorMessage |
"Cancel" button text |
CancelButtonText |
"Allow additional communications" check box text |
CommunicationText |
"Success" message |
CompleteLabelText |
"Confirm email does not match" message |
ConfirmEmailErrorMessage |
"Passwords don't match" message |
ConfirmPasswordErrorMessage |
"Confirm password" label text |
ConfirmPasswordLabelText |
"Confirm password is required" message |
ConfirmPasswordRequiredErrorMessage |
ContinueButtonText |
ContinueButtonText |
On completion, go to URL |
ContinueDestinationPageUrl |
"Create" button text |
CreateButtonText |
"User name already exists" message |
DuplicateUserNameErrorMessage |
"Email" label text |
EmailLabelText |
"Email is required" message |
EmailRequiredErrorMessage |
"Email" validation pattern |
EmailValidationExpression |
"Email is invalid" error message |
EmailValidatorErrorMessage |
"First name" label text |
FirstNameLabelText |
"First name is required" message |
FirstNameRequiredErrorMessage |
"Registration" section title text |
HeaderLabelText |
Instructional text |
InstructionText |
"Last name" label text |
LastNameLabelText |
"Last name is required" message |
LastNameRequiredErrorMessage |
"Password creation tip" link text |
PasswordCreationTipLink |
"Password creation tip" text |
PasswordCreationTipText |
"Password" label text |
PasswordLabelText |
Password strength validation pattern |
PasswordRegularExpression |
"Password is required" message |
PasswordRequiredErrorMessage |
"Password fails strength validation" message |
PasswordStrengthNotMetErrorMessage |
"Personal Information" section title text |
PersonalInformationLabelText |
On completion, go to URL |
PostActionPageUrl |
"Security question" label text |
QuestionLabelText |
"Security question is required" message |
QuestionRequiredErrorMessage |
"User name already exists" message |
RegistrationWizardMainDuplicateUserNameErrorMessage |
"* are required fields" label text |
RequiredFields |
"Security question tip" link text |
SecurityQuestionTipLink |
"Security question tip" text |
SecurityQuestionTipText |
"Use Live Id" check box text |
UseLiveIDText |
"User name" label text |
UserNameLabelText |
"User name is required" message |
UserNameRequiredErrorMessage |
"User name" validation pattern |
UserNameValidationExpression |
"User name is invalid" message |
UserNameValidatorErrorMessage |
You can configure the Registration Web Part to let the shopper to enter a personal question and answer to facilitate a Challenge-Response question and answer password recovery system. The default value of the Enable Challenge Response property is False. Shoppers can specify their own personal question and answer, which is stored with their profiles.
The following table lists the field and length limits imposed in the Registration Web Part.
Field |
Maximum length |
|---|---|
User Name/Email Address |
64 |
Password/Confirm Password |
50 |
First Name |
50 |
Last Name |
50 |
Security Question |
255 |
Security Answer |
50 |
The following table lists the default regular expressions that the fields in the Registration Web Part use.
Field |
Pattern |
Regular Expression |
|---|---|---|
Username/Email Address |
E-mail address |
\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)* |
Password/Confirm Password |
Alphanumeric characters |
[0-9a-zA-Z]* |
Customization
You can customize the Registration Web Part by modifying the .ascx file or the properties sheet.
Error Handling
There is no design-time error handing required for this Web Part.
API Dependencies
The Registration Web Part relies on the API and a Membership Provider that encapsulates calls to the API service. Because the Registration Web Part implements a CreateUserWizard Web control, a Membership provider can support its functionality.
See Also
Other Resources
Working With the Registration Web Part