WordPress.org

Plugin Directory

DevBuddy Twitter Feed

A Twitter (v1.1) feed plugin for the developers that's fully customisable and support timelines, searches and lists.

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, search, list default: user_timeline

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

user (string); default: twitter

Any valid Twitter username.

search_term (string); default: #twitter

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

list (string); default: twitter-ir/twitter

The slug of a list followed by the username of the owner, separated by a "/".

count (int); default: 10

The number of tweets you want displayed. The maximum Twitter allows per request is at 200. Page speed can be substantially affected when loading multiple feeds on 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.

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

The option of whether or not to keep retweets out of the feed displayed. Go with no to keep retweets in, yes to take them out.

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

The option of whether or not to display times as relative to when they were posted or as absolute times. As an example, a relative time would be "10 mins ago", while an absolute time would be "17:38, Tue". An absolute time is useful where feeds are being cached where relative times can quickly become inaccurate.

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

The option of whether or not to display embedded images within the rendered feed. The caching of images is left to the browser to handle.

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

The option of whether or not to load media from Twitter over their secure connection.

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.

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: 4.2.1
Last Updated: 2015-5-6
Active Installs: 2,000+

Ratings

4.7 out of 5 stars

Support

0 of 3 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
100,1,1
100,1,1