Difference between revisions of "Twitter Bundles"

(added note about correct callback url, see bug 59098)
(clean up, new screenshots)
 
Line 8: Line 8:
 
* Log into Twitter
 
* Log into Twitter
 
* Click "Create a new application" on the right
 
* Click "Create a new application" on the right
 
'''NOTE''': the callback URL changed recently, it has to be '''https://yxz.mycompany.com/ajax/defer''' and not http://xyz.mycompany.com as seen in the screenshots. Note it is https now and has an added path.
 
 
   
 
   
 
Make sure that you update to the latest version of Open-Xchange Appsuite.
 
Make sure that you update to the latest version of Open-Xchange Appsuite.
Line 22: Line 20:
 
[[File:Twitter_new_02.png]]
 
[[File:Twitter_new_02.png]]
  
[[File:Twitter_new_03.png]]
+
'''Note:''' the callback URL has to be https and with the /ajax/defer path at the end.
  
* In the following overview click "Settings"
+
* In the following overview click "Keys and Access Tokens"
  
 
[[File:Twitter_new_04.png]]
 
[[File:Twitter_new_04.png]]
  
* Change "Access" from "Read only" to "Read and Write"
+
 
 +
* Change in the "Permissions" tab "Read only" to "Read and Write" (should be default)
 +
* Click "Update settings"
 +
 
 +
You can also update:
 
* Fill "Organization name" and "Organization website" if wanted
 
* Fill "Organization name" and "Organization website" if wanted
 
* Upload a custom application icon if wanted
 
* Upload a custom application icon if wanted
* Click "Update this Twitter application´s settings"
 
 
[[File:Twitter_new_05.png]]
 
 
* Copy the String under "Consumer key" and paste it into the file "twitter.properties" as parameter "com.openexchange.twitter.consumerKey" (replacing the existing key there)
 
 
* Copy the String under "Consumer secret" and paste it into the file "twitter.properties" as parameter "com.openexchange.twitter.consumerSecret" (replacing the existing key there)
 
  
[[File:Twitter_new_06.png]]
+
Edit the file /opt/open-xchange/etc/twitteroauth.properties and insert the key and secret from the settings page above, like this:
  
[[File:Twitter_new_07.png]]
+
<pre>
 +
com.openexchange.oauth.twitter.apiKey=0JtyhCeuc7kZotWGx037jxlsG
 +
com.openexchange.oauth.twitter.apiSecret=n8y34hSfeLa0kCizUrcnYjeUg49OfIz7De8SiKZ4TKwfKWYppj
 +
</pre>
  
 
{{InstallPlugin|pluginname=open-xchange-oauth open-xchange-messaging|toplevel=products |sopath=appsuite/stable/backend |version=App Suite}}
 
{{InstallPlugin|pluginname=open-xchange-oauth open-xchange-messaging|toplevel=products |sopath=appsuite/stable/backend |version=App Suite}}
  
{{InstallPlugin|pluginname=open-xchange-oauth-twitter open-xchange-twitter open-xchange-messaging-twitter|sopath=stable}}
+
{{InstallPlugin|pluginname=open-xchange-oauth|sopath=stable}}
  
 
== Configuration ==
 
== Configuration ==

Latest revision as of 09:33, 19 July 2018

Using Twitter with Open-Xchange

Preparation

You MAY want to replace the standard configuration of twitter integration. This depends on whether you want your own company-name to be shown to users during the twitter authentication process. If you want this please follow these steps:

Make sure that you update to the latest version of Open-Xchange Appsuite.

Twitter new 01.png

  • Enter appropriate Information in "Name", "Description", "Website" and "Callback URL". "Callback URL" should be the URL by which the Server is reachable (This is not checked at this moment but may be in the future).
  • Enter the text displayed in the captcha into the textfield below
  • Check "Yes, I agree" under "Developer Rules Of The Road"
  • Click "Create your Twitter application"

Twitter new 02.png

Note: the callback URL has to be https and with the /ajax/defer path at the end.

  • In the following overview click "Keys and Access Tokens"

Twitter new 04.png


  • Change in the "Permissions" tab "Read only" to "Read and Write" (should be default)
  • Click "Update settings"

You can also update:

  • Fill "Organization name" and "Organization website" if wanted
  • Upload a custom application icon if wanted

Edit the file /opt/open-xchange/etc/twitteroauth.properties and insert the key and secret from the settings page above, like this:

com.openexchange.oauth.twitter.apiKey=0JtyhCeuc7kZotWGx037jxlsG
com.openexchange.oauth.twitter.apiSecret=n8y34hSfeLa0kCizUrcnYjeUg49OfIz7De8SiKZ4TKwfKWYppj

Install on OX App Suite

Debian GNU/Linux 10.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/appsuite/stable/backend/DebianBuster/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/stable/backend/updates/DebianBuster/ /

and run

$ apt-get update
$ apt-get install open-xchange-oauth open-xchange-messaging

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/appsuite/stable/backend/DebianBullseye/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/stable/backend/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install open-xchange-oauth open-xchange-messaging


Install on OX AppSuite

Debian GNU/Linux 10.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/stable/DebianBuster/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/stable/updates/DebianBuster/ /

and run

$ apt-get update
$ apt-get install open-xchange-oauth

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/stable/DebianBullseye/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/stable/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install open-xchange-oauth


Configuration