]> git.mxchange.org Git - friendica-addons.git/blob - facebook/README
Merge branch 'apull'
[friendica-addons.git] / facebook / README
1 Installing the Friendika/Facebook connector
2
3 1. register an API key for your site from developer.facebook.com
4   a. We'd be very happy if you include "Friendika" in the application name
5      to increase name recognition. The Friendika icons are also present
6      in the images directory and may be uploaded as a Facebook app icon.
7      Use images/friendika-16.jpg for the Icon and images/friendika-128.jpg for the Logo.
8   b. The url should be your site URL with a trailing slash.
9      You may use http://portal.friendika.com/privacy as the privacy policy
10      URL unless your site has different requirements, and 
11      http://portal.friendika.com as the Terms of Service URL unless
12      you have different requirements. (Friendika is a software application
13      and does not require Terms of Service, though your installation of it might).
14   c. Set the following values in your .htconfig.php file
15         $a->config['facebook']['appid'] = 'xxxxxxxxxxx';
16         $a->config['facebook']['appsecret'] = 'xxxxxxxxxxxxxxx';
17      Replace with the settings Facebook gives you.
18   d. Navigate to Set Web->Site URL & Domain -> Website Settings.  Set Site URL 
19      to yoursubdomain.yourdomain.com.  Set Site Domain to your yourdomain.com.
20 2. Enable the facebook plugin by including it in .htconfig.php - e.g. 
21     $a->config['system']['addon'] = 'plugin1,plugin2,facebook';
22 3. Visit the Facebook Settings section of the "Settings->Plugin Settings" page.
23    and click 'Install Facebook Connector'.
24 4. This will ask you to login to Facebook and grant permission to the 
25    plugin to do its stuff. Allow it to do so. 
26 5. You're done. To turn it off visit the Plugin Settings page again and
27    'Remove Facebook posting'.
28
29 Vidoes and embeds will not be posted if there is no other content. Links 
30 and images will be converted to a format suitable for the Facebook API and 
31 long posts truncated - with a link to view the full post. 
32
33 Facebook contacts will not be able to view private photos, as they are not able to
34 authenticate to your site to establish identity. We will address this 
35 in a future release.
36
37 Info: please make sure that you understand all aspects due to Friendika's 
38 default licence which is: Creative Commons Attribution 3.0 (further info:
39 http://creativecommons.org/licenses/by/3.0/ )