Favorites Tag

Returns the most recent favorite statuses for the authenticating user or user specified by the id= parameter in the requested format.

Example

@causingeffect using a very granular caching strategy enabled #cecache to improve load time by what seems like days, so thank you #eecms
3 days, over 6300 users, over 8300 sessions, 43000+ pageviews. Average page download time 0.08 sec #eecms @nexcess @causingeffect @RedFest_
If you use CE Image, but not CE Lossless take some time to rethink your life. #eecms devot-ee.com/add-ons/ce-los…
Using CE:image & Picturefill - to check which image being served - add filter="colorize,0,0,255,0" with diff colour to each CE tag #eecms
If you work in #eecms and commonly store a ton of markup in Low Vars/Snippets, try “In” instead. dvt.ee/in Read 1st paragraph.

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:favorites 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:favorites}
</div><!-- .ce_tweet_holder -->

Parameters

Note: There are no required parameters for this tag. In other words, the following parameters are all optional.

count=

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

user_id=

The id of the user for whom to return results for.

screen_name=

The screen name of the user for whom to return results for.

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.

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

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

{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}
{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}

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 favorites REST API.