README.md in omnicontacts-0.2.3 vs README.md in omnicontacts-0.2.4
- old
+ new
@@ -63,9 +63,15 @@
OmniContacts supports OAuth 1.0 and OAuth 2.0 token refresh, but for both it needs to persist data between requests. OmniContacts stores access tokens in the session. If you hit the 4KB cookie storage limit you better opt for the Memcache or the Active Record storage.
Gmail requires you to register the redirect_path on their website along with your application. Make sure to use the same value present in the configuration file, or `/contacts/gmail/callback` if using the default.
+To configure the max number of contacts to download from Gmail, just add a max results parameter in your initializer:
+
+```ruby
+importer :gmail, "xxx", "yyy", :max_results => 1000
+```
+
Yahoo requires you to configure the Permissions your application requires. Make sure to go the Yahoo website and to select Read permission for Contacts.
Hotmail does not accept requests from localhost. This can be quite annoying during development, but unfortunately this is the way it is.
Hotmail presents another "peculiar" feature. Their API returns a Contact object, which does not contain an e-mail field! However, if the contact has either name, family name or both set to null, than there is a field called name which does contain the e-mail address. To summarize, a Hotmail contact will only be returned if the name field contains a valid e-mail address, otherwise it will be skipped. Another consequence is that OmniContacts can provide contacts with only the `:email` key set.