contacts 0 ruby Rubygems

A universal interface to import email contacts from various providers including Yahoo, Gmail, Hotmail, AOL, Plaxo, GMX.net, Web.de, inbox.it, sezname.cz.

5 years after BSD-3-Clause

= liangzan-contacts

liangzan-contacts is a fork of the contacts_19 gem. It aims to be compatible with 1.9 and above. It also provide interfaces to many European email providers.

== Intro

Contacts is a universal interface to grab contact list information from various providers including Hotmail, AOL, Gmail, Plaxo, Yahoo, GMX.net, Web.de, inbox.it, sezname.cz.

== Installation

$ gem install liangzan-contacts

or on the Gemfile

gem 'liangzan-contacts', '~>1.2.8', :require => 'contacts'

== Background

For a long time, the only way to get a list of contacts from your free online email accounts was with proprietary PHP scripts that would cost you $50. The act of grabbing that list is a simple matter of screen scrapping and this library gives you all the functionality you need. Thanks to the generosity of the highly popular Rails website MOG (http://mog.com) for allowing this library to be released open-source to the world. It is easy to extend this library to add new free email providers, so please contact the author if you would like to help.

== Usage

returns [["name", "[email protected]"], ["another name", "[email protected]"]]

Contacts::Hotmail.new(login, password).contacts Contacts::Yahoo.new(login, password).contacts Contacts::Gmail.new(login, password).contacts

Contacts.new(:gmail, login, password).contacts Contacts.new(:hotmail, login, password).contacts Contacts.new(:yahoo, login, password).contacts

Contacts.guess(login, password).contacts

Notice there are three ways to use this library so that you can limit the use as much as you would like in your particular application. The Contacts.guess method will automatically concatenate all the address book contacts from each of the successful logins in the case that a username password works across multiple services.

== Captcha error

If there are too many failed attempts with the gmail login info, Google will raise a captcha response. To integrate the captcha handling, pass in the token and response via:

Contacts::Gmail.new(login, password, :captcha_token => params[:captcha_token], :captcha_response => params[:captcha_response]).contacts

== Examples

See the examples/ directory.

== Authors

== Contributors

This library is released under the terms of the BSD.

Related Repositories

cordova-plugin-contacts

cordova-plugin-contacts

Mirror of Apache Cordova Plugin contacts ...

react-native-unified-contacts

react-native-unified-contacts

Your best friend when working with the latest and greatest Contacts Framework in ...

cordova-plugin-contacts-phone-numbers

cordova-plugin-contacts-phone-numbers

Cross-platform plugin for Cordova / PhoneGap to list contacts' phone numbers. ...

Contacts-Combo_ObjC

Contacts-Combo_ObjC

It's a one stop solution for whatever you want to do with your iOS contacts. You ...

abhi-contacts

abhi-contacts

Rails Contacts Gem Modified to work with hotmail ...


Top Contributors

liangzan laurynas adamhunter glennfu onomojo eofferma eshear ayaman ilyakatz lazyatom joeyAghion balepc gf3 tonytargonski

Releases

-   v1.2.25 zip tar
-   v1.2.24 zip tar
-   v1.2.23 zip tar
-   v1.2.22 zip tar
-   v1.2.21 zip tar
-   v1.2.20 zip tar
-   v1.2.19 zip tar
-   v1.2.18 zip tar
-   v1.2.17 zip tar
-   v1.2.16 zip tar
-   v1.2.15 zip tar
-   v1.2.14 zip tar
-   v1.2.13 zip tar
-   v1.2.12 zip tar
-   v1.2.11 zip tar
-   v1.2.10 zip tar
-   v1.2.9 zip tar
-   v1.2.8 zip tar
-   v1.2.7 zip tar
-   v1.2.6 zip tar