WordPress.org

Ready to get started?Download WordPress

Plugin Directory

DevBuddy Twitter Feed

A Twitter (v1.1) feed plugin for the developers that's flexible and supports displaying multiple feeds of both user and search timelines.

Getting Started

Before this plugin can be used the end user will need to offer it Consumer and OAuth keys that are used to authenticate your communication with Twitter. To obtain these:

  1. Visit the create application page on the Twitter developers site. You may be required to sign in, your usual Twitter.com login credentials will work here
  2. Fill in the necessary details and click the "Create your Twitter application" button at the bottom. Don't worry about being creative here, the details you put in won't be public (unless you make them public, that is)
  3. If all goes well you'll be taken to the "Details" tab of the new app. Scroll down and look for the "Create my access token" button near the bottom of the page and click on it.
  4. Finally, click on the "OAuth Tool" tab. This page holds the Consumer Key, Consumer Secret, Access Token, and Access Token Secret necessary for this plugin to function. Copy them over into your settings.

Rendering the feed

You can use either the:

  • <?php db_twitter_feed() ?> template tag, which takes an associative array as its only parameter; or the
  • [db_twitter_feed] shortcode

Both accept the same arguments/attributes which are all listed and explained below. All arguments/attributes are optional.

Options set via tempate tag or shortcode take highest priority. If an option is not set in the tag/shortcode this plugin will then check to see if the option is set in the WordPress admin. If no options have been set the plugin will render with the defaults, listed below

feed_type (string); user_timeline or search default: user_timeline

The type of feed that is to be rendered. user_timeline produces a feed based on what is set for user, and search produces a feed based on what is set for search_term.

user (string); default: EjiOsigwe

Any valid Twitter username.

search_term (string); default: #twitter

The term you wish to search Twitter for, with or without a hashtag.

count (int); default: 10

The number of tweets you want displayed. The maximum Twitter allows per request is at 200 but anything higher than 30 seems to noticeably affect the page load time, especially when loading multiple feeds on the one page.

exclude_replies (string): yes or no; default: no

The option of whether or not to keep replies out of the feed displayed. Go with no to keep replies in, yes to take them out. NOTE: Twitter removes replies only after it retrieves the number of tweets you request. Thus if you choose 10, and out of that 10 6 are replies, only 4 tweets will be displayed.

default_styling (string): yes or no; default: no

The option of whether or not to load the default stylesheet bundled with this plugin. Go with yes to load it, no to skip loading it. Bear in mind that once the stylesheet is loaded it is loaded to the page so all feeds on the page will be affected by it. Hence, when rendering multiple feeds you only need to yes with one, and leave it out of the others.

cache_hours (int); default: 0

The number of hours you would like the feed cached for. The cache is saved using WordPress' own set_transient() function.

clear_cache (string): yes or no; default: no

Clears the cached version of the feed. If a cached version exists this plugin skips looking at the options altogether so this is a must if you're changing any options. If you're using either the template tag or the shortcode without passing information (i.e. all settings from settings page), the cache will be cleared each time the "Save Changes" button is clicked on the plugin's settings page. This option will only work if the "user" option has been set

consumer_key, consumer_secret, oauth_access_token, oauth_access_token_secret (string); default: N/A

See the first part of the "Installation" tab to find out how to get these. They are necessary for authenticating your communication with Twitter and this plugin unfortunately won't work without them.

Requires: 3.1.0 or higher
Compatible up to: 3.9.1
Last Updated: 2014-6-29
Downloads: 4,849

Ratings

5 stars
5 out of 5 stars

Support

0 of 4 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1