facebook/README~

   1 Installing the Friendica/Facebook connector
   2
   3 1. Visit https://developers.facebook.com/apps to register an app.
   4     a) Click "Create a new app"
   5     b) We'd be very happy if you include "Friendica" in the application name
   6        to increase name recognition.
   7     c) Edit your app settings on the setup page.  The Friendica icons are present
   8        in the images directory and may be uploaded as a Facebook app icon.  Use
   9        images/friendica-16.jpg for the Icon and images/Friendica-128.jpg for the logo.
  10     d) In the App Display name enter the name of your app (this should default to the
  11        name you chose in part a).
  12     e) Enter YourDomain.com in the App Domain field and hit return.
  13     f) In "Select how your app connects with Facebook select "Website" and enter the
  14        full URL to your Friendica install including HTTPS and a trailing slash.
  15
  16 2.    Enable the Facebook plugin by clicking on the icon next to it's name on the plugin
  17       page of your admin panel.
  18    b) return to the Facebook plugin page in your admin panel, and fill in the App-ID
  19       and Application Secret settings you got from Facebook.
  20    c) Click save.
  21    d) Finally, return to the Facebook settings page, and activate real-time updates.
  22
  23 3.    To use the Facebook plugin, visit the "connector settings" area of your settings
  24       page.  Click "Install Facebook Connector".
  25 4.    This will ask you to login to Facebook and allow the plugin to do it's stuff.
  26       Allow it to do so.
  27 5.    You're done. To turn it off visit the Plugin Settings page again and
  28       'Remove Facebook posting'.
  29
  30 Vidoes and embeds will not be posted if there is no other content. Links
  31 and images will be converted to a format suitable for the Facebook API and
  32 long posts truncated - with a link to view the full post.
  33
  34 Facebook contacts will not be able to view private photos, as they are not able to
  35 authenticate to your site to establish identity. We will address this
  36 in a future release.
  37
  38 Info: please make sure that you understand all aspects due to Friendica's
  39 default licence which is: MIT License (further info:
  40 https://github.com/friendica/friendica/blob/master/LICENSE)