public
Description: code extracted from dopplr.com to import social networks from various sites
Homepage: http://code.google.com/p/identity-matcher/
Clone URL: git://github.com/mattb/identity-matcher.git
name age message
file MIT-LICENSE Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 git-svn-... [matt.biddulph]
file README Mon Oct 27 06:30:07 -0700 2008 you can now specify what columns will be used f... [Justin Halsall]
file Rakefile Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 git-svn-... [matt.biddulph]
file init.rb Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 git-svn-... [matt.biddulph]
file install.rb Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 git-svn-... [matt.biddulph]
directory lib/ Mon Oct 27 06:30:07 -0700 2008 you can now specify what columns will be used f... [Justin Halsall]
directory tasks/ Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 git-svn-... [matt.biddulph]
directory test/ Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 git-svn-... [matt.biddulph]
file uninstall.rb Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 git-svn-... [matt.biddulph]
IdentityMatcher
===============

This is a Rails plugin that adds the ability to import social networks from sites such as Twitter and Gmail. Put it in 
your vendor/plugins directory. 


Example
=======

Add this line to your app's User model:

  matches_identities :nickname_field => 'username', :email_field => 'work_email'

and your user model will gain the following methods:

  User.match_gmail(username, password)
  User.match_gmail_api(authsub_token)
  User.match_twitter(nick)
  User.match_hcard(url)
  etc...

The return value is a two-element list. The first element is a list of User objects that match the identities found in 
the external source. The second element, if available for that mode of matching, is a list of found external identities 
that weren't matched, giving their name and email address in a hash.

The default values for matches_identities are:
  :nickname_field => 'nick'
  :email_field => 'email'

Contributing
============

Git source repository: http://github.com/mattb/identity-matcher/tree/master
Please feel free to fork the project at GitHub and submit pull requests or patches.

Copyright (c) 2007-2008 Matt Biddulph, released under the MIT license