Integrating other social networks

General

Keys will be entered into your config/diaspora.yml

Twitter

Go to https://apps.twitter.com and sign in
Click on ‘Create an app’

Create an app on Twitter
Register your app

Register your app
- Give it a name. For example "Diaspora at example.org"
- Give it a description
- Set the application website to your pod URL or a page that describes what Diaspora is and what your pod has to do with it
- Important: Set the callback URL to https://your_pod/auth/twitter/callback, replacing your_pod of course.
- There’s a ToS to accept
- There is a Captcha ;)
- Click “Create Twitter application”
Click the “Permissions” tab and change the “Access” to “Read and Write”.
Click the “Keys and Access Tokens” tab. You now can see your “Consumer Key” and your “Consumer Secret”, copy them to the right places in config/diaspora.yml
Restart Diaspora on your sever
(You can skip that if you plan to also add support for more services. Just remember to do it once you're finished with all of them.)
You’re done. It’s now possible to post to Twitter from your pod :)

Tumblr

Goto Tumblr Apps page
- Enter your Application Name (eg. “Diaspora at social.example.org”)
- Enter the Application website (eg. https://social.example.org)
- Enter the Administrative contact email address
- Important: Set the “Default callback URL” to your pod url (including http/https)+ /auth/tumblr/callback So if your pod is located at https://social.example.org enter https://social.example.org/auth/tumblr/callback
- You can upload an Icon if you wish
- Click register
You’ll be redirected to the Application Overview where you can see your "OAuth Consumer Key". Click on “Show secret key” to reveal your Secret Key.
Copy your OAuth Consumer Key and your Secret Key App to your config/diaspora.yml
Restart Diaspora on your server
You’re done. It’s now possible to post to Tumblr from your pod :)

Facebook

Goto Facebook Developers page and click "Add a New App"
Choose the "Website" option
Type a name for your App (eg. “Diaspora at social.example.org”) and click "Create New Facebook App ID"
Choose a category (eg. Communication) and click "Confirm"
Fill in the "Site URL" and "Mobile Site" URLs. You can use the same URL for both (eg. https://social.example.org) and click "Next"
Your App has now been created.
Return to the Facebook Developers home page and click the "Apps" dropdown menu and select your new App
The App ID is visible by default but the App Secret is hidden. Click on "Show" and re-enter your password to reveal the App Secret
Copy your App ID and your App Secret to your config/diaspora.yml
Click 'Settings'
Add your pod domain (eg. https://social.example.org) to "App Domains" and add your email to the "Contact Email"
Click "Save Changes"
Restart Diaspora on your server
You’re done. It’s now possible to post to Facebook from your pod

Privacy of posts to Facebook

Any posts a user makes from a pod to Facebook will be made with the privacy level that the users sets on Facebook side when the user authorizes the diaspora* pod application. Posts done from diaspora* do not follow the privacy of selected aspects on diaspora* side. This behaviour is consistent with posting to Twitter etc where the target application governs the privacy of the post.

Wordpress

Go to the Wordpress.com Developer site and create a new application
Add a name, a description (like "This application allows to post from the diaspora* social network to wordpress.com or any wordpress blog with jetpack enabled.") and an url.
Set callback url to http://[your pod]/auth/wordpress/callback (tip: Wordpress doesn't let you specify a callback url beginning with localhost when you first create the app, but (for now, anyway) you can create the app with any url you want, and then edit it later to use a local url.)
Choose the type "web"
Edit the following lines in config/diaspora.yml:

 wordpress:
   enable: true
   client_id: 'app_client_id'
   secret: 'app_secret'

It is now possible to cross-post to any Wordpress.com or Jetpack-enabled Wordpress.org blog.