How to: Friendica’s Facebook connector
Note: Special admin instructions are in the second part this document. The first section is for all users.
The Facebook connector is an addon which allows you to interact with friends on Facebook from within Friendica. It is a very powerful feature – because it works in both directions. You can post to Facebook and see the comments your Facebook friends make, and you can see your Facebook friends’ own threads and comments from Friendica, too.
It’s almost as if your Facebook contacts had become Friendica users themselves. And you don’t even have to configure contacts separately – your entire Facebook friend list imported, and updated if new friends are added.
Activating the Facebook connector for your user account
Assuming that your admin has installed the Facebook connector, it can be enabled by going to Settings > Connector Settings > Facebook Connector Settings. When you use it for the first time, you will be taken to Facebook for confirmation.
Configuring the Facebook connector (Facebook side)
Enter your Facebook user name and password and let the application (the connector) do everything the options suggest.
While on the Facebook side of things, also figure out who should be able to see posts from Friendica to Facebook – a fairly sound suggestion would be your Facebook friends. This setting only takes effect when your Friendica post is public – not when you post to a private group you have defined in Friendica.
So assuming you accept the above suggestion, a public Friendica post would now also go to all your friends on Facebook (but needn't, if you don't want it to - more on that later).
But a Friendica post to a group that includes just two Facebook friends would only be visible to those two friends on Facebook (and anyone else in the group on other networks).
Configuring the Facebook connector (Friendica side)
Once you have clicked okay on Facebook, you will be returned to the Friendica configuration panel for the connector.
There are four options here:
Post to Facebook by default – If you select this, all your public posts will also go to Facebook – unless you choose otherwise on a per-post basis. If you don’t select it, your public posts will only go to Facebook if you tick the appropriate box in the post editor’s privacy settings on a post-by-post basis. Posts to private groups that you have defined and which include Facebook contacts will always go to those contacts, regardless of what you select here.
Link all your Facebook friends and conversations on this website – You will most probably want to tick this one in order to see what your Facebook friends are doing from within Friendica (the connector usually doesn’t make much sense without it).
The next two options concern your own Facebook wall.
Check On this website your Facebook profile wall conversations will only be visible to you, if you want to see your own posts (ones you publish on Facebook itself or send there via another connector) in your Friendica stream, along with comments from your Facebook friends. You will then see that content personally, but others on Friendica won’t be able to. They will only see the posts you issue from Friendica itself. For most people, this is a sensible option to check (more about that in a moment).
Do not import your Facebook profile wall conversations – Activating this option means that no one – not even you – will see the conversations you initiate on Facebook itself in their Friendica browsers. Most people will probably want to leave this option unchecked.
Activating neither of those two options means that your Facebook profile wall will be merged with your profile wall on Friendica – and your privacy settings on Friendica will be used to determine who may see the conversations.
This can be very annoying to your contacts in some cases!
Example: If you are cross-posting a lot using other connectors, a Friendica post may go to your blog on Wordpress and from there to Facebook as well. But when it is published on Facebook that way, Friendica will treat it as a separate post – and your contacts on Friendica will probably see two identical versions of it within a short space of time (along with pix or video links). This kind of duplication will irritate some and confuse others – and entertain almost no one. ;)
Removing or re-authenticating the Facebook connector
To remove the Facebook connector, click the appropriate link on its settings page. There is also a link there to re-authenticate the connector with Facebook. This is necessary whenever your Facebook password is changed.
Status updates
Status updates from your Facebook friends will arrive once an hour. Comments you make to Facebook or posts you send there usually appear there within one or two minutes.
If the site admin has activated the real-time option for the Facebook connector, many things will work much faster. Specifically, anything that is visible on your own Facebook wall becomes almost instantly visible on Friendica, too: threads you start over there, comments you make, mentions/tags etc.
Contact updates
The Facebook connector polls Facebook once a day to discover whether you have any new friends there – or have lost any.
If you run your own Friendica site, you will have to work a little harder to establish Facebook connectivity. But the steps are actually very simple.
Become a Facebook developer
First of all, you need to be a Facebook member yourself. Then, you need to become a Facebook developer. That might strike you as strange, because you’re not actually developing anything, but that’s the way it is. Facebook views the connector as a Facebook app you have developed and are registering.
Here’s where to go to become a Facebook developer: http://developers.facebook.com/
In the course of this process, you will be able to use your standard Facebook identity (name and password), but will be asked to provide additional verification by giving Facebook a credit card or mobile phone number.
This doesn’t mean that Facebook is going to charge you any money.
It does mean that Facebook now knows one more thing about you. Many Friendica admins consider their mobile phone numbers less secret and sensitive than their credit card numbers.
Register the Friendica connector as an app
What the Facebook connector needs in order to work is an App ID and an App Secret. When Facebook gives you these at the end of the registration process, you will be copying them to the connector’s administration panel in Friendica.
To get these codes, you create a new application on the Facebook developers’ site and give it a nice name like My Friendica Bridge. You needn’t give it a name space and you don’t need web hosting for it, so you can leave those two fields blank when the first dialog box appears.
At the top of the application page you see next, you can assign an icon and a logo to the application. Use http://your-friendica-site/images/friendika-16.png for the icon and http://your-friendica-site/images/friendika-128.png for the logo (inserting the address for your own site).
You also need to enter your email address and the address for your Friendica site. Setting the type of application to web site, simply enter the address with a trailing slash: http://your-friendica-site/
When you have confirmed and saved all your entries, you will be given the desired_ App ID_ and _App Secre_t.
Configure the plugin on Friendica
Friendica now gives you a convenient admin panel for the plugin, so you no longer need to edit .htconfig.php manually, as formerly necessary and possibly prescribed in your help files.
All you need to do is go to your Administration settings and visit the Plugins. Click to activate the Facebook Connector, then click on its name to configure it. You’ll see the two fields where you can enter the App ID and App Secret you have just received. Copy them to those fields and hit Save.
At this point, it’s a very good idea to Activate Real-Time Updates to get Facebook posts as they happen. If you don’t, the default Facebook poll interval is one hour. (This interval can be decreased, but that would affect system resources dramatically and could make the system un-useable depending on the number of Facebook streams/items to process. With real-time updates, system resource usage will be significantly lower overall.)
Now, all members of your site can use the Facebook connector as described in the first sections of this document.
This applies to you, too! While you have now activated the plugin for your site, you haven’t yet activated it for yourself as a user. Follow the steps at the beginning of this document to do that.