=== Plugin Name ===
Contributors: ZeroCool51 Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=SKMW3BAC8KE52 Tags: twitter widget, twitter, simple twitter widget, custom twitter, widget, tweet, twitter sidebar, twitter 1.1 api Requires at least: 3.0 Tested up to: 4.3 Stable tag: 3.3.8 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:
== Installation ==
== Frequently Asked Questions ==
None at the moment.
== Screenshots ==
Twitter feed (widget in action on first blog)
Twitter feed (widget in action on second blog)
Twitget settings page
Available variables for custom HTML output and example
== Changelog ==
= 3.3.8 =
= 3.3.7 =
= 3.3.6 =
= 3.3.5 =
= 3.3.4 =
= 3.3.3 =
= 3.3.2 =
= 3.3.1 =
= 3.3 =
= 3.2 =
= 3.1 =
= 3.0 =
= 2.2.2 =
= 2.2.1 =
= 2.2 =
= 2.1.4 =
= 2.1.3 =
= 2.1.2 =
= 2.1.1 =
= 2.1 =
= 2.0.1 =
= 2.0 =
= 1.3.2 =
= 1.3.1 =
= 1.3 =
= 1.2.4 =
= 1.2.3 =
= 1.2.2 =
= 1.2.1 =
= 1.2 =
= 1.1 =
= 1.0 =
== Upgrade Notice ==
= 2.0.1 =
Please urgently update, the plugin keeps updating itself because the version variable is not set correctly and it also slows down plugin performance.
= 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 or inside 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
{$profile_image_normal_url} - return URL of tweet profile image - 48x48 px size (if retweet in loop, returns original tweet profile image)
{$profile_image_bigger_url} - return URL of tweet profile image - 73x73 px size (if retweet in loop, returns original tweet profile image)
{$profile_image_mini_url} - return URL of tweet profile image - 24x24px size (if retweet in loop, returns original tweet profile image)
{$profile_image_original_url} - return URL of tweet profile image - original size (if retweet in loop, returns original tweet profile image)
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:
<ul>
{$tweets_start}
<li>{$tweet_text}<br />on {$tweet_time}<br />{$retweet} | <a href="{$favorite_link}">Favorite this tweet</a></li>
{$tweets_end}
</ul>
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.
== Thank you ==
A big thank you goes to all the people that take the time to post a support thread on the forum. It helps this plugin to stay alive and work as it should.
I would also like to thank to the following Wordpress forum members that have helped me found and eradicated some nasty bugs:
== Donators ==
Thank you to the following people who have donated so far:
I appreciate your support!