Updated How to: Friendica’s Facebook connector (markdown)

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._
+