friendica-addons/facebook
Tobias Hößl 1b1237d97c FEATURE: AppID/Secret can now be entered on the plugin's admin page. BUG: if a connected FB-App is deleted and a new FB-App is connected, the app_access_token of the former App remained in the config and made it impossible to activate Real-Time Updates with the new App. USABILITY: Now the user's connector settings page automatically recognizes if the connection is still valid and acts accordingly. SECURITY: XSRF-Protection. 2012-04-01 07:42:50 +00:00
..
facebook.css permission change 644 to 755 for addons 2012-01-21 15:19:22 -08:00
facebook.php FEATURE: AppID/Secret can now be entered on the plugin's admin page. BUG: if a connected FB-App is deleted and a new FB-App is connected, the app_access_token of the former App remained in the config and made it impossible to activate Real-Time Updates with the new App. USABILITY: Now the user's connector settings page automatically recognizes if the connection is still valid and acts accordingly. SECURITY: XSRF-Protection. 2012-04-01 07:42:50 +00:00
README Merge pull request #16 from CatoTH/master 2012-03-08 14:43:22 -08:00

Installing the Friendica/Facebook connector

1. register an API key for your site from developer.facebook.com
  a. We'd be very happy if you include "Friendica" in the application name
     to increase name recognition. The Friendica icons are also present
     in the images directory and may be uploaded as a Facebook app icon.
     Use images/friendica-16.jpg for the Icon and images/friendica-128.jpg for the Logo.
  b. The url should be your site URL with a trailing slash.
     You may use http://portal.friendika.com/privacy as the privacy policy
     URL unless your site has different requirements, and 
     http://portal.friendika.com as the Terms of Service URL unless
     you have different requirements. (Friendica is a software application
     and does not require Terms of Service, though your installation of it might).
  c. Set the following values in your .htconfig.php file
        $a->config['facebook']['appid'] = 'xxxxxxxxxxx';
        $a->config['facebook']['appsecret'] = 'xxxxxxxxxxxxxxx';
     Replace with the settings Facebook gives you.
  d. Navigate to Set Web->Site URL & Domain -> Website Settings.  Set Site URL 
     to yoursubdomain.yourdomain.com.  Set Site Domain to your yourdomain.com.
  e. Chose "Website" (the url should be your site URL with a trailing slash) in the
     "Select how your app integrates with Facebook" section.
2. Enable the facebook plugin by including it in .htconfig.php - e.g. 
    $a->config['system']['addon'] = 'plugin1,plugin2,facebook';
3. Visit the Facebook Settings section of the "Settings->Plugin Settings" page.
   and click 'Install Facebook Connector'.
4. This will ask you to login to Facebook and grant permission to the 
   plugin to do its stuff. Allow it to do so. 
5. Optional step: If you want to use Facebook Real Time Updates (so new messages
   and new contacts are added ~1min after they are postet / added on FB), go to
   Settings -> plugins -> facebook and press the "Activate Real-Time Updates"-button.
6. You're done. To turn it off visit the Plugin Settings page again and
   'Remove Facebook posting'.

Vidoes and embeds will not be posted if there is no other content. Links 
and images will be converted to a format suitable for the Facebook API and 
long posts truncated - with a link to view the full post. 

Facebook contacts will not be able to view private photos, as they are not able to
authenticate to your site to establish identity. We will address this 
in a future release.

Info: please make sure that you understand all aspects due to Friendica's 
default licence which is: MIT License (further info:
https://github.com/friendica/friendica/blob/master/LICENSE)