mirror of
https://git.friendi.ca/friendica/friendica-addons.git
synced 2024-12-26 21:20:18 +00:00
1405c0c637
admin account, and will therefore need to do things in .htconfig.php So, restore the .htconfig.php method as "If you prefer..."
52 lines
2.5 KiB
Text
Executable file
52 lines
2.5 KiB
Text
Executable file
Installing the Friendica/Facebook connector
|
|
|
|
1. Visit https://developers.facebook.com/apps to register an app.
|
|
a) Click "Create a new app"
|
|
b) We'd be very happy if you include "Friendica" in the application name
|
|
to increase name recognition.
|
|
c) Edit your app settings on the setup page. The Friendica icons are 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.
|
|
d) In the App Display name enter the name of your app (this should default to the
|
|
name you chose in part a).
|
|
e) Enter YourDomain.com in the App Domain field and hit return.
|
|
f) In "Select how your app connects with Facebook select "Website" and enter the
|
|
full URL to your Friendica install including HTTPS and a trailing slash.
|
|
|
|
2. Enable the Facebook plugin by clicking on the icon next to it's name on the plugin
|
|
page of your admin panel.
|
|
b) return to the Facebook plugin page in your admin panel, and fill in the App-ID
|
|
and Application Secret settings you got from Facebook.
|
|
c) Click save.
|
|
d) Finally, return to the Facebook settings page, and activate real-time updates.
|
|
|
|
i. If you for any reason prefer to use a configuration file instead of the admin panels,
|
|
Activate the plugin by including it in .htconfig.php, e.g.
|
|
|
|
$a->config['system']['addon'] = 'plugin1,plugin2,facebook';
|
|
|
|
and set the following values:
|
|
$a->config['facebook']['appid'] = 'xxxxxxxxxxx';
|
|
$a->config['facebook']['appsecret'] = 'xxxxxxxxxxxxxxx';
|
|
|
|
Replace with the settings Facebook gives you.
|
|
|
|
|
|
3. To use the Facebook plugin, visit the "connector settings" area of your settings
|
|
page. Click "Install Facebook Connector".
|
|
4. This will ask you to login to Facebook and allow the plugin to do it's stuff.
|
|
Allow it to do so.
|
|
5. 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)
|