=== 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, 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
* [WPTouch](http://wordpress.org/extend/plugins/wptouch/ "WP Touch") Support
* counturl support for consistent url counts across URL shorteners

= Support =

This plugin features a help section but you may also find the [FAQ](http://wordpress.org/extend/plugins/wp-tweet-button/faq/ "WP Tweet Button FAQ") or WP [Tweet Button](http://0xtc.com/2010/08/13/twitters-tweet-button-for-wordpress.xhtml "Tweet Button")'s page useful.

== 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 ==

= 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 displayed on a post
2. WP Tweet Button will discreetly add tweet option controls to your posts and page.
3. WP Tweet Button controls in posts and page.
4. WP Tweet Button settings page.
5. WP Tweet Button help section.

== Changelog ==

= 1.8.2 =

* More discreet controls for post/page edit screens.
* Added support to disable button while browsing mobile using [WPTouch](http://wordpress.org/extend/plugins/wptouch/ "WP Touch")
* counturl support added for consistent url counts across URL shorteners

= 1.8.1 =

* Object oriented codebase
* Removed need for JSON library (Resolves issues with some hosts)
* Button on posts is a switchable option.
* Uses newer bit.ly API.
* Uses simplified su.pr API.
* Supports excerpt compatibility for poorly written templates.

= 1.7.x =
* Minor plugin confict resolved.
* Fixed incompatibility bug for WP2.8 users.
* Fixed bit.ly save bug.
* Added support for Wordpress 3 shortener functions.
* Authors can configure their own Twitter accounts on their profile pages.
* Added referral formatting options.
* 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.x =
* Custom tweet text bug fix
* 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.x =
* RSS feed option
* 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.x =

* Cosmetic changes to the settings screen.
* Tweet Button Language enabled

= 1.0.0 =

* First build