Brought README up to date.

This commit is contained in:
Thomas Willingham 2012-04-04 18:32:04 +01:00
parent 5c37a8a7ca
commit 098330df30

View file

@ -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