About the plugin

Twitter Feed extends the functionality of WordPress to allow the retrieval and displaying of Twitter timelines from any Twitter account in a wide range of ways. This plugin features a unique tweet-caching algorithm that can greatly enhance its performance. This can be useful for high-traffic websites that want to avoid exceeding Twitter rate limits. All the caching and performance options can be modified through the plugin’s administration page.


The full version of the plugin includes the following features:

  • Twitter API 1.1
  • 3 shortcodes + shortcode editor
  • 5 Different Skins
  • 8 Supported Twitter Resoucres
  • Widget
  • Powerful caching system
  • Server-Side rendering for better SEO
  • Load additional tweets via AJAX
  • Tweet customization
  • Tweet actions
  • Tweet media (photos, Animated GIFs, YouTube and Vine videos)
  • 100% responsive
  • Simple & intuitive plugin options page
  • Easy API for developers
  • Usage status tracking tool

InstallationScreen Shot 2015-03-09 at 9.26.24 PM

To install Twitter Feed, go to Plugins -> Add New -> Upload Plugin and choose the file twitterfeed.zip. After the installation process is complete, click activate plugin

The next step is to create a Twitter application and use the provided tokens to setup Twitter Feed. If you don’t know how to create a Twitter application, you can read our tutorial.

After you have your access tokens, you can open the plugin’s administration page by clicking on Twitter Feed on the left sidebar and insert the access tokens there:


Plugin Administration

The admin control panel

The plugin administration panel



This section is where you can input your oAuth access tokens and monitor your usage. Access tokens are required to establish an authenticated connection to Twitter.com

Access tokens

This subsection has 4 text inputs for the different oAuth access tokens. Use this section to store the access tokens you have generated at apps.twitter.com.

Usage status

Twitter enforces rate limits on a per user basis for each resource type. The usage tracking tool allows you to monitor your data usage (number of requests) per resource. This way you can make sure you do not exceed the enforced rate limits. It can also be used as a debugging tool, when you do exceed.

Caching and Performance

You can control the way Twitter Feed operates in the “Caching & Performance” section of the plugin’s administration page.

Force Tweet Count

This option allows you to make sure that the number of tweets received from Twitter.com matches the requested number of tweets. This is useful because Twitter will not always return the requested number of tweets, since the tweet “count” parameter behaves more closely in concept to an “up to” parameter. Enable this option if you want to ensure that you get the right number of tweets. Notice that enabling this option can increase the time it takes the page to load, as multiple requests will be made to Twitter.com until the requested count is returned. It is highly recommended that you enable caching if you choose to enable this option. You can also set the maximum number of requests in case Twitter has returned a wrong number of tweets.

Enable Caching

Use this option if you want to avoid sending a query to Twitter.com on every page reload. This is useful if you have a high traffic website and you wish to avoid hitting Twitter’s query limits. Note that this can dramatically decrease the time it takes the server to return a response, since the data will be fetched from the local database, rather than from Twitter.com that is a remote address.

Caching Frequency

Set the caching frequency in seconds. This is used as the minimum threshold to make a query to Twitter.com. In other words, this is the minimum time between each query to twitter, so the plugin will not make a new request until the time elapsed from the last request is greater than or equal to the caching frequency.

Cache Data and the Clear Cache Button

The Cache Data box allows you to view the data that is currently stored in cache. You cannot modify that data. The only way to modify this data is to completely erase it, by clicking on the “Clear Cache” button. This is useful if you want to analyze the performance of the plugin or if you want to force the plugin to make a new request to twitter.


This plugin supports 6 different Twitter REST API 1.1 Resources. A resource is a way to define which tweets should be returned by the query. The following is a list of the resources that are supported by the plugin.

  • User Timeline – Returns a collection of the most recent Tweets posted by the user indicated by the User Name parameter.
  • Home Timeline – Returns a collection of the most recent Tweets and retweets posted by the authenticating user and the users they follow.
  • Mentions Timeline – Returns the 20 most recent mentions (tweets containing a users’s @screen_name) for the authenticating user.
  • Retweets of me – Returns the most recent tweets authored by the authenticating user that have been retweeted by others.
  • List – Returns a timeline of tweets authored by members of the specified list. Requires the User Name and List Name parameters to be set.
  • Search – Returns a collection of relevant tweets matching a specified query. Requires the Search Query parameter to be set.
  • Favorites – Returns the most recent Tweets favorited by the authenticating or specified user.


Tweets can be added to any post using the shortcode editor that is integrated into the visual editor. To open the shortcode editor, navigate to the visual editor and click on the bird icon. You will be prompt to choose from 3 types of shortcodes. Each type opens a popup with fields that correspond to that shortcode.

Choose from 3 different shortcode types

Choose from 3 different shortcode types

The shortcode editor

The shortcode editor


The widget (you can add multiple instances)

The widget (you can add multiple instances)


To insert a widget, go to Appearance -> Widgets. Then, drag the Twitter Feed widget from the available widgets into one of your sidebars. You can choose the number of tweets, the username of the twitter account, the skin type, which tweet assets to show and more from the widget’s administration panel.

All the controls are similar to the controls that are available on the shortcode editor.

Spread the word about Twitter Feed!