Difference between revisions of "Integrating other social networks"

From diaspora* project wiki
Jump to: navigation, search
(Migrate instructions for setting up service integrations - needs formatting cleanup and images, actual instructions are valid)
 
(Remove Facebook)
 
(37 intermediate revisions by 17 users not shown)
Line 1: Line 1:
= Setup services on your Pod =
+
{{Out of date}}
 +
{{Note|1=I'm not sure the info here is still correct. At least for facebook I think I remember things have changed..? Please check and, if it's still correct, remove these templates. Also, it might be useful to link this page on the main page, in the "podmin resources" list(?) --[[User:Waithamai|waithamai]] <sup>[[User talk:Waithamai|talk]]</sup> 01:21, 30 August 2017 (UTC)}}
  
 
== General ==
 
== General ==
Line 7: Line 8:
 
== Twitter ==
 
== Twitter ==
  
* Go to [[http://dev.twitter.com]] and sign in
+
* Go to [https://apps.twitter.com https://apps.twitter.com] and sign in
* Click on ‘Create an app’ [[Media:https://mrzyx.de/diaspora/twitter1.png|width=700px]]
+
* Click on ‘Create an app’ [[Image:Twitter_1.png|thumb|300px|Create an app on Twitter]]
* Register your app [[https://mrzyx.de/diaspora/twitter2.png|width=700px]]
+
* Register your app [[Image:Twitter_2.png|thumb|300px|Register your app]]
** Give it a name. For example “Diaspora at example.org”
+
** Give it a name. For example "Diaspora at example.org"
 
** Give it a description
 
** 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
 
** 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.
+
** '''Important:''' Set the callback URL to <tt>https://your_pod/auth/twitter/callback</tt>, replacing your_pod of course.
 
** There’s a ToS to accept
 
** There’s a ToS to accept
 
** There is a Captcha ;)
 
** There is a Captcha ;)
 
** Click “Create Twitter application”
 
** Click “Create Twitter application”
* You now can see your consumer key and your consumer secret, copy them to the right places in config/diaspora.yml
+
* Click the “Permissions” tab and change the “Access” to “Read and Write”.
* Go to Settings and change the “Application Type” 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 <tt>config/diaspora.yml</tt>
* Restart Diaspora on your sever (you can skip that when you want to also add support for more services)
+
* Restart Diaspora on your sever <br>(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 :)
 
* You’re done. It’s now possible to post to Twitter from your pod :)
  
 
== Tumblr ==
 
== 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 Tumblr Apps] page
* Goto [[http://www.tumblr.com/oauth/register]]<br />
+
** Enter your Application Name (eg. “Diaspora at social.example.org”)
[[https://mrzyx.de/diaspora/services_tumblr.png|width=500px]]
+
** Enter the Application website (eg. https://social.example.org)
** Give it a name
+
** Enter the Administrative contact email address
** 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 “Default callback URL” to your pod url (including http/https)+ <tt>/auth/tumblr/callback</tt> So if your pod is located at <tt>https://social.example.org</tt> enter <tt>https://social.example.org/auth/tumblr/callback</tt>
** Give it a description
+
** You can upload an Icon if you wish
** 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
 
** 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/diaspora.yml
+
* You’ll be redirected to the [http://www.tumblr.com/oauth/apps Application Overview] where you can see your "OAuth Consumer Key". Click on “Show secret key” to reveal your Secret Key.
* Restart Diaspora on your sever (you can skip that when you want to also add support for more services)
+
* Copy your OAuth Consumer Key and your Secret Key App to your <tt>config/diaspora.yml</tt>
 +
* Restart Diaspora on your server
 
* You’re done. It’s now possible to post to Tumblr from your pod :)
 
* You’re done. It’s now possible to post to Tumblr from your pod :)
  
== Facebook ==
+
== Wordpress ==
  
* Goto [[http://developers.facebook.com/setup/]]
+
* Go to the [https://developer.wordpress.com/apps/ Wordpress.com Developer Site] and click "Create New Application"
* Choose a name, for example “Diaspora at social.example.org”, choose a namespace. Set the namespace in your <tt>config/diaspora.yml</tt> [[https://mrzyx.de/diaspora/facebook1.png|700px]]
+
* 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 the URL of your pod (eg. https://social.example.org)
* Fill the captcha
+
* '''Important:''' Set the “Redirect URL” to your pod url (including http/https)+ <tt>/auth/wordpress/callback</tt> So if your pod is located at <tt>https://social.example.org</tt> enter <tt>https://social.example.org/auth/wordpress/callback</tt>
* If you don’t see your new app reload the page and select it.
+
* Answer the Captcha
* Copy your App ID and your App Secret to your <tt>config/diaspora.yml</tt>.
+
* Choose the type "web"
* Click Edit App
+
* Click on "Create"
* Add your domain to App Domains.
+
* Visit the [https://developer.wordpress.com/apps/ MyApps] page and select your new App
* Check “Website with Facebook Login” and fill in the URL to your pod.
+
* Copy your Client ID and your Client Secret to your <tt>config/diaspora.yml</tt>
* Hit save.
 
 
* Restart Diaspora on your server
 
* Restart Diaspora on your server
* You’re done. It’s now possible to post to Facebook from your pod :)
+
* You’re done. It’s now possible to post to Wordpress from your pod
 +
 
 +
 
 +
== Troubleshooting ==
 +
 
 +
When thing goes wrong, sometimes the solution is very simple. Take a look at some known issues.
 +
 
 +
=== Twitter and Tumblr ===
  
=== Privacy of posts to Facebook ===
+
==== Server date and time ====
  
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.
+
Authentication methods for Twitter and Tumblr use timestamps. If your server time and timezone are not set as expected, then the hash is generated incorrectly and it won't work.
  
 
[[Category:Podmin]]
 
[[Category:Podmin]]

Latest revision as of 23:55, 20 August 2018

»» Out of date
This page's accuracy may be compromised due to out-of-date information.
Please help improve the page by updating it. There may be additional information on the talk page.


»» Note
I'm not sure the info here is still correct. At least for facebook I think I remember things have changed..? Please check and, if it's still correct, remove these templates. Also, it might be useful to link this page on the main page, in the "podmin resources" list(?) --waithamai talk 01:21, 30 August 2017 (UTC)


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
  • 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 :)

Wordpress

  • Go to the Wordpress.com Developer Site and click "Create 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 the URL of your pod (eg. https://social.example.org)
  • Important: Set the “Redirect URL” to your pod url (including http/https)+ /auth/wordpress/callback So if your pod is located at https://social.example.org enter https://social.example.org/auth/wordpress/callback
  • Answer the Captcha
  • Choose the type "web"
  • Click on "Create"
  • Visit the MyApps page and select your new App
  • Copy your Client ID and your Client Secret to your config/diaspora.yml
  • Restart Diaspora on your server
  • You’re done. It’s now possible to post to Wordpress from your pod


Troubleshooting

When thing goes wrong, sometimes the solution is very simple. Take a look at some known issues.

Twitter and Tumblr

Server date and time

Authentication methods for Twitter and Tumblr use timestamps. If your server time and timezone are not set as expected, then the hash is generated incorrectly and it won't work.