You are here

README.txt in Facebook Connect 8.2

Same filename in this branch
  1. 8.2 README.txt
  2. 8.2 fbconnect_stream_publish/README.txt
Same filename and directory in other branches
  1. 6.2 README.txt
  2. 7.2 README.txt
-- SUMMARY --

This module roughly acts like the OpenId Drupal 6.x core module :
- It lets you use your Facebook ID and password to sign-in to your drupal site.
- Users can see which of their Facebook friends had an account on your drupal site.
- Users can publish a feed on their Facebook feed announcing that they have created an account or commented an article on your website.
- Users can invite their Facebook friends to create an account on the Drupal website.
- In case the user already holds an account on the website: The user can choose to link his drupal account to his Facebook identity.

-- FACEBOOK CONNECT TAB --

This module adds a new Facebook Connect tab in the user's profile page. This tab allows to change:
- the "Use my Facebook picture as user picture" setting.
This field can be seen only if user_pictures is enabled.
The profile picture will be displayed directly from Facebook via FBML.

- the "Let my Facebook friends see me" setting
If this parameter is enabled, the user's will be visible by her Facebook friends.

Also this tab allows to unlink your Facebook account.

-- REQUIREMENTS --
PHP 5.4 or higher versions.
Drupal 7.x.
Facebook PHP 4.1.0 Library or higher: https://github.com/facebook/facebook-php-sdk-v4
Facebook API key: http://www.facebook.com/developers/


-- INSTALLATION --
  1. Upload the 'fbconnect' folder into your module directory and activate
     the modules.

  2. Upload facebook-php-sdk-v4 library (https://github.com/facebook/facebook-php-sdk-v4) into the libraries
     folder so that it looks like 'sites/all/libraries/facebook-php-sdk-v4'.

     drush_make script will come back right after Facebook PHP SDK v4.1.0 stable release

  3. Create a new Facebook application: https://developers.facebook.com/apps

  4. Enter the Site URL on Web Site settings tab (e.g. copy value from admin/config/people/fbconnect field “Connect url”).

  5. Configure the module through admin interface (admin/config/people/fbconnect) using the information provided by Facebook
    (Application ID, Application Secret).

-- About "Connecting" with Facebook --

Facebook expects that once you are logged into Facebook and have registered
with the appid for site X that you would automatically logged into site X
if you visit it in the same browser.

Select "Auto login/logout" to reproduce this behavior.

It gets confusing though as a user and someone who tries to provide choices
to users about what the "Connect" button means.

It can mean any of the following:

1) Login to Facebook, register in Facebook with "Site X", and create a user for "Site X"

2) Register on Facebook with "Site X" and create a user on "Site X"

3) Login to Facebook and login to "Site X"

4) Login to "Site X"

Facebook only gives you information about a visitor if they are BOTH logged
into Facbook and have registered with your appid. So it is impossible to
differentiate from cases 1 - 3.

As a user you might not want to automatically login to a site when you are
logged into Facebook.

This module has a "manual" setting for "Login / Logout" mode to give users
that option.

If you select "manual" there are two options for the name of the button.

- "Not Logged into Facebook" satisfies cases 1 - 3. The default button says
  "Connect".

- "Logged into Facebook and Registered but not Logged into This Site" satisfies
  case 4. The default is "Login" and also provides the user name which is
  made available by Facebook.

-- FAQ --

Q: How to skip linking local account to FB account?
A: Enable "Disable linking accounts during registration" checkbox on admin/config/people/fbconnect/apperance page

Q: Why the connect button does not appear?
Q: Facebook Connect dialog says: "Invalid Argument: Given URL is not allowed by the Application configuration".
A: Check 5th step of installation instructions. Check for error messages on page admin/reports/status.

Q: Fbconnect redirects to the Facebook homepage in popup
Q: I'm getting error "Application Unavailable - The application you are trying to access is unavailable or restricted"
A: Try to disable all other facebook* modules. If you're using fb_social you have to enable fbconnect_fb_social.

Q: Cannot login to drupal site after sucessully logged in to Facebook.
A: Check your Application Secret on admin/config/people/fbconnect page.

Q: Fbconnect Causes W3C XHTML Validation To Fail
A: http://drupal.org/node/365584#comment-3539890

Still did not solve problem ? Disable other facebook* related modules, check admin/reports/status page, php logs,
post issue on http://drupal.org/project/issues/fbconnect

File

