Table of Contents
Facebook Login
The Facebook Login is an alternative to Ektron CMS400.NET ‘s standard login. Its advantage is that users can log in using their Facebook username and password, rather of having to set up and remember a freestanding Ektron CMS400.NET username and password .
here is an example of Facebook Login control on a Web page.
Reading: Facebook Login
The Facebook Login command allows both Membership users and Ektron CMS400.NET users log in to an Ektron CMS400.NET Web site. If users already have an Ektron CMS400.NET user profile, they can be prompted to link the Facebook username and password with that profile .
The Facebook Login merely provides an ability to log in to an Ektron CMS400.NET web site. It provides no other Facebook features, such as viewing or sending messages .
This part explains how to set up and use the Facebook Login feature of speech through these topics. Facebook
Samples of the Facebook Login Feature
Using Facebook Login with Active directory
User experience
Developer experience : frame-up Instructions
Using Facebook Connect Extension with the Targeted Content Widget
Samples of the Facebook Login Feature
You can see samples of the Facebook Login feature in these sites .
Developer Sample locate > Social Networking > Facebook Connect
– site root /developer/FacebookConnect/Login.aspx
– site root /developer/FacebookConnect/CustomSignup.aspx
Ektron Tech web site has Facebook Login on the home page
Using Facebook Login with Active Directory
You can not use the Facebook Login feature with Active Directory .
User Experience
Note: The drug user know is entirely enabled after a developer sets up the feature. See besides : Developer experience : apparatus Instructions
If a user clicks a Facebook Login button but is not logged into Facebook, the page below appears
When the user completes this sieve or if the drug user is already logged into Facebook, he is forwarded to a page ( see example below ) that prompts him to register or log in to Ektron CMS400.NET .
This screen asks the exploiter if he has a membership history and, if so, would he like to connect his Facebook username and password with the Ektron CMS400.NET score. If the exploiter agrees, he will access his membership account via the Facebook Login manipulate with Facebook credentials from now on .
If the user does not have a membership report, he completes the lower half of the riddle. This is the same screen that new members use to create accounts. See besides : Membership Server Control
From then on, the drug user can click the Facebook Login button to log into Ektron CMS400.NET using his Facebook username and password .
When the user logs out of Ektron CMS400.NET, that action does not log him out if Facebook. conversely, if a exploiter logs out of Facebook, he is not logged out of Ektron CMS400.NET .
Note: Facebook often caches some information in your browser. If you see JavaScript errors or other leftover behavior, clear the browser cache, finale all browser windows, and try again .
Developer Experience: Setup Instructions
To set up the Facebook Login feature, follow these steps .
gradation 1 : connect Facebook to Your Ektron CMS400.NET Web Site
footprint 2 : produce or Modify a Facebook Login/Signup Page
alternative to Redirecting to the Signup Form
Step 1: Connect Facebook to Your Ektron CMS400.NET Web Site
Follow these steps to obtain Facebook keys, paste them into the web.config file, and identify your locate to Facebook .
1. In you do n’t have one, create a Facebook report. Go to www.facebook.com and follow the signal up instructions .
2. sign in to the Facebook Developer site, hypertext transfer protocol : //www.facebook.com/developer .
3. Click +Set up New Application .
4. Enter a name for your lotion. The diagnose can not include facebook or any variations, such as FB .
5. A new screen appears, showing your Application ID, API key, and Secret key .
6. Open your Web locate ‘s root folder /web.config file .
7. Copy the match Facebook key into these web.config elements
ek_FacebookApiKey
ek_FacebookSecret
Note: Keys shipped in Ektron sample distribution sites are for localhost .
Note: Make sure the Facebook keys were generated for the host header/URL to which you ‘re applying them. besides, if you are testing using dependable site apparatus, verify that the web.config component ek_useSSL is true .
8. Save and close web.config .
9. Return to the Facebook Basic sieve.
10. Click the Connect check from the leave empanel .
11. Into the Connect URL field, enter the URL of your Web site .
for a public site, enter its URL. For example, www.ektron.com .
for a shared server or if you are accessing the locate from a remote control machine, use the IP address. As examples, http://192.168.14.10, http:// 192.168.14.10/QA
for a local anesthetic server, function localhost. As examples, http://localhost, http://localhost/EktronTech
12. Save and close the Facebook screen .
After setting up your application, you can return to this screen at any time to view the keys, edit the Connect URL set up, etc .
Step 2: Create or Modify a Facebook Login/Signup Page
Facebook provides a sample distribution shape ( shown below ) that appears if a user clicks a Facebook Login button and is not presently logged into Facebook .
The above form is created by Facebook, not Ektron CMS400.NET. You can customize parts of it, such as the championship and locate effigy ) using Facebook ‘s Application settings .
When the exploiter completes the form, he is forwarded to an Ektron CMS400.NET form ( see exemplar below ) that prompts him to register or login to Ektron CMS400.NET .
You specify which class appears via the Facebook Login server control ‘s SignupTemplate place. The default class in the Developer sample web site, web site root/Developer/FacebookConnect/register.aspx, is shown above. You can use the default form as is, modify it, or create your own .
The logic to connect a Facebook user with an Ektron CMS400.NET account ( circled below ) is not depart of the Facebook Login server control. however, sample code for that functionality is included in the Ektron Tech sample web site ‘s register.aspx foliate .
Alternative to Redirecting to the Signup Form
If you do not want to redirect the exploiter to a signup form after the Facebook login, you can alternatively hook the Ektron_FacebookNewMemberLoggedIn javascript event and do whatever you want with it. For example, you could raise a modal dialogue with a short signup form .
You can see an model of hooking this javascript consequence in the Developer web site under Social Networking > Facebook Connect > Custom signup ( locate root/developer/facebookconnect/customsignup.aspx ) .
Step 3: Place the Facebook Login Server Control on a Page
1. In ocular Studio, open the template onto which you want to place a Facebook Login server control. See besides : Working with Ektron CMS400.NET Server Controls
2. Drag and drop the master .
3. Use the following table to complete its properties .
Note: The following table only lists Ektron-specific properties. It does not describe native .NET properties such as font, stature, width and border stylus. For software documentation of these properties, see ocular Studio avail .
| property | description | Data type |
| Authenticated | Indicates if you are logged in to the CMS explorer and can use it to browse to Content, Collections, etc. See besides : â�, �Using CMS Explorer to Browse Your Ektron CMS400.NET Siteâ�, � on page 21-12 | String |
| FacebookButtonText | Enter the text that appears on the Facebook Login button. The default text is Connect with Facebook. | String |
| hide | Used to hide end product of the operate in design time and run fourth dimension . true = Hide control false = Display control | boolean |
| InstructionDetail | Enter extra text that appears above the Facebook Login button. The default text is Sign in using your Facebook account. | String |
| InstructionHeader | Enter the text that appears above the Facebook Login button. The default text is Sign in using your Facebook account. | String |
| language | Set a lyric for viewing the Facebook Login control. This place shows results in design-time ( in Visual Studio ) and at run-time ( in a browser ) . | integer |
| SignupTemplate | Enter the path to the template that appears after a user completes the Connect with Facebook screen. Step 2: Create or Modify a Facebook Login/Signup Page | String |
You can customize the markup for the form using the LoginTemplate and LogoutTemplate server controls. You can find examples of this on the developer locate at siteroot/developer/facebookconnect/login.aspx
Note: After you update web.config with the Facebook keys, wait a few minutes before logging into Ektron site via the Facebook Login waiter manipulate .
Using Facebook Connect Extension with the Targeted Content Widget
By using Facebook Login, you can retrieve profile data from the user ‘s facebook account using Facebook Connect Extension.
This is information available in Facebook profiles .
- Age
- Gender
- Marital Status
- Likes
- Employment
For more data about code to do this, see the Knowledge Base article entitled “ INFO : Targeted Content Widget : Facebook Connect Extension ” located at
http://dev.ektron.com/kb_article.aspx?id=32156
.
To learn more about the Targeted Content Widget, see Creating a target Content Widget .
