==Personalise Site
===============

Provides helpers for your views that allow you to gain implicit data about the user browsing the site.

This is intended to be used to customise what the user see's, maybe to improve usability or for cross-browser issues

===Setup

Install the plugin:
ruby script/plugin install http://svn.railslodge.com/svn/plugins/personalise_site/


===Usage

The following methods are available:

Returns the name of the browser the user is using
<%= which_browser %>


Returns the version number of the browser being used
<%= which_browser_version %>


Returns the name of the platform the user is using
<%= which_platform %>


The data used for the following methods is implicitly gained for performing a geo location lookup using the users IP address. 
(This data is not always accurate)

Returns which country the user is in
<%= which_country %>

Returns which country the user is in (Short)
<%= which_country_short %>

Returns which city the user is in
<%= which_city %>


The users geographical coordinates
longitude: <%= longitude_coordinate %>
latitude:  <%= latitude_coordinate %>


Nil is always returned if the data is unavailable

==== Example usage

An example below looks at the platform and outputs the right command to install this plugin
<% if which_platform? == 'Windows' -%>
	ruby script/plugin install http://svn.railslodge.com/svn/plugins/personalise_site/
<% elsif which_platform? == 'Mac' -%>
	./script/plugin install http://svn.railslodge.com/svn/plugins/personalise_site/
<%else -%>
	script/plugin install http://svn.railslodge.com/svn/plugins/personalise_site/
<%end -%>


Info
=============
Author: Scott Sherwood
Homepage: http://www.railslodge.com/plugins/303-personalise-site
SVN: http://svn.railslodge.com/svn/plugins/personalise_site/
License: MIT
Date created: 30-09-07
Date updated: 01/12/07

Copyright (c) 2007 [Scott Sherwood], released under the MIT license