“OAuth Twitter for WordPress” Documentation by “Michael Strong” v1.0


“OAuth Twitter”

Created: 28th February 2013
By: Michael Strong
Email: micmania@hotmail.co.uk

Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here.


Table of Contents

  1. Features
  2. Quick Start
  3. Installation
  4. Setup
  5. Twitter Application Setup
  6. Display Your Tweets (Enable the widget)
  7. Embedding tweets with shortcodes

Features - top

OAuth Twitter is a plugin which provides a configurable widget to display a list of recent tweets from a given Twitter account. Within the widget you can set which account to display tweets for as well how many you would like to display.

This plugin has been built to work with Twitter API v1.1 and should fit right into any well built WordPress theme.


Quick Start - top

This quick start is aimed at the more techinical users who are comfortable installing plugins and managing widgets. Full & complete instructions can be found below.

  1. Login to your WordPress dashboard as an Administrator.
  2. Go to the Plugins sections and add a new plugin. You'll be able to install the plguin from the downloaded zip file.
  3. Remember to activate the plugin once installed.
  4. Once activated go to Settings > OAuth Twitter
  5. On this screen you will see that four fields are required. You can get these by setting up a Twitter Application.
  6. When all 4 fields are complete you can go to Appearance > Widgets and create a 'Latest Tweets' widget.
  7. The widget options are as follows:
    • Title: The title you would like to appear above your tweets.
    • Screen Name: This is the Twitter username (without the @) of the user whose tweets you would like to list.
    • How many tweets? This sets how many tweets you would like to display.
    • Show Date? This sets whether or not to show the time passed since the tweet was made.

Installation - top

To install the OAuth Twitter plugin you must upload it to the plugin directory of your WordPress blog. You can do this many ways, but the simplest is through your WordPress administrator Dashboard.

  1. Login to your WordPress dashboard.
  2. Go to Plugins > Add New in the left column.
  3. Click 'Upload' in the options just under the page title.
  4. Select the .zip file you downloaded from CodeCanyon and upload it.
  5. Once you've done this you will need to activate it.

That's it! You should be done.

If you need any further help installing your plugin, here are a few useful llinks which may be able to help:
http://www.wpbeginner.com/beginners-guide/step-by-step-guide-to-install-a-wordpress-plugin-for-beginners/ http://urbangiraffe.com/articles/how-to-install-a-wordpress-plugin/


Setup - top

Twitter have recently changed their API so that any requests made to it must be authenticated. This basically means you will need to setup an application on Twitter and copy over a few details for the widget to work. Here's how to setup your application:

  1. Go to Twitter's developer website and sign in using your normal Twitter account.
  2. Navigate to 'My applications' which can be found by hovering over your name in the toolbar and clicking 'Create a new application'.
  3. On this page there are 4 required fields which includes Callback URL. Here's an example setup:
    • Name: My WordPress Blog
    • Description: An application to integrate My WordPress Blog with Twitter.
    • Website: http://www.mywordpressblog.com (This should match the URL of your blog).
    • Callback URL http://www.mywordpressblog.com (This can match the website field value).

Once you have setup your application, make a note of your Consumer Key and Consumer Secret as you will need to enter these into your WordPress blog.

No you've completed the setup of your application you can go back to your WordPress dashboard and naviagte to Settings > OAuth Twitter. From here you will be able to enter your Consumer Key and Consumer secret. You can leave the Access Token and Access Secret blank for now. Click save and wait for the page to refresh.

When your consumer tokens have been saved, you will see an 'Autofill' link appear next to the access tokens. You can click this link to automatically fill in the Access fields which are required for the widget to function. Note that when you click the link, you will be asked to login with your Twitter account. This is all part of the authentication process required by Twitter.


Display Your Tweets (Enable the Widget) - top

Now that you've completed the plugin setup you're able to display tweets on your selected pages. To do this you will need to add the 'Latest Tweets' widget to the sections you wish to display your tweets.

To add the widget navigate to Appearance > Widgets inside your WordPress dashboard. Drag the 'Latest Tweets' Widget from the 'Available Widgets' section into a Widget Area on the left. To find out which area(s) you should drag the widget into, consult your theme author or theme documentation.

When you have your theme in the desired theme area you will be given 4 options by the widget. These options are as follows:

When you've finished setting up the widget, remember to click 'Save'. This will make the widget live and display the tweets in the desired location on your blog.

To display multiple tweet feeds in different place, simple follow this process again. There is no limit on the amount of feeds you can have in one area or blog.

For more information on how to add a widget, this video may help:


If you have further queries which aren't answered in this documentation, please feel free to contact me via themeforest.


Shortcodes - top

OAuth Twitter comes with a [twitterfeed] shortcode so that you can add your most recent tweets into any blog post or content field. The shortcode comes with a few customizable attributes including the ability to override the default styles & control the number of tweets to fetch. See below for details:

Displays the latest tweet from @twitter: [twitterfeed]twitter[/twitterfeed]

Displays the 2 latest tweets from @twitter: [twitterfeed count="2"]twitter[/twitterfeed]

Overwrite the default styles: [twitterfeed class="mycustomclass"]twitter[/twitterfeed]

Add an id the the tweet holder: [twitterfeed id="mycustomid"]twitter[/twitter]

Show the time since the tweet was made: [twitterfeed showdate="true"]twitter[/twitterfeed]

Use multiple attributes: [twitterfeed count="2" class="mycustomclass" id="mycustomid" showdate="true"]twitter[/twitterfeed]


Michael Strong

Go To Table of Contents