Post installation instructions - mjimeyg/alternate-login GitHub Wiki

For three of the providers (Facebook, Twitter and Windows Live) you will need to visit the developers site for each provider and create an 'App' for your own site. These 'Apps' are FREE!

OpenID can be initialised straight off the bat with no need for additional settings or creating 'Apps'. You can skip to the last section to see details on or to initialise it.

== Setup Facebook ==

  1. Go to [https://developers.facebook.com/|Facebook Developer's site].

  2. Create an App, fill in as much of the details as you can. If you have never done this before you might be asked to verify you are who you say you are via SMS text messaging. It's relatively painless.

  3. Once you have created your App, take note of the App ID and App Secret.

  4. Go to your forum ACP and navigate to the ConSof page, Facebook Manager section.

  5. You now need to fill in various fields, the following are mandatory fields:thumb|alt=Screenshot of Facebook Manager|A screen shot of Facebook Manager.

:: a. Facebook App ID - You get this from the Facebook App you just created.

:: b. Facebook Secret - You get this from the Facebook App you just created.

:: c.Site Domain - This is the domain of your forum. If your forum is located at http://www.example.com/phpBB/index.php then your domain is example.com.

  1. The Page URL is optional and is only needed if you enable the Facebook Like Box. For more information about Facebook Pages see: [http://www.facebook.com/about/pages Facebook Pages]

  2. Finally, select the various plugins you want displayed on your index page and click submit.

  3. Now continue with the other providers or move onto the final steps.

== Setup Twitter ==

  1. Go to the [https://dev.twitter.com/apps Twitter Developers Site].

  2. Sign in and create an App by following the on screen instructions. Fill in as much information as you can.thumb|alt=Screenshot of Twitter Manager|A screen shot of Twitter Manager.

:: '''NOTE!''' The callback should point to the al_tw_connect.php file. (i.e. http://www.example.com/phpBB/alternatelogin/al_tw_connect.php)

3.Note down the Consumer Key, Consumer Secret and Callback URL.

  1. Go to your forum ACP and navigate to the ConSof page, Twitter Manager section.

  2. Now fill in ALL the fields using the values you noted down in step 3.

  3. Finally click submit.

  4. Now continue with the other providers or move onto the #Final Steps.

== Setup Windows Live ==

  1. Go to the [http://msdn.microsoft.com/en-us/live/default.aspx Windows Live Developer's Site].

  2. Create an Application following the on screen instructions.thumb|alt=Screenshot of Windows Live Manager|A screen shot of Windows Live Manager.

:: '''NOTE!''' The callback should point to the al_wl_connect.php file. (i.e. http://www.example.com/phpBB/alternatelogin/al_wl_connect.php)

  1. Note down the Client ID and Client Secret and Callback URL.

  2. Go to your forum ACP and navigate to the ConSof page, Windows Live Manager section.

  3. Now fill in ALL the fields using the values you noted down in step 3.

  4. Finally click submit.

  5. Now move onto the #Final Steps.

== Final Steps == thumb|alt=Screenshot of Alternate Login Manager|A screen shot of Alternate Login Manager.

  1. Click on the Alternate Login Manager section of the ConSof ACP page.

  2. Enable each of the providers you wish to use and have set up for. (Remember that OpenID does not require additional settings.)

  3. Click Submit.

You should now be able to log in with these providers.