You are here

Home » API reference » OAuth Connector 7

README.txt in OAuth Connector 7

Same filename and directory in other branches
  1. 6 README.txt
/* $Id$ */

Description
===========
A module that makes it possible to log in through third party API:s
supporting OAuth. Makes it possible for other modules to define OAuth API:s
which users should be able to log in through and also exposes that ability to
the user who can add new API connections through an admin page.

Warning
=======
Oauth connections are not an easy subject. There are a lot of dependencies
and every provider has its own rules and requirements. This module is able
to make connections to all kinds of providers, including Facebook and Google.
This module does not solve your lack of knowledge of Oauth. Please try to
understand the API documentation of the providers and Oauth in general, before
filling the issue queue.
See: http://oauth.net/

Requirements
============
* connector
* oauth_common
* oauth2_common
* http_client
* http_client_oauth
* ctools
* API accounts with your oAuth providers (Facebook, Twitter, etc)

Installation
============
* Copy the module directory in to your Drupal
sites/all/modules directory as usual.

Usage
=====
Go to admin/structure/oauthconnector/list and create a new provider by using 
one of the presets the list, or by creating you own.  You will need an App Key
and a Secret Key for each provider (see list below). Under Advanced Settings, 
you can choose the scope (permission level), depending on the actions you are
going to be performing with each provider.  For example, if you would like to
get a user's email address from Facebook and publish to their wall, you would
want to enter "email,publish_stream" in the Scope field.

Once you have added a providers, users can add individual connections (for
example, bring up the Facebook Connect dialog) by clicking on the Connections 
tab on /user (user/1/connections) or by using the buttons in the block
'Connector'.

URLs to apply for App Keys (as of Mar. 2012)
============================================
* Facebook: https://graph.facebook.com/
* Twitter: https://api.twitter.com/
* Google: https://code.google.com/apis/console
* LinkedIn: https://www.linkedin.com/secure/developer
* Flickr: http://www.flickr.com/services

File

README.txt
View source 
  1. /* $Id$ */

  2. 

  3. Description

  4. ===========

  5. A module that makes it possible to log in through third party API:s

  6. supporting OAuth. Makes it possible for other modules to define OAuth API:s

  7. which users should be able to log in through and also exposes that ability to

  8. the user who can add new API connections through an admin page.

  9. 

  10. Warning

  11. =======

  12. Oauth connections are not an easy subject. There are a lot of dependencies

  13. and every provider has its own rules and requirements. This module is able

  14. to make connections to all kinds of providers, including Facebook and Google.

  15. This module does not solve your lack of knowledge of Oauth. Please try to

  16. understand the API documentation of the providers and Oauth in general, before

  17. filling the issue queue.

  18. See: http://oauth.net/

  19. 

  20. Requirements

  21. ============

  22. * connector

  23. * oauth_common

  24. * oauth2_common

  25. * http_client

  26. * http_client_oauth

  27. * ctools

  28. * API accounts with your oAuth providers (Facebook, Twitter, etc)

  29. 

  30. Installation

  31. ============

  32. * Copy the module directory in to your Drupal

  33. sites/all/modules directory as usual.

  34. 

  35. Usage

  36. =====

  37. Go to admin/structure/oauthconnector/list and create a new provider by using 

  38. one of the presets the list, or by creating you own.  You will need an App Key

  39. and a Secret Key for each provider (see list below). Under Advanced Settings, 

  40. you can choose the scope (permission level), depending on the actions you are

  41. going to be performing with each provider.  For example, if you would like to

  42. get a user's email address from Facebook and publish to their wall, you would

  43. want to enter "email,publish_stream" in the Scope field.

  44. 

  45. Once you have added a providers, users can add individual connections (for

  46. example, bring up the Facebook Connect dialog) by clicking on the Connections 

  47. tab on /user (user/1/connections) or by using the buttons in the block

  48. 'Connector'.

  49. 

  50. URLs to apply for App Keys (as of Mar. 2012)

  51. ============================================

  52. * Facebook: https://graph.facebook.com/

  53. * Twitter: https://api.twitter.com/

  54. * Google: https://code.google.com/apis/console

  55. * LinkedIn: https://www.linkedin.com/secure/developer

  56. * Flickr: http://www.flickr.com/services

  57.