forked from friendica/friendica-addons
Brought README up to date.
This commit is contained in:
parent
5c37a8a7ca
commit
098330df30
|
@ -1,35 +1,31 @@
|
||||||
Installing the Friendica/Facebook connector
|
Installing the Friendica/Facebook connector
|
||||||
|
|
||||||
1. register an API key for your site from developer.facebook.com
|
1. Visit https://developers.facebook.com/apps to register an app.
|
||||||
a. We'd be very happy if you include "Friendica" in the application name
|
a) Click "Create a new app"
|
||||||
to increase name recognition. The Friendica icons are also present
|
b) We'd be very happy if you include "Friendica" in the application name
|
||||||
in the images directory and may be uploaded as a Facebook app icon.
|
to increase name recognition.
|
||||||
Use images/friendica-16.jpg for the Icon and images/friendica-128.jpg for the Logo.
|
c) Edit your app settings on the setup page. The Friendica icons are present
|
||||||
b. The url should be your site URL with a trailing slash.
|
in the images directory and may be uploaded as a Facebook app icon. Use
|
||||||
You may use http://portal.friendika.com/privacy as the privacy policy
|
images/friendica-16.jpg for the Icon and images/Friendica-128.jpg for the logo.
|
||||||
URL unless your site has different requirements, and
|
d) In the App Display name enter the name of your app (this should default to the
|
||||||
http://portal.friendika.com as the Terms of Service URL unless
|
name you chose in part a).
|
||||||
you have different requirements. (Friendica is a software application
|
e) Enter YourDomain.com in the App Domain field and hit return.
|
||||||
and does not require Terms of Service, though your installation of it might).
|
f) In "Select how your app connects with Facebook select "Website" and enter the
|
||||||
c. Set the following values in your .htconfig.php file
|
full URL to your Friendica install including HTTPS and a trailing slash.
|
||||||
$a->config['facebook']['appid'] = 'xxxxxxxxxxx';
|
|
||||||
$a->config['facebook']['appsecret'] = 'xxxxxxxxxxxxxxx';
|
2. Enable the Facebook plugin by clicking on the icon next to it's name on the plugin
|
||||||
Replace with the settings Facebook gives you.
|
page of your admin panel.
|
||||||
d. Navigate to Set Web->Site URL & Domain -> Website Settings. Set Site URL
|
b) return to the Facebook plugin page in your admin panel, and fill in the App-ID
|
||||||
to yoursubdomain.yourdomain.com. Set Site Domain to your yourdomain.com.
|
and Application Secret settings you got from Facebook.
|
||||||
e. Chose "Website" (the url should be your site URL with a trailing slash) in the
|
c) Click save.
|
||||||
"Select how your app integrates with Facebook" section.
|
d) Finally, return to the Facebook settings page, and activate real-time updates.
|
||||||
2. Enable the facebook plugin by including it in .htconfig.php - e.g.
|
|
||||||
$a->config['system']['addon'] = 'plugin1,plugin2,facebook';
|
3. To use the Facebook plugin, visit the "connector settings" area of your settings
|
||||||
3. Visit the Facebook Settings section of the "Settings->Plugin Settings" page.
|
page. Click "Install Facebook Connector".
|
||||||
and click 'Install Facebook Connector'.
|
4. This will ask you to login to Facebook and allow the plugin to do it's stuff.
|
||||||
4. This will ask you to login to Facebook and grant permission to the
|
Allow it to do so.
|
||||||
plugin to do its stuff. Allow it to do so.
|
5. You're done. To turn it off visit the Plugin Settings page again and
|
||||||
5. Optional step: If you want to use Facebook Real Time Updates (so new messages
|
'Remove Facebook posting'.
|
||||||
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
|
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
|
and images will be converted to a format suitable for the Facebook API and
|
||||||
|
|
Loading…
Reference in a new issue