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 [matt.biddulph]
file README Sat Apr 26 03:58:25 -0700 2008 Be explicit about contributions at github [Matt Biddulph]
file Rakefile Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 [matt.biddulph]
file init.rb Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 [matt.biddulph]
file install.rb Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 [matt.biddulph]
directory lib/ Sat Jun 07 09:15:23 -0700 2008 Add Yahoo BBAuth-based Addressbook API method [Matt Biddulph]
directory tasks/ Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 [matt.biddulph]
directory test/ Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 [matt.biddulph]
file uninstall.rb Mon Sep 24 03:48:40 -0700 2007 Initial commit from dopplr repo r1492 [matt.biddulph]
README
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

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.

Restrictions
============

The code assumes that your user model uses the field 'email' for email address and 'nick' for screen name. A future 
version will parameterise this.

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