=== WP Tweet Button ===
Contributors: 0xTC
Tags: WP Tweet Button, tweet button, twitter, tweeting, social media, retweet, tweet, button, Share, integration, b2l.me, bit.ly, cli.gs, sl.ly, snipr.com, su.pr, tinyarro, tinyurl
Requires at least: 2.7.2
Tested up to: 3.0.1
Stable tag: trunk
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6331357

== Description ==

This plugin easily and fully implements Twitter's own *[Tweet Button](http://twitter.com/tweetbutton "Twitter Tweet Button")* on your blog or site. The tweet button can be positioned as you please and can be styled to your delight in the settings page.

= Features =

* Custom recommendations per post entry for relevancy.
* Option for tweeting the entry title, page title, blog name or a custom text.
* Each post can have custom tweet texts.
* Custom text for tweets can be made using tags (`%POSTTITLE%`, `%BLOGTITLE%`).
* Tweet Button can be positioned at the top, bottom or both.
* Can be set to be positioned by the `[tweetbutton]` shortcode.
* Can be set to be positioned manually.
* Styling options for the button.
* Styling options for the `div` that surrounds the button.
* Can be set to vertical, horizontal or no counter.
* Option to switch between '{text} {link} via {@user}' and 'RT {@user} {text} {link}' formats.
* Referral can be turned off by removing the username.
* Authors can configure their own Twitter accounts on their profile pages. (WP3.x only)
* Tweet button language can be set to Twitter's supported languages.
* Tweet Button can be generated manually using the `tweetbutton();` function.
* Supports Wordpress 3 shortener functions.
* Initial URL shrinking with 3rd party services (*[b2l.me](http://b2l.me/ "b2l.me"), [bit.ly](http://bit.ly "Bit.ly"), [cli.gs](http://cli.gs "cli.gs"), [sl.ly](http://sl.ly "sl.ly"), [snipr](http://snipr.com "snipr.com"), [su.pr](http://su.pr "su.pr"), [tinyarro.ws](http://tinyarro.ws "tinyarrow"), [tinyurl](http://tinyurl.com "tinyurl")*)
* Initial URL shrinking with the *[Twitter Friendly Links](http://wordpress.org/extend/plugins/twitter-friendly-links/ "Twitter Friendly Links")* Plugin
* Initial URL shrinking with the *[YOURLS: WordPress to Twitter](http://wordpress.org/extend/plugins/yourls-wordpress-to-twitter/ "YOURLS: WordPress to Twitter")* Plugin


== Installation ==

Follow the steps below to install the plugin.

1. Upload the WP-Tweet-Button directory to the `/wp-content/plugins/` directory
2. Activate the plugin through the `Plugins` menu in WordPress
3. Go to Settings/WP Tweet Button to configure the button. Add your Twitter account.

== Frequently Asked Questions ==

= I selected a URL shortener and now the count says 0. Why?! =

Twitter tells the button how many tweets were made for each URL. If you select a URL shortener or switch to a different shortener, you are also changing the URL that Twitter sees.

You can choose to build up a new tweet count with the newly selected URL shortener, or you can choose to go back to your previous URL settings (which will restore your previous tweet counts).

= How do I add post titles or blog title in custom tweet texts? =

You can use the `%POSTTITLE%` and `%BLOGTITLE%` tags to do this. These tags valid in the WP Tweet Button general configuration and in your posts' Tweet Button settings.

Example:

* `New blog entry: %POSTTITLE% #cats` 

"#cats" in this example is a tag that's relevent to your blog.

= How do I create custom recommendations for each separate post/page? =

Simply edit your post and set your recommended user in the Tweet Button options box.

= How do manually create the Tweet Button in my template code? =

To create the Tweet Button manually, call the `tweetbutton();` function.

Examples:

* `echo tweetbutton();`
* `$myCustomPlaceForSocialMedia .= tweetbutton();`

If you're using the Tweet Button inside *the loop* , you can also include the `$post` variable for control options per post.

Examples:

* `echo tweetbutton($post);`
* `$myCustomPlaceForSocialMedia .= tweetbutton($post);`

= Plugin doesn't work for some reason. How I contact the author? =

You can either leave a comment on the [plugin's page](http://0xtc.com/2010/08/13/twitters-tweet-button-for-wordpress.xhtml "WP Tweet Button"), or contact the author on twitter (*[@TCorp](http://twitter.com/tcorp/ "TCorp on Twitter")*). 

== Screenshots ==

1. WP Tweet Button
2. WP Tweet Button post options
3. WP Tweet Button Settings Page
4. WP Tweet Button help section

== Changelog ==

= 1.7.6 =
* Minor plugin confict resolved.

= 1.7.5 =
* Fixed incompatibility bug for WP2.8 users.

= 1.7.4 =
* Fixed bit.ly save bug.

= 1.7.3 =
* Added support for Wordpress 3 shortener functions.

= 1.7.2 =
* Authors can configure their own Twitter accounts on their profile pages.

= 1.7.1 =
* Added referral formatting options.

= 1.7.0 =
* Added support for optional URL shrinking services:  b2l.me, bit.ly, cli.gs, sl.ly, snipr.com, su.pr, tinyarro.ws, tinyurl.com
* Added support for the [Twitter Friendly Links](http://wordpress.org/extend/plugins/twitter-friendly-links/ "Twitter Friendly Links") Plugin
* Added support for the [YOURLS: WordPress to Twitter](http://wordpress.org/extend/plugins/yourls-wordpress-to-twitter/ "YOURLS: WordPress to Twitter") Plugin
* using wp_register_script for widgets.js

= 1.6.1 =
* Custom tweet text bug fix

= 1.6.0 =
* Option for each blog post to have its own custom tweet text.
* Custom tweet texts can include tags like `%POSTTITLE%` and `%BLOGTITLE%`

= 1.5.0 =
* Option box in posts included for easy configuration of Tweet Button per post.
* Option box includes optional disabling of tweet button per post.
* Option box includes recommended user and description.

= 1.4.4 =
* RSS feed option

= 1.4.3 =
* No more default CSS
* Internationalization
* Fixed manual content missing bug.
* Added better control of tweet text.
* Cosmetic changes.

= 1.2.0 =

* Added support for recommendations.
* Added support for custom recommendations for each post (Read FAQ).

= 1.1.1 =

* Cosmetic changes to the settings screen.

= 1.1.0 =

* Tweet Button Language enabled

= 1.0.0 =

* First build