=== Plugin Name === Contributors: ZeroCool51 Donate link: http://gum.co/twitget Tags: twitter widget, twitter, simple twitter widget, custom twitter, widget, tweet, twitter sidebar, twitter 1.1 api, feed Requires at least: 3.0 Tested up to: 3.5 Stable tag: 2.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html A simple widget that shows your recent tweets with fully customizable HTML output and Twitter API 1.1 support. == Description == This is a simple widget that shows your recent tweets. It also supports caching, so you won't exceed the API call limit. What this plugin offers: * Show your Twitter feed as a widget * Customize number of shown tweets * Customize if you want to show retweets or replies * Show profile box * Customize entire HTML output * Twitter API 1.1 support == Installation == 1. Upload the plugin directory to to the '/wp-content/plugins/' directory 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Customize the settings in Settings->Twitget 4. Add the widget to the desired location or use a shortcode [twitget] in your posts == Frequently Asked Questions == None at the moment. == Screenshots == 1. Twitter feed (widget in action on first blog) 2. Twitter feed (widget in action on second blog) 3. Twitget settings page 4. Available variables for custom HTML output and example == Changelog == = 2.0 = * [New] Added new variables: reply, retweet, favorite, tweet link * [New] Show times in local time * [Fix] Fixed a bug if multiple plugins were using the same twitter class * [Deprecated] Removed boxes before, after etc., custom HTML output is now the default value * [Deprecated] API 1.0 is now deprecated = 1.3.2 = * Fixed update procedure, with less hassle * Added shortcode support in posts. = 1.3.1 = * Fixed an installation/update bug that resulted in unupdated values. = 1.3 = * Added the option to exclude replies * Added the option to show relative time of tweets * Added the option to fully customize html output. = 1.2.4 = * [Fix] Sometimes retweets were cut or content was missing. = 1.2.3 = * [Fix] Fresh installation bug (missing values) = 1.2.2 = * [Fix] Sometimes mentions were wrongly presented (@username? - question mark was present as username) * [Fix] Sometimes hashes were wrongly presented * [Fix] Ommited some things in the update process for faster updating. = 1.2.1 = * [Fix] At update, some options would not show * [Fix] Old updates (1.2, 1.1) caused empty values at fresh install or update. = 1.2 = * Added the ability to include retweets in your feed. = 1.1 = * Added support for Twitter API 1.1. = 1.0 = * Initial version. == Upgrade Notice == = 2.0 = This upgrade deprecates all previous HTML fields (before, after, suffix, before tweet etc.) and instead uses the provided custom HTML output template. It also deprecates the use of the Twitter API 1.0, but the settings are still available. == Creating a Twitter application == To use the Twitter 1.1 API you need to create an application. Follow this Youtube tutorial to create it. [youtube http://www.youtube.com/watch?v=noB3P-K-wb4] == Custom HTML output == You can fully customize your HTML output via variables. Some variables can only be used inside a feed loop, others anywhere. Before you output a Twitter feed, you must write the following: `{$tweets_start} // Your other data here ... {$tweets_end}` Once inside a loop, you can use any of the following variables: `{$tweet_text} - the text of the tweet {$tweet_time} - the time of the tweet {$tweet_location} - the location of the tweet (example: Budapest) {$retweet} - outputs a ready retweet link with the text Retweet, opens in new tab {$reply} - outputs a ready reply link with the text Reply, opens in new tab {$favorite} - outputs a favorite link with the text Favorite, opens in new tab {$retweet_link} - returns URL of retweet link {$reply_link} - returns URL of reply link {$favorite_link} - returns URL of favorite link {$tweet_link} - returns URL of tweet` Outside a loop you can use the following: `{$profile_image} - the url to the profile image of the user {$user_real_name} - the real name of the user {$user_twitter_name} - username of the twitter user {$url} - website url of the user {$user_description} - description of the user {$user_location} - user location {$follower_count} - number of followers {$friends_count} - number of friends` For example if you want to output Twitter text, a retweet link, a custom favorite link and some data behind the feed, you would do the following: ` I have {$follower_count} followers and {$friends_count} friends.` And this is basically it. == Author == The author of this plugin is Bostjan Cigan, visit the [homepage](http://bostjan.gets-it.net "homepage"). == Homepage == Visit the [homepage](http://wpplugz.is-leet.com "homepage of twitget") of the plugin. == Donators == Thank you to the following people who have donated so far: * Aaron * Corinne * Civil Society Trust * Kay Grant * JD Kitchens * Rachel Young I appreciate your support!