Setup Twitter integration

From JReviews Documentation
Revision as of 17:59, 24 January 2013 by Jreviews (Talk | contribs)

Jump to: navigation, search


The JReviews integration with Twitter allows you to create incremental traffic to your site by posting updates to *your* Twitter account based on user submitted actions.


Which actions will generated a Twitter update?

Currently the actions supported by this integration are submissions of new listings, reviews and review comments.

With any of the above actions there will be a Twitter update to your account linking back to the related page on your site. For moderated submissions the updates will be posted on moderator approval.

How to setup the Twitter Integration NEW

First you need to create a Twitter app. Go to http://developer.twitter.com and log in. Under your username click on "My Applications" link:

Twitter1.png


On the next page click the Create a new application button:

Twitter2.png


Then fill in your app details:

Twitter3.png

On this page you'll need to accept "Developer Rules", fill in captcha and click the Create your Twitter application button at the bottom.

On the next page click on the Settings tab and choose Read & Write for app access:

Twitter4.png

At the bottom of the page click Update this Twitter's application setting button and then return to the first tab.

On the first tab click Create my access token button and reload the page.

Now you have all required app information that you need to enter in JReviews Configuration settings:

  • Consumer Key
  • Consumer Secret
  • Access Token
  • Access Token Secret

Twitter5.png


Integrating bit.ly

For the automatic tweets to include links to the listings on your site, you also need a bit.ly account. Make sure to create a real account instead of using your Twitter account to access bit.ly.

In JReviews Configuration you will need to enter your bit.ly username and API Key. To find the API Key, in your bit.ly account click on the Settings link, go to the Advanced tab and click the Show legacy API key link:

Bitly.png


Troubleshooting

If the twitter integration is not working, these are the first things you need to check:

1) Make sure your Twitter App has Read & Write access.

2) Make sure you entered the callback url as shown above.

3) Make sure your server time settings are correct. If the server time settings are different than those of Twitter then the Oauth athentication will result in a 401 error. More details about this problem can be read here https://github.com/abraham/twitteroauth/issues/44