README.txt
View source
  1. -- SUMMARY --
  2. This module roughly acts like the OpenId Drupal 6.x core module :
  3. - It lets you use your Facebook ID and password to sign-in to your drupal site.
  4. - Users can see which of their Facebook friends had an account on your drupal site.
  5. - Users can publish a feed on their Facebook feed announcing that they have created an account or commented an article on your website.
  6. - Users can invite their Facebook friends to create an account on the Drupal website.
  7. - In case the user already holds an account on the website: The user can choose to link his drupal account to his Facebook identity.
  8. -- FACEBOOK CONNECT TAB --
  9. This module adds a new Facebook Connect tab in the user's profile page. This tab allows to change:
  10. - the "Use my Facebook picture as user picture" setting.
  11. This field can be seen only if user_pictures is enabled.
  12. The profile picture will be displayed directly from Facebook via FBML.
  13. - the "Let my Facebook friends see me" setting
  14. If this parameter is enabled, the user's will be visible by her Facebook friends.
  15. Also this tab allows to unlink your Facebook account.
  16. -- REQUIREMENTS --
  17. PHP 5.4 or higher versions.
  18. Drupal 7.x.
  19. Facebook PHP 4.1.0 Library or higher: https://github.com/facebook/facebook-php-sdk-v4
  20. Facebook API key: http://www.facebook.com/developers/
  21. -- INSTALLATION --
  22. 1. Upload the 'fbconnect' folder into your module directory and activate
  23. the modules.
  24. 2. Upload facebook-php-sdk-v4 library (https://github.com/facebook/facebook-php-sdk-v4) into the libraries
  25. folder so that it looks like 'sites/all/libraries/facebook-php-sdk-v4'.
  26. drush_make script will come back right after Facebook PHP SDK v4.1.0 stable release
  27. 3. Create a new Facebook application: https://developers.facebook.com/apps
  28. 4. Enter the Site URL on Web Site settings tab (e.g. copy value from admin/config/people/fbconnect field “Connect url”).
  29. 5. Configure the module through admin interface (admin/config/people/fbconnect) using the information provided by Facebook
  30. (Application ID, Application Secret).
  31. -- About "Connecting" with Facebook --
  32. Facebook expects that once you are logged into Facebook and have registered
  33. with the appid for site X that you would automatically logged into site X
  34. if you visit it in the same browser.
  35. Select "Auto login/logout" to reproduce this behavior.
  36. It gets confusing though as a user and someone who tries to provide choices
  37. to users about what the "Connect" button means.
  38. It can mean any of the following:
  39. 1) Login to Facebook, register in Facebook with "Site X", and create a user for "Site X"
  40. 2) Register on Facebook with "Site X" and create a user on "Site X"
  41. 3) Login to Facebook and login to "Site X"
  42. 4) Login to "Site X"
  43. Facebook only gives you information about a visitor if they are BOTH logged
  44. into Facbook and have registered with your appid. So it is impossible to
  45. differentiate from cases 1 - 3.
  46. As a user you might not want to automatically login to a site when you are
  47. logged into Facebook.
  48. This module has a "manual" setting for "Login / Logout" mode to give users
  49. that option.
  50. If you select "manual" there are two options for the name of the button.
  51. - "Not Logged into Facebook" satisfies cases 1 - 3. The default button says
  52. "Connect".
  53. - "Logged into Facebook and Registered but not Logged into This Site" satisfies
  54. case 4. The default is "Login" and also provides the user name which is
  55. made available by Facebook.
  56. -- FAQ --
  57. Q: How to skip linking local account to FB account?
  58. A: Enable "Disable linking accounts during registration" checkbox on admin/config/people/fbconnect/apperance page
  59. Q: Why the connect button does not appear?
  60. Q: Facebook Connect dialog says: "Invalid Argument: Given URL is not allowed by the Application configuration".
  61. A: Check 5th step of installation instructions. Check for error messages on page admin/reports/status.
  62. Q: Fbconnect redirects to the Facebook homepage in popup
  63. Q: I'm getting error "Application Unavailable - The application you are trying to access is unavailable or restricted"
  64. A: Try to disable all other facebook* modules. If you're using fb_social you have to enable fbconnect_fb_social.
  65. Q: Cannot login to drupal site after sucessully logged in to Facebook.
  66. A: Check your Application Secret on admin/config/people/fbconnect page.
  67. Q: Fbconnect Causes W3C XHTML Validation To Fail
  68. A: http://drupal.org/node/365584#comment-3539890
  69. Still did not solve problem ? Disable other facebook* related modules, check admin/reports/status page, php logs,
  70. post issue on http://drupal.org/project/issues/fbconnect