Add-Ons

Details

Twitter Timeline 1.4.5 first_party

Author:
Derek Jones
Published:
Apr 13, 2007
Last Updated:
Nov 08, 2011
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"}
<div class="tweet">
    <div class="date">{created_at format="%m-%d %g:%i"}</div>
    <div class="author">
        <div class="icon">
            <img src="{profile_image_url}" width="48" height="48" alt="profile image" />
        </div>
        {name}
    </div>
    <div class="status">{text}</div>
</div>
{/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.

------------------
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.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