From 29fca62ede56a3a692e3b6937249a121d08685f2 Mon Sep 17 00:00:00 2001 From: MartinFarrent Date: Sun, 1 Apr 2012 03:32:34 -0700 Subject: [PATCH] =?UTF-8?q?Updated=20How=20to:=20Friendica=E2=80=99s=20Fac?= =?UTF-8?q?ebook=20connector=20(markdown)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- How-to:-Friendica’s-Facebook-connector.md | 40 ++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/How-to:-Friendica’s-Facebook-connector.md b/How-to:-Friendica’s-Facebook-connector.md index f3f25ed..0fe7e56 100644 --- a/How-to:-Friendica’s-Facebook-connector.md +++ b/How-to:-Friendica’s-Facebook-connector.md @@ -1,4 +1,3 @@ - ### Configuring the Facebook connector as a user _Note: Special admin instructions are at the end of this document. The first sections are for all users._ @@ -67,3 +66,42 @@ The Facebook connector polls Facebook once a day to discover whether you have an ## Installing the Facebook connector on your own site (for admins only) 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._ +