We are no longer offering accounts on this server. Consider https://gitlab.freedesktop.org/ as a place to host projects.

README 2.7 KB
Newer Older
1
This plugin allows you to utilize Facebook Connect with StatusNet.
2 3 4
Supported Facebook Connect features:

- Authenticate (register/login/logout -- works similar to OpenID)
5 6
- Associate an existing StatusNet account with a Facebook account
- Disconnect a Facebook account from a StatusNet account
7 8 9

Future planned functionality:

10 11 12
- Invite Facebook friends to use your StatusNet installation
- Auto-subscribe Facebook friends already using StatusNet
- Share StatusNet favorite notices to your Facebook stream
13 14

To use the plugin you will need to configure a Facebook application
15
to point to your StatusNet installation (see the Installation section
16 17 18 19 20 21 22 23 24 25 26 27 28
below).

Installation
============

If you don't already have the built-in Facebook application configured,
you'll need to log into Facebook and create/configure a new application.
Please follow the instructions in the section titled, "Setting Up Your
Application and Getting an API Key," on the following page of the
Facebook developer wiki:

    http://wiki.developers.facebook.com/index.php/Connect/Setting_Up_Your_Site

29
If you already are using the build-in StatusNet Facebook application,
30 31 32
you can modify your existing application's configuration using the
Facebook Developer Application on Facebook.  Use it to edit your
application settings, and under the 'Connect' tab, change the 'Connect
33
URL' to be the main URL for your StatusNet site.  E.g.:
34

35
    http://SITE/PATH_TO_STATUSNET/
36 37

After you application is created and configured, you'll need to add its
38
API key and secret to your StatusNet config.php file:
39 40 41 42 43 44 45

    $config['facebook']['apikey'] = 'APIKEY';
    $config['facebook']['secret'] = 'SECRET';

Finally, to enable the plugin, add the following stanza to your
config.php:

46
    addPlugin('FBConnect');
47 48 49

To try out the plugin, fire up your browser and connect to:

50
    http://SITE/PATH_TO_STATUSNET/main/facebooklogin
51 52 53

or, if you do not have fancy URLs turned on:

54
    http://SITE/PATH_TO_STATUSNET/index.php/main/facebooklogin
55 56 57 58 59 60 61 62 63 64

You should see a page with a blue button that says: "Connect with
Facebook".

Connect/Disconnect existing account
===================================

If the Facebook Connect plugin is enabled, there will be a new Facebook
Connect Settings tab under each user's Connect menu. Users can connect
and disconnect to their Facebook accounts from it.  Note:  Before a user
65
can disconnect from Facebook, she must set a normal StatusNet password.
66 67
Otherwise, she might not be able to login in to her account in the
future.  This is usually only required for users who have used Facebook
68
Connect to register their StatusNet account, and therefore haven't
69 70 71 72 73 74 75 76
already set a local password.

Helpful links
=============

Facebook Connect Homepage:
http://developers.facebook.com/connect.php