forked from GNUsocial/gnu-social
109 lines
3.4 KiB
Plaintext
109 lines
3.4 KiB
Plaintext
Facebook Bridge Plugin
|
|
|
|
The Facebook Bridge plugin allows you to integrate your StatusNet site
|
|
with Facebook. It uses Facebook's new SDKs, the Graph API and OAuth
|
|
2.0, and supercedes the previous "Facebook" plugin, which relied on the
|
|
Facebook's now deprecated "Old REST API". The other major difference is
|
|
the troublesome and confusing Facebook Canvas Application has been
|
|
removed.
|
|
|
|
Note: Do NOT try to run the old Facebook plugin and this plugin at the same
|
|
time. It won't work.
|
|
|
|
Features for the new Facebook Bridge Plugin:
|
|
|
|
- "Login with Facebook" (AKA single-sign-on using Facebook Connect for
|
|
authentication).
|
|
|
|
- Registration with Facebook Connect, including automatic profile creation
|
|
based on users' Facebook accounts.
|
|
|
|
- Post mirroring -- posting a notice on StatusNet automatically creates a post
|
|
on Facebook, deleting it on StatusNet deletes it on Facebook, and faving it
|
|
"likes" it on Facebook.
|
|
|
|
|
|
Upgrading from the old Facebook plugin
|
|
======================================
|
|
|
|
Remove the addPlugin('Facebook') statement for the old Facebook plugin
|
|
from your config.php and adjust your existing Facebook application using
|
|
the setup instructions below as a guide, then enable the new plugin (also
|
|
described below). Existing users who have setup post mirroring shouldn't
|
|
have to do anything. The new Facebook Bridge plugin will keep their notices
|
|
flowing to Facebook.
|
|
|
|
Setup
|
|
=====
|
|
|
|
There are two parts configuring the Facebook Bridge plugin -- setup on the
|
|
Facebook side, and setup on the StatusNet side.
|
|
|
|
Setup (Facebook side)
|
|
=====================
|
|
|
|
The first step is to login to Facebook and register a Facebook application
|
|
to get an application ID and secret.
|
|
|
|
Use the handy Facebook application setup wizard:
|
|
|
|
http://developers.facebook.com/setup/
|
|
|
|
Once you've set up your application, you'll need to enter the Facebook Developer
|
|
dashboard (http://www.facebook.com/developers/editapp.php?app_id=YOUR_APPLICATION_ID)
|
|
and customize a few things:
|
|
|
|
About tab
|
|
---------
|
|
|
|
Set your logos, application description, etc. as you see fit.
|
|
|
|
Web Site tab
|
|
------------
|
|
|
|
Make a note of the "Application ID" and "Application Secret" Facebook generated
|
|
for your application. You'll need both of those later.
|
|
|
|
Make sure "Site URL" points to your StatusNet installation
|
|
(e.g.: http://example.net/).
|
|
|
|
- Special Note for multi-site Status Networks: enter your domain (SLD and TLD)
|
|
in the "Site Domain" field. (e.g.: status.net). This will allow a single
|
|
Facebook Application to work with all your network subdomains (*.status.net).
|
|
|
|
Facebook Integration tab
|
|
------------------------
|
|
|
|
Use the default settings.
|
|
|
|
Mobile and Devices tab
|
|
----------------------
|
|
|
|
Use the default settings.
|
|
|
|
Advanced tab
|
|
------------
|
|
|
|
In the Authentication section, set the "Deauthorize Callback" to
|
|
http://YOURSITE/facebook/deauthorize (e.g.: http://example.net/facebook/deauthorize).
|
|
|
|
In the Migrations section, ensure that "OAuth 2.0 for Canvas" is set to
|
|
"Enabled". It probably already will be, but double check.
|
|
|
|
The default settings should suffice for everything else.
|
|
|
|
Setup (StatusNet side)
|
|
======================
|
|
|
|
To enable the Facebook Bridge plugin, add
|
|
|
|
addPlugin('FacebookBridge');
|
|
|
|
to you config.php.
|
|
|
|
Next login to your StatusNet site as a user with the administrator role, and
|
|
navigate to the admin menu. You should see a new tab for the Facebook admin
|
|
panel, titled "Facebook". Enter your Facebook application ID and secret in
|
|
that admin panel and hit save. After that, the Facebook Bridge Plugin should
|
|
be ready to use.
|