Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
PHP
branch: master

Updated documentation for specifying correct Return URL if user is up…

…loading github tarball/zipball using Drupal UI.
latest commit de7e9eb201
schakra authored
Failed to load latest commit information.
LICENSE.txt move the module files to root
README.txt Updated documentation for specifying correct Return URL if user is up…
webauth-handler.php move the module files to root
windowslive.css move the module files to root
windowslive.info
windowslive.install
windowslive.module Removed table that shows unique id associated with Windows Live ID as…
windowslivelogin.php move the module files to root

README.txt

DESCRIPTION
-----------
WindowsLiveID module for Drupal will allow Drupal sites to have authentication using Windows Live.
A Windows Live account needs to have an associated user account in Drupal to be able to login.

INSTALLATION
------------
Prerequisites:
1) Drupal7 installed and running
2) MySql 5.1 or above
3) php 5.2.0 or above

Installation Instructions:
1. Download WindowsLiveID module for Drupal
2. Copy Module files
   -Create Module Directory <Drupal-install-Root-dir>/sites/all/modules/windowslive
   -copy module files to <Drupal-install-Root-dir>/sites/all/modules/windowslive
<Drupal-install-Root-dir> is the Drupal installation directory on the machine. Ex: C:\www\Drupal7

3. Register the Windows Live Application in Windows Live Application Management Site
   - Go to Windows Live Application Management Site (http://go.microsoft.com/fwlink/?LinkID=144070) from browser. 
   - Signin with Windows Live ID. If you don't have one, then create a new Windows Live ID for this application.
   - Add a web application with domain name. Keep a note of ClientId/AppId and SecretKey of this application.
   - Provide additional settings for ‘Return URL’ by clicking on 'Essentials' link below the Client ID and Secret Key. Set 
     the ‘Return URL’ for your application in Windows Live Application Management Site to ‘webauth-handler.php’
     e.g. If you are manually extracting module to <Drupal-install-Root-dir>/sites/all/modules/windowslive folder, then
     this URL should be <DrupalRootUrl>/sites/all/modules/windowslive/webauth-handler.php

     But if you are directly uploading the tarball/zipball from github repository using Drupal UI, then the URL 
     should be <DrupalRootUrl>/sites/all/modules/<TarZipballFileNameWithoutExtension>/webauth-handler.php

<DrupalRootUrl> is the root http URL of Drupal installation. Ex: http://myhostname/Drupal7
<TarZipballFileNameWithoutExtension> is the file name of your github tarball/zipball without extension. 
e.g. When you download tarball/zipball from github, gutgub generates file name like 
schakra-WindowsLiveID-Drupal-Module-428f9e3.zip and TarZipballFileNameWithoutExtension will be 
schakra-WindowsLiveID-Drupal-Module-428f9e3

4. Enable and configure WindowsLiveID Module in Drupal.
  - Login to Drupal as Admin.
  - Enable the WindowsLiveID module from modules section and save the configuration.
  - Set the values for Client ID and Secret Key for WindowsLiveID module in 'Configure' option.
  Verify WindowsLiveID Module login link will be enabled in the login screen of Drupal.

USAGE
-----
1)User Login  
    - Clicking on ‘Log in using Windows Live ID’ link will take the user to Windows Live authentication page if user not logged in yet.
    - After the user logins successfully on the Windows Live page, the Windows Live Service will automatically redirect the user back to the Drupal web site.
    - User can login and associate the Windows Live ID, if they have a Drupal account before.
    - User can register and login with the Windows Live ID, once the site administrator approves the request and user validates Drupal account.
2) Administering WindowsLiveId Module
    - In addition to managing the Installation settings the Administer can,
    - From the User Account page Remove existing identities (Association with Windows Live ID)

LIMITATIONS AND KNOWN ISSUES
----------------------------
1. During Logout, user is not logged out from Windows Live ID sites. So the user is expected to close the browser session to remove any Windows Live cookies or tokens 
   in the current browser session.
Something went wrong with that request. Please try again.