May be worth adding the docs now that EllisLab has redesigned

[aarongustafson]

Just a thought.

[since1976]

Plus one on this.

[minimaldesign]

I can't find the EllisLab version…

[Mat-Moo]

Twitter Timeline 1.4.6 first_party

Author: Derek Jones Published: Apr 13, 2007 Last Updated: Jul 16, 2012 License: First Party License

Categories: Plugins General

Allows you to display information from Twitter timelines.

For EE 1.X

For EE2 Requirements ExpressionEngine version 1.5.2 or higher Example Usage {exp:twitter_timeline screen_name="screen_name"}

{created_at format="%m-%d %g:%i"}

{name}

{text}

{/exp:twitter_timeline}

Notes

PARAMETERS:

screen_name="ellislab"

• The twitter name of the timeline to show. Optional, defaults to the public timeline.

limit="5"

• Number of status messages to limit to. Default (and maximum value) is 20.

twitter_refresh="20"

• Time (in minutes) of cache interval for the requested Twitter timeline. Defaults to 15.

create_links="user_mentions|hashtags|urls"

• Turn mentions (@username), hashtags (#hashtag), or urls (http://example.com) into relevant links.

use_stale_cache="no"

• Show blank data if the cache is stale and the Twitter api could not be reached.

time_limit="5"

• The maximum time (in seconds) allowed for attempting to connect to Twitter. Defaults to 5.

---

VARIABLES:

{count} {switch="one|two|three"} {created_at format="%m-%d-%Y"} {status_relative_date} {text} {id} {user_id} {name} {screen_name} {location} {description} {profile_image_url} {url} {protected}

---

TROUBLESHOOTING:

This plugin only works on unprotected Twitter feeds, make sure that the feed your trying to display is public.

All error messages are logged in the Template Parsing Log. If you have no output, or unexpected output, enable the Template Parsing Log in your Output and Debugging Preferences.

Even though this tag has its own caching mechanism for retrieving the timeline from Twitter.com, do not forget that you can further increase performance by using Tag Caching: http://expressionengine.com/docs/general/caching.html#tag_caching

---

CHANGELOG:

Version 1.4.6 - Added a time_limit parameter to specify max seconds allowed when trying to connect to Twitter. Version 1.4.5 - Fixed a PHP error that could occur when unknown entities are encountered and added parsing of the media entity url. Version 1.4.4 - Fixed a bug where error handling broke and caused PHP errors due to incorrectly formatted error responses from the Twitter API. Version 1.4.3 - Security Release and added curly brace encoding to fix some odd parsing behavior. Version 1.4.2 - Fixed a bug in caching. Version 1.4.1 - Improved handling of Twitter's IP based rate limiting. Version 1.4 - Dropped support for http authentication as Twitter is moving to oauth. Added create_links and use_stale_cache parameters. Version 1.3.1 - Fixed a bug with localization of the {status_relative_date} variable Version 1.3 - Updated plugin to be 2.0 compatible Version 1.2 - added ability to use multiple Twitter Timeline tags on a page, with separate caches Version 1.1.1 - improved handling for situations where Twitter's server is down Version 1.1 - added error handling for Twitter XML error responses

[sam327]

Ellislab's plugin has been retired, which is why you can't find it on the redesigned site - http://ellislab.com/blog/entry/reminder-twitter-api-v1-being-retired-soon