Howto setup services - Pistos/diaspora GitHub Wiki

Setup services on your Pod

General

First copy config/oauth_keys.yml.example to config/oauth_keys.yml and open it in an editor.

Twitter

width=500px

  • Register your app
    width=500px
    • 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
    • Leave the application type at Browser
    • Important: Set the callback URL to the domain under which your pod is running (including http:// or https://)
    • Set default access type to "Read & Write"
    • There is a Captcha ;)
    • Click "Register application"
  • You now can see your consumer key and your consumer secret, copy them to the right places in config/oauth_keys.yml
    width=500px
  • Restart Diaspora on your sever (you can skip that when you want to also add support for more services)
  • You're done. It's now possible to post to Twitter from your pod :)

Tumblr

  • Goto http://www.tumblr.com and sign up. If you already have an account get sure you're signed in.
  • Goto http://www.tumblr.com/oauth/register
    width=500px
    • Give it a name
    • 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
    • Give it a description
    • Enter an 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 http://example.org enter http://example.org/auth/tumblr/callback
    • You can upload an icon but that's optional
    • Click register
  • You'll be redirected to http://www.tumblr.com/oauth/apps where you can see your consumer key. After a click on "Show secret key" you can see your consumer secret. Add both to the right places in config/oauth_keys.yml
  • Restart Diaspora on your sever (you can skip that when you want to also add support for more services)
  • You're done. It's now possible to post to Tumblr from your pod :)

Facebook

  • Goto http://developers.facebook.com/setup/
  • Choose a name, for example "Diaspora at example.org"
  • Set the site address to your pod URL including a trailing /, for example http://example.org/
  • Choose a language
  • Click on + Create New App
  • Fill the Captcha
  • It will now give you your app id and your app_secret which you have to set in your config/oauth_keys.yml
  • Go to https://developers.facebook.com/apps/app_id/summary
  • Under Basic Services > App Domain fill the domain of your pod (without http://)
  • Click Website and fill in your pod's Site URL, then click Save Changes.
  • Restart Diaspora on your server
  • You're done. It's now possible to post to Facebook from your pod :)