- Author(s): George Ornbo, Leevi Graham
- Source Code: Github
- ExpressionEngine Version 1.6.x
- PHP 5.x.x
- cURL support
Twit-ee is free for personal and commercial use.
If you use it commercially use a donation of $10 is suggested. You can send donations here.
Twit-ee is licensed under a Open Source Initiative - BSD License license. I encourage others to fork the code and enhance it.
- Copy the /modules/twitee folder to your /system/modules/ folder
- Copy the /language/english/lang.twitee.php file to your /system/languages/english folder
- Open the Module Manager
- Install the Twit-ee module
- In the module enter your Twitter username and password
- Ensure that your /system/cache/ folder is writable
- Twit-ee is MSM compatible so you can have a separate twitter account for each site
Twit-ee
Show data from Twitter API in ExpressionEngine templates
Twit-ee fetches data from the Twitter API and allows you to display it in your ExpressionEngine templates. A variety of tags are available allowing you to show your own tweets, your friends tweets and more.
Returns the 20 most recent statuses from non-protected users who have set a custom user icon. Does not require authentication. Note that the public timeline is cached for 60 seconds so requesting it more often than that is a waste of resources.
{exp:twitee:public_timeline}
{/exp:twitee:public_timeline}
Returns the 20 most recent statuses, including retweets, posted by the authenticating user and that user's friends. This is the equivalent of /timeline/home on the Web.
{exp:twitee:home_timeline}
{/exp:twitee:home_timeline}
Returns the 20 most recent statuses posted by the authenticating user and that user's friends. This is the equivalent of /home on the Web.
{exp:twitee:friends_timeline}
{/exp:twitee:friends_timeline}
Returns the 20 most recent statuses posted from the authenticating user. It's also possible to request another user's timeline via the id parameter below. This is the equivalent of the Web /archive page for your own user, or the profile page for a third party.
{exp:twitee:user_timeline}
{/exp:twitee:user_timeline}
Returns the 20 most recent mentions (status containing @username) for the authenticating user.
{exp:twitee:mentions}
{/exp:twitee:mentions}
Returns the 20 most recent retweets posted by the authenticating user.
{exp:twitee:retweeted_by_me}
{/exp:twitee:retweeted_by_me}
Returns the 20 most recent retweets posted by the authenticating user's friends.
{exp:twitee:retweeted_to_me}
{/exp:twitee:retweeted_to_me}
Returns the 20 most recent retweets posted by the authenticating user's friends.
{exp:twitee:retweets_of_me}
{/exp:twitee:retweets_of_me}
Returns the 20 most recent tweets of the authenticated user that have been retweeted by others.
{exp:twitee:favorites}
{/exp:twitee:favorites}
Returns the authenticating user's friends, each with current status inline. They are ordered by the order in which they were added as friends.
{exp:twitee:friends}
{/exp:twitee:friends}
Returns the authenticating user's followers, each with current status inline. They are ordered by the order in which they joined Twitter (this is going to be changed).
{exp:twitee:followers}
{/exp:twitee:followers}
limit="10"
Limits the number of results returned. Default - 10
refresh="5"
The number of minutes between cache refreshes. Default - 5 minutes.
site_id="1"
Allows you to show data from another MSM enabled site. Default - the current site id.
convert_urls="n"
Convert urls in the tweet into anchors. Default - "y"
convert_usernames="n"
Convert @username in the tweet into anchors that point to the users profile. Default - "y"
convert_hash_tags="n"
Convert #hashtags in the tweet into anchors that point to search.twitter.com. Default - "y"
ucfirst_relative_time="y"
Changes the first letter of the relative time to uppercase. Default - "n"
timeout="1"
The length of time Twit-ee can take establishing a connection to Twitter in seconds. Default - 1 second
Public Timeline, Friends Timeline, User Timeline, Replies and Favorites
Status
{created_at}
{relative_time}
{id}
{text}
{source}
{truncated}
{in_reply_to_status_id}
{in_reply_to_user_id}
{favorited}
User
{id}
{name}
{screen_name}
{description}
{location}
{profile_image_url}
{url}
{protected}
{followers_count}
{count}
{total_results}
Friends, Followers
User
{id}
{name}
{screen_name}
{location}
{description}
{profile_image_url}
{url}
{protected}
{followers_count}
{created_at}
Status
{id}
{text}
{source}
{truncated}
{in_reply_to_status_id}
{in_reply_to_user_id}
{favorited}
{in_reply_to_screen_name}
{count}
{total_results}
Show the latest 5 tweets from the public timeline with a cache time of five minutes
{exp:twitee:public_timeline refresh="5" limit="10"}
{if count == 1}<ul>{/if}
<li>{text}</li>
{if count == total_results}</ul>{/if}
{/exp:twitee:public_timeline}
Show the latest 10 tweets from your favorites with a cache time of 30 minutes
{exp:twitee:favorites refresh="30" limit="10"}
{if count == 1}<ul>{/if}
<li>{text}</li>
{if count == total_results}</ul>{/if}
{/exp:twitee:favorites}
This file is written using the MarkDown syntax. It may or may not have been parsed. If you are having trouble reading it try running the contents through http://daringfireball.net/projects/markdown/dingus.