=== Good Old Twitter Feed Widget ===
Contributors: whiletrue
Donate link: https://www.whiletrue.it/
Tags: twitter, twitter sidebar, sidebar, social, social sidebar, widget, twitter widget, twitter feed, simple twitter, twitter oauth
Requires at least: 2.9+
Tested up to: 6.1
Stable tag: 1.2.6

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 [good_old_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):

[good_old_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](https://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:

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

= Credits =

Some plugin code is based on work by Max Steel (Web Design Company, Pro Web Design Studios), Frank Gregor and Jim Durand.

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)

= Reference =
This plugin gives you the features of the former 2.5.16 release of the "Really simple Twitter Feed Widget" plugin.

== 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 `good-old-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:
.good_old_twitter_widget { /* your stuff */ }
.good_old_twitter_widget li { /* your stuff */ }

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

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

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

= What filters are available? =

* The "gotw_link_user" filter applies to the link to the Twitter user profile
* The "gotw_button_follow" filter applies to the Twitter "Follow Me" button
* The "gotw_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)

*images*	: Show tweet images (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 ==

= 1.2.6 =
* Fixed: PHP8 warnings 
* Plugin tested up to WordPress 6.1

= 1.2 =
* Changed: switch to the WP HTTP API

= 1.0.9 =
* Added: Support for long tweets
* Added: Show tweet images
* Changed: Account thumbnail served over HTTPS
* Changed: If any skip options is active, now gets 2x items

= 1.0 =
* Initial release


== Upgrade Notice ==

= 1.0.0 =
Initial release
