A Twitter (v1.1) feed plugin for the developers that's fully customisable and support timelines, searches and lists.
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:
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
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
The type of feed that is to be rendered.
user_timelineproduces a feed based on what is set for the
searchproduces a feed based on what is set for the
listproduces a feed based on what is set for the
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.
The option of whether or not to keep replies out of the feed displayed. Go with
noto keep replies in,
yesto take them out.
The option of whether or not to keep retweets out of the feed displayed. Go with
noto keep retweets in,
yesto take them out.
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.
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.
The option of whether or not to load media from Twitter over their secure connection.
The option of whether or not to load the default stylesheet bundled with this plugin. Go with
yesto load it,
noto 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
yeswith 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
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.