forked from friendica/friendica-addons
9e05e03a04
Support for Facebook's Real-Time Updates
CatoTH - you might wish to consider moving delete_url to include/network.php, but since that is in a separate repository best to wrap it in "if (! function_exists('delete_url')) ..." in case somebody git updates the addon at a different time than the main code.
45 lines
2.6 KiB
Plaintext
Executable file
45 lines
2.6 KiB
Plaintext
Executable file
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)
|