InstantASP Documentation

To take advantage of the new Twitter login option introduced with InstantForum.NET 2010-2 you'll need to follow the steps below.

Creating a Twitter Application

First you'll need to register your web site as an application with Twitter. You can do this at the link below...

http://twitter.com/apps/new

You can specify various snippets of information (name, description, image etc) to help identify your web site on Twitter to users who choose to login. The most important fields when creating a new application on Twitter are the "Application Type" and "Callback URL" fields.

You should ensure the "Application Type" is set to "Browser" and the "Callback URL" field points to your InstantForum.NET URL. You can see the settings used for our own Twitter login at http://community.instantasp.co.uk/ below...

Click the image to display a larger version.

Once you create your application you'll notice Twitter.com provide two unique snippets of information.

A "Consumer Key" and a "Consumer Secret". You can see these below...

The consumer key and consumer secret are very important as you'll need to copy and paste these info the InstantForum.ET web.config file.

Adding the Consumer Key and Consumer Secret tp Web.Config

Once you have your own consumer key & secret locate the InstantForum.NET 2010 web.config file. Open the web.config file within NotePad or similar plain-text editor and locate the following application settings...

<appSettings>
...
<add key="twitterConsumerKey" value="" />
<add key="twitterConsumerSecret" value="" />
...
</appsettings>

If you've upgraded from an earlier version of InstantForum.NET you'll need to add these application settings within the <appSettings> section of your web.config file.

Simply copy your consumer key & secret provided by Twitter for your application into the section as shown below...

<add key="twitterConsumerKey" value="{YourConsumerKey}" />
<add key="twitterConsumerSecret" value="{YourConsumerSecret}" />

Where {YourConsumerKey} is your Twitter consumer key for your application and {YourConsumerSecret} is your Twitter consumer secret fpr your application.

If these keys are not provided the Twitter button will not be displayed on the login page.

Testing Twitter Login

Once you've added your consumer key and secret to the web.config file open your InstantForum.NET 2010-2 or above installation within your web browser. Click the "Login" link in the top left. You should now see an option to login via Twitter as shown below...