$Id: README.txt,v 1.1 2008/06/01 03:46:10 davidwhthomas Exp $
IP Login - Login to Drupal automatically via your IP address
By David Thomas
davidwhthomas@gmail.com
May 2008

*** ABOUT ***
This module allows users to login first automatically via their IP address, instead of using a username / password.
The module uses the core 'Profile' module to lookup a user's IP address

*** HOW IT WORKS ***
When a user visits any Drupal page, IP Login checks that they're not logged in and that IP login hasn't run yet for this session.
If they are a new anon user, the module checks if a record exists for the user's IP address by looking up the profile_values field for the IP Address in $_SERVER['REMOTE_HOST']
If a matching IP address is found in profile_values, it logs them in as that user.
If not, normal username / password authentication is still always available as a second step.

*** HOW TO INSTALL ****

1. Create a user profile textfield to store the user's IP address. e.g: profile_ip. I recommend making it a private field, only available to admins.
2. Copy the module folder 'ip_login' to your module folder (e.g sites/all/modules/ )
3. Enable the module from Drupal admin -> modules
4. Go to the site config settings at admin/settings/iplogin and select the profile field that contains a user's IP address.
5. Done.

*** HOW TO TEST ***

You can test it by entering your IP address in your user profile. If you need to find your external IP address, try http://whatismyip.com
If it's working, you should be able to close the browser, open it, go to your site and see the 'Welcome %name, you're now logged into %sitename' message after IP Login has logged you in.

