=== Really Simple Twitter Feed Widget ===
Contributors: Dabelon, whiletrue, tanaylakhani
Donate link: http://www.whiletrue.it/
Tags: twitter, twitter sidebar, sidebar, social sidebar, widget, plugin, post, posts, links, twitter widget, twitter feed, simple twitter, twitter api 1.1, api 1.1, oauth, twitter oauth, favorite
Requires at least: 2.9+
Tested up to: 4.1
Stable tag: 3.0

Shows the latest tweets from a Twitter account in a sidebar widget.

== Description ==
This plugin displays the latest posts from a Twitter account in a sidebar widget. 
Easy customization of style, replies, retweets, links, dates, thumbnails and a lot more.

The plugin is based on Twitter API version 1.1. 
In order to use it, you have to create a personal Twitter Application on the [dev.twitter.com](https://dev.twitter.com/apps "dev.twitter.com") website.
Within your Application, Twitter provides two strings: the Consumer Key and the Consumer Secret.
You also need two other strings, the Access Token and the Access Token Secret, that you can get
following [this guide](https://dev.twitter.com/docs/auth/tokens-devtwittercom "this guide").
Finally, enter all the Authorization string in the widget options box, along with your favorite display settings: your Twitter Widget is now ready and active!

You can use the same Authorization strings for several widgets and multiple website. 
Just remember to store them in a safe place!

You also need CURL and OPENSSL extensions enabled in your PHP environment (don't worry, almost every hosting service provides that).

= Shortcode =

If you want to put your recent tweets other than in a widget, you can use the [really_simple_twitter] shortcode. 
The shortcode support is experimental. 

At the moment at least the twitter username and the 4 authentication attributes are mandatory. The shortcode minimal configuration is (with all fields filled):

[really_simple_twitter username="" consumer_key="" consumer_secret="" access_token="" access_token_secret=""]

You can specify other optional attributes, e.g.:

* num (number of tweets to show, e.g. num="10")
* skip_retweets (if set to true, retweets are skipped, e.g. skip_retweets="true")

The full list of available options is available in the plugin FAQ.

= Reference =

For more informations: [www.whiletrue.it](http://www.whiletrue.it/really-simple-twitter-feed-widget-for-wordpress/ "www.whiletrue.it")

Do you like this plugin? Give a chance to our other works:

* [Really Simple Share](http://www.whiletrue.it/really-simple-share-wordpress-plugin/ "Really Simple Share")
* [Most and Least Read Posts](http://www.whiletrue.it/most-and-least-read-posts-widget-for-wordpress/ "Most and Least Read Posts")
* [Tilted Tag Cloud Widget](http://www.whiletrue.it/tilted-tag-cloud-widget-per-wordpress/ "Tilted Tag Cloud Widget")
* [Reading Time](http://www.whiletrue.it/reading-time-for-wordpress/ "Reading Time")

= Credits =

The initial release of the plugin was based on previous work of Max Steel (Web Design Company, Pro Web Design Studios), which was based on Pownce for Wordpress widget.

The 1.2.3 release is based on the work of Frank Gregor.

The 1.3.5 and 1.3.7 releases are based on the work of Jim Durand.

Starting from the 2.0 release, the Codebird library by J.M. ( me@mynetx.net - https://github.com/mynetx/codebird-php ) is used for Twitter OAuth Authentication.

= Translators =

* Branco, Slovak translation (WebHostingGeeks.com)
* WhileTrue, Italian translation (www.whiletrue.it)
* Inspirats, French translation (rysk-x.com)
* Aleksandra Czuba, Polish translation (www.olaczuba.com)
* Alexandre Janini, Brazilian Portuguese translation (www.asterisko.com.br)
* Andrew Kurtis, Spanish translation (www.webhostinghub.com)


== Installation ==
Best is to install directly from WordPress. If manual installation is required, please make sure to put all of the plugin files in a folder named `really-simple-twitter-widget` (not two nested folders) in the plugin directory, then activate the plugin through the `Plugins` menu in WordPress.

== Frequently Asked Questions == 

= Does the widget show my tweets in real time? =
Yes they're shown in real time, although you have to refresh the page for them to appear.

= How can I modify the styles? =

The plugin follows the standard rules for "ul" and "li" elements in the sidebar. You can set your own style modifying or overriding these rules:
.really_simple_twitter_widget { /* your stuff */ }
.really_simple_twitter_widget li { /* your stuff */ }

As for the linked username on the bottom (if enabled), you can customize it this way:
div.rstw_link_user { /* your stuff */ }

= I've enable user thumbnails. How can I make them look better? =

You can use some CSS rules like these:
`.really_simple_twitter_widget     { margin-left:0; }`
`.really_simple_twitter_widget li  { margin-bottom:6px; clear:both; list-style:none;   }`
`.really_simple_twitter_widget img { margin-right :6px; float:left; border-radius:4px; }`

= What filters are available? =

* The "rstw_link_user" filter applies to the link to the Twitter user profile
* The "rstw_button_follow" filter applies to the Twitter "Follow Me" button
* The "rstw_output" filter applies to the final widget frontend output

All the filters are provided with the plugin's complete array of options.

= What options are available for the shortcode? =

This is the complete option list. The boolean options can be set writing "true" or "false" as values.

*TWITTER AUTHENTICATION* 

*consumer_key*	: Consumer Key

*consumer_secret*	: Consumer Secret

*access_token*	: Access Token

*access_token_secret*	: Access Token Secret

*TWITTER DATA* 

*username*	: Twitter Username

*num*	: Show # of Tweets

*skip_text*	: Skip tweets containing this text

*skip_replies*	: Skip replies (value: true or false)

*skip_retweets*	: Skip retweets (value: true or false)

*WIDGET TITLE*

*title*	: Title

*title_icon*	: Show Twitter icon on title (value: true or false)

*title_thumbnail*	: Show account thumbnail on title (value: true or false)

*link_title*	: Link above Title with Twitter user (value: true or false)

*WIDGET FOOTER*

*link_user*	: Show a link to the Twitter user profile (value: true or false)

*link_user_text*	: Link text

*button_follow*	: Show a Twitter "Follow Me" button (value: true or false)

*ITEMS AND LINKS*

*linked*	: Show this linked text at the end of each Tweet

*thumbnail*	: Include thumbnail before tweets (value: true or false)

*thumbnail_retweets* : Use author thumb for retweets (value: true or false)

*hyperlinks*	: Find and show hyperlinks (value: true or false)

*replace_link_text*	: Replace hyperlinks text with fixed text (e.g. "-->")

*twitter_users*	: Find Replies in Tweets (value: true or false)

*link_target_blank*	: Create links on new window / tab (value: true or false)

*TIMESTAMP*

*update*	: Show timestamps (value: true or false)

*date_link*	: Link timestamp to the actual tweet (value: true or false)

*date_format*	: Timestamp format (e.g. M j )

*DEBUG*

*debug* :	Show debug info (value: true or false)

*erase_cached_data*	: Erase cached data (value: true or false)

*encode_utf8*	: Force UTF8 Encode (value: true or false)

== Screenshots ==
1. Sample content, using default options (e.g. no active links)  
2. Options available in the Settings menu 

== Changelog ==

= 2.5.16 =
* Fixed: Clean Unicode four-byte chars (including some emoji) causing database errors on MySQL utf-8 columns

= 2.5.15 =
* Added: Spanish translation by Andrew Kurtis (www.webhostinghub.com)

= 2.5.14 =
* Plugin tested up WordPress 4.1

= 2.5.13 =
* Fixed: PHP notices on widget instance creation and update

= 2.5.12 =
* Fixed: PHP notices on widget instance creation and update

= 2.5.11 =
* Added: Basic CSS style rules for thumbnails
* Changed: Alt and Title attributes added to every image

= 2.5.10 =
* Changed: Improved Debug info 
* Fixed: Improved local cache

= 2.5.9 =
* Changed: Improved Debug info 

= 2.5.8 =
* Changed: Improved Debug info 

= 2.5.7 =
* Added: SUPER basic "rstw_link_user", "rstw_button_follow" and "rstw_output" filters

= 2.5.6 =
* Changed: Option "button_follow_text" removed (no more supported by Twitter)

= 2.5.5 =
* Fixed: Hashtag recognition with foreign characters

= 2.5.4 =
* Added: Option to show the account's Favorites feed instead of the usual tweets timeline

= 2.5.3 =
* Fixed: Twitter thumbnail transient cleaning

= 2.5.2 =
* Fixed: links cleaning

= 2.5.1 =
* Fixed: php warnings cleaning

= 2.5 =
* Added: Option to link timestamp to the actual tweet
* Changed: New button to show/hide advanced options
* Changed: Layout cleaning

= 2.4.11 =
* Added: Twitter Follow @user button with text customization
* Added: Shortcode options list
* Added: Donate link
* Added: "really_simple_twitter" shortcode
* Added: account thumbnail option
* Added: Timestamp format option
* Changed: more compact and clean settings ui
* Changed: layout & code cleaning
* Fixed: Increased number of retrieved posts when the "skip text" option is enabled
* Fixed: Secret fields masked

= 2.3 =
* Changed: updated timestamp function, following the current Twitter guidelines 
* Changed: updated Italian translation

= 2.2 =
* Added: Skip retweets option
* Added: Use author thumb for retweets option
* Changed: Retrieve and use original text for retweets (avoids truncated messages)

= 2.1.1 =
* Added: Replace links with fixed text option
* Added: Show thumbnail option
* Added: Limit to 200 tweets as stated in Twitter API
* Added: Skip replies option, active by default for new widgets
* Added: Brazilian Portuguese translation by Alexandre Janini (www.asterisko.com.br)
* Changed: Cache timeout lowered from 30 to 10 minutes

= 2.0.4 =
* Added: Twitter API 1.1 support
* Added: Erase cached data option (to be used only for a few minutes, when having issues)
* Changed: Brand new options box
* Changed: Brand new debug system
* Changed: More reasonable options display
* Changed: Only show Twitter API debug status when getting actual Twitter data
* Changed: If widget title is not set, don't show the title box
* Fixed: Twitter object format causing PHP warnings
* Fixed: if Twitter data is empty, don't cache it
* Fixed: minor warning on empty Twitter data
* Fixed: minor notice on Twitter status timeout

= 1.3.17 =
* Added: Polish translation by Aleksandra Czuba (www.iwasindira.com)
* Added: French translation by Inspirats (rysk-x.com)
* Added: Slovak translation by Branco (WebHostingGeeks.com)
* Added: show debug info option
* Added: optional Twitter icon near the widget title
* Added: span wrapper element around the comma before the timestamp (class: rstw_comma), for easier design customization
* Added: option to customize text on the user link below the list of tweets
* Changed: more feed error catching 
* Changed: screenshots moved outside, reducing the size of the plugin and allowing for faster updates
* Changed: cleaner options UI
* Changed: now the "Create links on new window/tab" option affects all kinds of link
* Changed: different regular expression for hashtag recognition
* Changed: better caching control, allowing two widget with same username and different number of messages
* Changed: simpler widget name
* Fixed: widget_title filter
* Fixed: storing feed error 
* Fixed: better caching errors control (work by Jim Durand)
* Fixed: avoid php warning on preg_replace function (php 5.3.5 bug)
* Fixed: error checking in the json request
* Fixed: now checks for errors when retrieving data from the Twitter API

= 1.3.1 =
* Added: option to add a link to the Twitter user page below the posts (CSS customizable via the "rstw_link_user" class)
* Added: option to create all the links on new window / tab
* Added: Italian translation
* Changed: use Transient API to cache Twitter results, in order to reduce direct requests to the Twitter API
* Fixed: now retrieve data in JSON format for better storage with transient API and faster data update

= 1.2.3 =
* Changed: a bit of UI (work by Frank Gregor)
* Added: switch for setting on/off a link of the title to the twitter user (work by Frank Gregor)
* Added: German translation (work by Frank Gregor)
* Changed: FB Widget API adoption (carries multiple Widgets support)
* Fixed: Better hashtag handling

= 1.1.1 =
* Changed: direct to the twitter.com search link
* Changed: Use the new Twitter REST API
* Changed: Error handling cleaning

= 1.0.2 =
* Changed: Feed cache lifetime shortening to 30 minutes (default is 12 hours)
* Changed: Some more code cleaning and security option control

= 1.0.0 =
* Added: Option to skip tweets containing certain text
* Changed: New Wordpress Feed API adoption
* Changed: Code cleaning


== Upgrade Notice ==

= 2.0 =
This plugin is based on Twitter API version 1, that will be deleted on March 2013. 
The 2.0 plugin release, based on the Twitter API version 1.1, requires you
to create a personal Twitter Application on the [dev.twitter.com](https://dev.twitter.com/apps "dev.twitter.com") website.
Within your Application, Twitter provides two strings: the Consumer Key and the Consumer Secret.
You also need two other strings, the Access Token and the Access Token Secret, that you can get
following [this guide](https://dev.twitter.com/docs/auth/tokens-devtwittercom "this guide").
Finally, enter all the Authorization string in the widget options box, along with your favorite display settings: your Twitter Widget is now ready and active!
You can use the same Authorization strings for several widgets and multiple website. 
Just remember to store them in a safe place!
You also need to enable the CURL and OPENSSL extensions in your PHP environment.

= 1.0.0 =
Initial release
