Kentico CMS 6.0 Developer's Guide

Available web parts

Available web parts

Previous topic Next topic Mail us feedback on this topic!  

Available web parts

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

After you register your site at https://manage.dev.live.com/ and enter the necessary settings, you can use the following two web parts on your website to allow authentication via Windows Live ID. The web parts are located under the Membership -> LiveID category in the web part catalog.

 

Windows LiveID

 

This web part can be used to let site visitors sign in to your website using their Live ID. It can be placed on any page of your website. The web part is hidden to authenticated users and will be displayed only to unauthenticated public site visitors. With default settings, the web part appears as in the following screenshot.

 

devguide_clip0952

 

Although the web part works fine with default settings, it has the following properties to fine-tune its behavior:

 

Sign in text - if entered, a link with the entered text will be used instead of the default sign in image.

Sign out text - if entered, a link with the entered text will be used instead of the default sign out image.

Show sign out - if enabled, the web part will display a sign out link to authenticated users.

Show as button - if enabled, buttons will be used instead of standard text links.

Sign in image - specifies the URL of an image that will be used for the sign in button if the Sign in text property is empty.

Sign out image - specifies the URL of an image that will be used for the sign out button if the Sign out text property is empty.

 

Notify administrator about new registrations - if enabled, a notification e-mail will be sent to the website administrator when a new registration is performed via the web part.

 

LiveID required data

 

In some cases, you may want new users to provide some extra details before their account is created. For example, if your site is configured to require registration approval or double opt-in, all users need a valid e-mail address to help activate their account.

 

This can be achieved using the Live ID required data web part. The web part must be placed on the page specified by the Required user data page in Site Manager -> Settings -> Security & Membership -> Authentication -> Windows LiveID.

 

The following properties of the web part are the most important:

 

Allow forms authentication - if checked, new users will be able to enter a password for their new account so that they can log in the usual way as well as via LiveID.

Allow existing user - if enabled, users are allowed to join their existing account with their Live ID.

Default target URL - if no return URL is passed, users will be redirected to the URL entered here after merging or creating their account.

Hide for no LiveID - if checked, the web part will be hidden if the page with it is displayed without being a Live ID logon request (e.g. when accessed by entering its URL into the browser).

 

Other specific web part properties are explained in Kentico CMS Web Parts reference or after clicking the Documentation (Documentation) link in the top right corner of the web part properties window.

 

devguide_clip1756

 

The screenshot above shows how the web part looks with both the Allow forms authentication and Allow existing user options enabled. In the left part, existing site users can merge their current user account with the Live ID just by entering their user name and password. In this case, the Live ID Token will be added to the LiveID field of the existing user account. New users can enter the required details in the right part of the web part.