User Timeline Tag

Returns the most recent statuses posted by the specified user.

Example

We thought it fitting on this 10th Anniversary of #jquery that jQuery 3.0 Beta is ready! blog.jquery.com/2016/01/14/jqu…
Hard to believe it’s been a decade! Ten Years of jQuery and Beyond — blog.jquery.com/2016/01/14/ten…

Note: These docs are static, so relative dates may be inaccurate.

Note: You have complete control over the code, variables, and style of your Tweets. If you plan on utilizing the reply, favorite, and/or retweet actions, make sure to add the Twitter Web Intents script (see the Intents Script Tag for more details):

{exp:ce_tweet:intents_script}
<div class="ce_tweet_holder group">
    {exp:ce_tweet:user_timeline screen_name="jQuery" count="5"}
    <div class="ce_tweet">
        <div class="ce_tweet_left">
            <a class="ce_tweet_username" href="http://twitter.com/{user_screen_name}" target="_blank"><img src="{user_profile_image_url}" alt="" /></a>
        </div><!-- .ce_tweet_left -->
        <div class="ce_tweet_right">
            <div class="ce_tweet_row">
                <a class="ce_tweet_username" href="http://twitter.com/{user_screen_name}" target="_blank">{user_name}</a>
                <a class="ce_tweet_name" href="http://twitter.com/{user_screen_name}" target="_blank">{user_screen_name}</a>
            </div><!-- .ce_tweet_row -->
            <div class="ce_tweet_row ce_tweet_text">{text}</div>
            <div class="ce_tweet_row ce_tweet_actions">
                <a class="ce_tweet_time" href="https://twitter.com/{user_screen_name}/statuses/{id_str}" title="{created_at format="%g:%i %A, %M %j%S (%T)"}" target="_blank"><span class="icon-twitter"></span> {created_at_relative}</a>
                <a class="ce_tweet_reply" href="https://twitter.com/intent/tweet?in_reply_to={id_str}" target="_blank"><span>Reply</span></a>
                <a class="ce_tweet_retweet{if retweeted} ce_tweet_retweeted{/if}" href="https://twitter.com/intent/retweet?tweet_id={id_str}" target="_blank"><span>Retweet</span></a>
                <a class="ce_tweet_favorite{if favorited} ce_tweet_favorited{/if}" href="https://twitter.com/intent/favorite?tweet_id={id_str}" target="_blank"><span>Favorite</span></a>
            </div><!-- .ce_tweet_row -->
        </div><!-- .ce_tweet_right -->
    </div><!-- .ce_tweet -->
    {/exp:ce_tweet:user_timeline}
</div><!-- .ce_tweet_holder -->

Parameters

Note: Always specify either a user_id or screen_name when requesting a user timeline. All other parameters are optional.

user_id=

The id of the user for whom to return results for. Helpful for disambiguating when a valid user id is also a valid screen name.

screen_name=

The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user id.

count=

Specifies the number of records to retrieve. Must be less than or equal to 200. Defaults to "20".

since_id=

Returns results with an id greater than (that is, more recent than) the specified id. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occurred since the since_id, the since_id will be forced to the oldest id available.

max_id=

Returns results with an id less than (that is, older than) or equal to the specified id.

trim_user=

When set to "yes" each tweet returned in a timeline will include a user object including only the status authors numerical id. Omit this parameter to receive the complete user object. The default is "no".

include_rts=

When set to "yes",the timeline will contain native retweets (if they exist) in addition to the standard stream of tweets. The output format of retweeted tweets is identical to the representation you see in user_timeline. Note: If you're using the trim_user parameter in conjunction with include_rts, the retweets will still contain a full user object. The default is "no".

include_entities=

When set to "yes", each tweet will include a variety of metadata about the tweet, including: user_mentions, urls, and hashtags. The default is "yes".

exclude_replies=

This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies= will mean you will receive up-to count tweets — this is because the count parameter retrieves that many tweets before filtering out retweets and replies. The default is "no".

contributor_details=

This parameter enhances the contributors element of the status response to include the screen_name of the contributor. By default only the user_id of the contributor is included. The default is "yes".

link=

Should the text be hyperlinked? Can be one or more of the following:

  • h Link hashtags like #example
  • m Link mention like @causingeffect
  • u Link URLs like http://www.causingeffect.com

Multiple values should be pipe delimited. Defaults to "h|m|u".

seconds=

The amount of seconds to cache this tag’s output. Defaults to "300" (5 minutes).

Variables

{contributors}
    {id_str}
    {screen_name}
{/contributors}
{created_at}
{created_at_relative}
{entities_urls}
    {url}
    {expanded_url}
    {display_url}
{/entities_urls}
{entities_hashtags}
    {text}
{/entities_hashtags}
{entities_user_mentions}
    {screen_name}
    {name}
    {id_str}
{/entities_user_mentions}
{favorited}
{geo}
{id_str}
{in_reply_to_screen_name}
{in_reply_to_status_id_str}
{in_reply_to_user_id_str}
{is_retweet}
{place}
{retweet_count}
{retweeted}
{source}
{text}
{text_raw}
{truncated}
{user_contributors_enabled}
{user_created_at}
{user_created_at_relative}
{user_default_profile}
{user_default_profile_image}
{user_description}
{user_favourites_count}
{user_follow_request_sent}
{user_followers_count}
{user_following}
{user_friends_count}
{user_geo_enabled}
{user_id_str}
{user_is_translator}
{user_lang}
{user_listed_count}
{user_location}
{user_name}
{user_notifications}
{user_profile_background_color}
{user_profile_background_image_url}
{user_profile_background_image_url_https}
{user_profile_background_tile}
{user_profile_image_url}
{user_profile_image_url_https}
{user_profile_link_color}
{user_profile_sidebar_border_color}
{user_profile_sidebar_fill_color}
{user_profile_text_color}
{user_profile_use_background_image}
{user_protected}
{user_screen_name}
{user_show_all_inline_media}
{user_statuses_count}
{user_time_zone}
{user_url}
{user_utc_offset}
{user_verified}

Note: Take a look at the Twitter Tweets documentation for more details about the variables.

Twitter Resources

This method is an implementation of the Twitter statuses/user_timeline REST API.